CnpOnline 8.31.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 77616340b8281f768185936a7fadfffee31dc657b009e3a6f5d9bf433c6ca271
+  data.tar.gz: 2d615e52b3b2350a215bbf5e594f5ccfc9d8daf26c8611ccf4c83954e4263b10
+SHA512:
+  metadata.gz: c3137b60e13600eba22d9aa59a32571f56a44e9ded5783f4d3cb4985b9fc3e7a9dc31bb91a7aeffc11a8cb023e17b327cbeb221d437bb00344358eb27faafd18
+  data.tar.gz: db1418fa473a74ffbc35a334aa41f7232c11a17292e5aaa8a4c9af69b8edd2fd9e26e33d3bbd9225d7612216301d07aea30bb7c291c9bec491f5af30d2cb4a41

data/CHANGELOG

@@ -0,0 +1,139 @@
+= LitleOnline CHANGELOG
+
+== version 8.31.0(March 29, 2018)
+* Feature : Processingtype elements added to sale, authorization, and forcecapture
+
+==version 8.29.2
+HTTP timeout set to 500ms
+
+== version 8.29.1(March 11, 2015)
+* BugFix: fixed a XML field bug in Account Update Token
+
+== version 8.29.0(January 28, 2015)
+* Feature : Added support for Applepay and Secondary Amount
+* BugFix: fix an incorrect mapping in fraud check option fields for Sale transaction
+
+== version 8.27.0(August 27, 2014)
+* Feature : Added samples for all kinds of transactions
+
+== version 8.25.1(July 18,2014)
+* Feature : Added Env variables to setup ruby config
+
+
+== version 8.25.0 (March 17, 2014)
+* Feature: Added support for ROAM: Authorization, ForceCapture, CaptureGivenAuth, Sale, Credit
+
+== version 8.24.0 (March 17, 2014)
+* Feature: add triggered rules for advancedFraudCheckResult
+
+== Version 8.23.0 (March 14, 2014)
+* Feature: advancedFraudChecks now available in authorization and sale 
+* Feature: catLevel (Cardholder Activated Terminal) now available in pos
+* Feature: advancedFraudResults now available in fraudResult
+
+== Version 8.22.0 (March 14, 2014)
+* Feature: Support for the following new gift card transactions:
+ActivateReversal, DeactivateReversal, LoadReversal, RefundReversal,
+UnloadReversal, DepositReversal
+* Feature: UpdateSubscription now can take token or paypage updates, and
+can return token in the response
+* Feature: Support for virtualGiftCard in giftCard activations and can be returned in EnhancedAuthResponses
+* Feature: Gift Card responses can be returned from AuthReversal
+
+== Version 8.21.0 (March 13, 2014)
+* Feature: Support for the following new recurring transactions:
+CreatePlan, UpdatePlan
+* Feature: Support for the following new gift card transactions:
+Activate, Deactivate, Load, Unload, Balance Inquiry
+* Feature: Gift card responses are now returned as part of
+authorzationResponse, authReversalResponse, captureResponse,
+forceCapture, captureGivenAuthResponse, saleResponse, creditResponse
+* Feature: fraudResult is now returned as part of captureResponse,
+forceCaptureResponse, captureGivenAuthResponse, creditResponse
+
+== Version 8.20.0 (December 17, 2013)
+* Feature: More initial support for Recurring, including the ability to update or cancel subscriptions
+
+== Version 8.19.0 (March 07, 2014)
+* Feature: Added deptRepayment as a choice for authorizations, forceCapture, captureGivenAuth, sale
+* Feature: More initial support for Recurring, including a backwards incompatible changing a field from numberOfPaymentsRemaining to numberOfPayments
+
+== Version 8.18.0 (July 31, 2013)
+* Feature: Add initial support for Recurring
+* Feature: Add support for Gift Card as a card type (GC)
+
+== Version 8.17.0 (June 13, 2013)
+* Feature: Batch support - see https://gist.github.com/litleSDK/5687345, https://gist.github.com/litleSDK/5714803 and https://gist.github.com/litleSDK/5714847
+* Feature: Add support for surcharging credit card transactions
+* Feature: Add support for specifying the terminalId on a pos transaction
+* Feature: Add support for pos transactions on tied refunds
+* Cleanup: Drop support for 1.8.6
+
+== Version 8.16.0 (March 29, 2013)
+
+* Feature: Merged pull request #7 from pierre to add external logging support
+* Feature: Add recyling to voidResponse
+* Bugfix: Force the "version" attribute of a LitleOnlineRequest to be the major and minor version of the sdk submitting the transaction instead of using the value from the configuration file
+* Bugfix: Add Connection: close header to reduce the chance of 403s from reaching the ip connection limit
+* Bugfix: Merged pull request #5 from simeonwillbanks to fix a typo in sale when payPalOrderComplete is specified
+
+== Version 8.15.0 (January 31, 2013)
+
+* Feature: Add merchantData to echeck verifications and echeck redeposits
+
+== Version 8.14.0 (January 31, 2013)
+
+* Feature: Temporary storage of card validation num on tokens
+* Feature: Updating card validation numbers on tokens
+
+== Version 8.13.2 (June 28, 2012)
+
+* Feature: Most schema validations are now handled by ruby code and throw errors.
+* Bugfix: Remove hardcoded username/password fields
+
+== Version 8.13.1 (May 22, 2012)
+
+* Feature: Echeck Void now supported
+
+== Version 8.13.0 (May 18, 2012)
+
+* Feature: Authorizations and Sales can accept an optional fraudFilterOverride parameter
+
+== Version 8.12.4 (May 17, 2012)
+
+* Bugfix: Use modules so that we are not polluting the global namespace
+
+== Version 8.12.3 (May 17, 2012)
+
+* Bugfix: Allow use without the configuration file
+
+== Version 8.12.2 (May 16, 2012)
+
+* Bugfix: Fix bug where rails "capture" method was interfering with Litle's "capture"
+
+== Version 8.12.1 (May 15, 2012)
+
+* Feature: Support Ruby 1.8.7
+* Bugfix: Add support for line item data and tax detail to enhanced auth
+
+== Version 8.12.0 (April 16, 2012)
+
+* Feature: Add support for actionReason on credit
+* Feature: Track SDK Usage
+* Bugfix: Add support for MerchantData on auth and sale
+
+== Version 8.10.3 (April 16, 2012)
+
+* Feature: Support Ruby 1.8.6
+* Bugfix: Setup sandbox url was incorrect
+* Cleanup: Support newest sandbox conventions
+
+== Version 8.10.1 (March 2, 2012)
+
+* Feature: Allow use without the configuration file
+* Bugfix: Reauth works
+* Cleanup: Use ruby conventions
+
+== Version 8.10.0 (February 17, 2012)
+
+* Initial release

data/CONTRIBUTORS

@@ -0,0 +1,2 @@
+Simeon Willbanks - https://github.com/LitleCo/litle-sdk-for-ruby/pull/5
+Pierre-Alexandre Meyer - https://github.com/LitleCo/litle-sdk-for-ruby/pull/7

data/DESCRIPTION

@@ -0,0 +1,5 @@
+Litle Online Ruby SDK created for version 8.18 of Litle XML format, see the XSD schema for specific fields that are supported by this format.
+
+This gem contains an application interface in the Ruby programming language created by Litle & Co.
+
+

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2011 Litle & Co.
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,72 @@
+Vantiv eCommerce Ruby SDK
+=====================
+#### Warning:
+#### All version changes require recertification to the new version. Once certified for the use of a new version, Vantiv modifies your Merchant Profile, allowing you to submit transaction to the Production Environment using the new version. Updating your code without recertification and modification of your Merchant Profile will result in transaction declines. Please consult you Implementation Analyst for additional information about this process.
+About Vantiv eCommerce
+------------
+[Vantiv eCommerce](http://www.vantiv.com) powers the payment processing engines for leading companies that sell directly to consumers through  internet retail, direct response marketing (TV, radio and telephone), and online services. Vantiv eCommerce is the leading authority in card-not-present (CNP) commerce, transaction processing and merchant services.
+
+
+About this SDK
+--------------
+The Vantiv eCommerce Ruby SDK is a Ruby implementation of the [Vantiv eCommerce](http://www.vantiv.com). XML API. This SDK was created to make it as easy as possible to connect process your payments with Vantiv eCommerce. This SDK utilizes  the HTTPS protocol to securely connect to Vantiv eCommerce. Using the SDK requires coordination with the Vantiv eCommerce team in order to be provided with credentials for accessing our systems.
+
+Each Ruby SDK release supports all of the functionality present in the associated Vantiv eCommerce XML version (e.g., SDK v9.3.2 supports Vantiv eCommerce XML v9.3). Please see the online copy of our XSD for Vantiv eCommerce XML to get more details on what the Vantiv eCommerce payments engine supports.
+
+This SDK was implemented to support the Ruby programming language and was created by Vantiv eCommerce. Its intended use is for online transaction processing utilizing your account on the Vantiv eCommerce payments engine.
+
+See LICENSE file for details on using this software.
+
+Source Code available from : https://github.com/LitleCo/litle-sdk-for-ruby
+
+Please contact [Vantiv eCommerce](http://www.vantiv.com) to receive valid merchant credentials in order to run tests successfully or if you require assistance in any way.  We are reachable at sdksupport@Vantiv.com
+
+Setup
+-----
+
+1) Install the LitleOnline Ruby gem from rubygems.org, this will install the latest SDK gem in your Ruby environment.
+Our gem is available publicly from rubygems.org.  Use the command below to install.
+
+>sudo gem install LitleOnline
+
+Note: If you get errors, you might have to configure your proxy.
+
+2) Once the gem is installed run our setup program to generate a configuration file.  The configuration file resides in your home directory
+$HOME/.litle_SDK_config.yml
+
+For more details on setup see our instructions [here](https://github.com/LitleCo/litle-sdk-for-ruby/blob/master/SETUP.md)
+
+3.) Create a ruby file similar to:  
+
+```ruby
+require 'LitleOnline'
+include LitleOnline
+
+# Visa $10 Sale
+litleSaleTxn = {
+    'reportGroup'=>'rpt_grp',
+    'orderId'=>'1234567',
+    'card'=>{
+        'type'=>'VI',
+        'number' =>'4100000000000001',
+        'expDate' =>'1212'},
+        'orderSource'=>'ecommerce',
+        'amount'=>'1000'
+    }
+
+# Peform the transaction on the Litle Platform
+response = LitleOnlineRequest.new.sale(litleSaleTxn)
+
+# display result
+puts "Message: "+ response.message
+puts "Litle Transaction ID: "+ response.saleResponse.litleTxnId
+```
+
+3) Next run this file using ruby. You should see the following result provided you have connectivity to the Litle certification environment.  You will see an HTTP error if you don't have access to the Litle URL
+
+    Message: Valid Format
+    Litle Transaction ID: <your-numeric-litle-txn-id>
+ 
+More examples (including batch processing with sFTP) can be found here [Ruby Gists](https://gist.github.com/litleSDK)
+
+Please contact Vantiv eCommerce with any further questions. You can reach us at sdksupport@vantiv.com.

data/Rakefile

@@ -0,0 +1,89 @@
+# Copyright (c) 2011 Litle & Co.
+#
+# Permission is hereby granted, free of charge, to any person
+# obtaining a copy of this software and associated documentation
+# files (the "Software"), to deal in the Software without
+# restriction, including without limitation the rights to use,
+# copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following
+# conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+# OTHER DEALINGS IN THE SOFTWARE.
+require 'rubygems'
+require 'rubygems/package_task'
+require 'rake/testtask'
+require 'rake/clean'
+
+spec = Gem::Specification.new do |s|
+  FileUtils.rm_rf('pkg')
+  s.name = 'CnpOnline'
+  s.summary = 'Ruby SDK produced by Vantiv eCommerce for transaction processing using Vantiv eCommerce XML format v8.31'
+  s.description = File.read(File.join(File.dirname(__FILE__), 'DESCRIPTION'))
+  s.requirements =
+    ['Contact sdksupport@vantiv.com for more information']
+  s.version = '8.31.0'
+  s.author = 'Vantiv eCommerce'
+  s.email = 'sdksupport@vantiv.com'
+  s.homepage = 'http://www.vantiv.com/developers'
+  s.platform = Gem::Platform::RUBY
+  s.required_ruby_version = '>=1.8.7'
+  s.files = Dir['**/**']
+  s.executables = ['sample_driver.rb', 'Setup.rb']
+  s.test_files = Dir['test/unit/ts_unit.rb']
+  s.has_rdoc = true
+  s.add_dependency('xml-object')
+  s.add_dependency('xml-mapping')
+  s.add_dependency('net-sftp')
+  s.add_dependency('libxml-ruby')
+  s.add_dependency('crack')
+  s.add_development_dependency('mocha')
+end
+
+Gem::PackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+  pkg.need_zip = true
+  pkg.need_tar = true
+end
+
+namespace :test do
+  Rake::TestTask.new do |t|
+    t.libs << '.'
+    t.name = 'unit'
+    t.test_files = FileList['test/unit/ts_unit.rb']
+    t.verbose = true
+  end
+
+  Rake::TestTask.new do |t|
+    t.libs << '.'
+    t.name = 'functional'
+    t.test_files = FileList['test/functional/ts_all.rb']
+    t.verbose = true
+  end
+
+  Rake::TestTask.new do |t|
+    t.libs << '.'
+    t.name = 'certification'
+    t.test_files = FileList['test/certification/certTest*.rb']
+    t.verbose = true
+  end
+
+  Rake::TestTask.new do |t|
+    t.libs << '.'
+    t.name = 'all'
+    t.test_files = FileList['test/**/*.rb']
+    t.verbose = true
+  end
+end
+
+task default: 'gem'

data/Rakefile~

@@ -0,0 +1,89 @@
+# Copyright (c) 2011 Litle & Co.
+#
+# Permission is hereby granted, free of charge, to any person
+# obtaining a copy of this software and associated documentation
+# files (the "Software"), to deal in the Software without
+# restriction, including without limitation the rights to use,
+# copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following
+# conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+# OTHER DEALINGS IN THE SOFTWARE.
+require 'rubygems'
+require 'rubygems/package_task'
+require 'rake/testtask'
+require 'rake/clean'
+
+spec = Gem::Specification.new do |s|
+  FileUtils.rm_rf('pkg')
+  s.name = 'VantivCnp'
+  s.summary = 'Ruby SDK produced by Vantiv eCommerce for transaction processing using Vantiv eCommerce XML format v8.31'
+  s.description = File.read(File.join(File.dirname(__FILE__), 'DESCRIPTION'))
+  s.requirements =
+    ['Contact sdksupport@vantiv.com for more information']
+  s.version = '8.31.0'
+  s.author = 'Vantiv eCommerce'
+  s.email = 'sdksupport@vantiv.com'
+  s.homepage = 'http://www.vantiv.com/developers'
+  s.platform = Gem::Platform::RUBY
+  s.required_ruby_version = '>=1.8.7'
+  s.files = Dir['**/**']
+  s.executables = ['sample_driver.rb', 'Setup.rb']
+  s.test_files = Dir['test/unit/ts_unit.rb']
+  s.has_rdoc = true
+  s.add_dependency('xml-object')
+  s.add_dependency('xml-mapping')
+  s.add_dependency('net-sftp')
+  s.add_dependency('libxml-ruby')
+  s.add_dependency('crack')
+  s.add_development_dependency('mocha')
+end
+
+Gem::PackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+  pkg.need_zip = true
+  pkg.need_tar = true
+end
+
+namespace :test do
+  Rake::TestTask.new do |t|
+    t.libs << '.'
+    t.name = 'unit'
+    t.test_files = FileList['test/unit/ts_unit.rb']
+    t.verbose = true
+  end
+
+  Rake::TestTask.new do |t|
+    t.libs << '.'
+    t.name = 'functional'
+    t.test_files = FileList['test/functional/ts_all.rb']
+    t.verbose = true
+  end
+
+  Rake::TestTask.new do |t|
+    t.libs << '.'
+    t.name = 'certification'
+    t.test_files = FileList['test/certification/certTest*.rb']
+    t.verbose = true
+  end
+
+  Rake::TestTask.new do |t|
+    t.libs << '.'
+    t.name = 'all'
+    t.test_files = FileList['test/**/*.rb']
+    t.verbose = true
+  end
+end
+
+task default: 'gem'

data/SETUP.md

@@ -0,0 +1,46 @@
+Setting up and Configuring the Litle SDK
+=========================================
+
+Running the built in configuration file generator
+-------------------------------------------------
+The Ruby SDK ships with a built in program which can be used to generate your specific configuration.
+
+This program runs as follows:
+   
+```
+>Setup.rb 
+Welcome to Litle Ruby_SDK
+please input your user name:
+test_user
+please input your password:
+test_password
+Please choose Litle url from the following list (example: 'cert') or directly input another URL:
+cert => https://cert.litle.com/vap/communicator/online
+precert => https://precert.litle.com/vap/communicator/online
+production1 => https://payments.litle.com/vap/communicator/online
+production2 => https://payments2.litle.com/vap/communicator/online
+cert
+Please input the proxy address, if no proxy hit enter key: 
+
+Please input the proxy port, if no proxy hit enter key: 
+
+The Litle configuration file has been generated, the file is located at: /<your-home-directory>/.litle_SDK_config.yml 
+```
+
+Modifying your configuration
+----------------------------
+You may change the configuration values at anytime by running Setup.rb again, or simpy opening the configuration file directly in the editor of your choice and changing the appropriate fields. 
+
+Changing the location of the Litle configuration file:
+------------------------------------------------------
+NOTICE you can set the environment variable $LITLE_CONFIG_DIR to locate your configuration file in a location other than the $HOME Directory, the the file will reside in $LITLE_CONFIG_DIR/.litle_SDK_config.yml  
+
+Sample configuration file contents
+----------------------------------
+```
+user: test_user
+password: test_password
+url: https://www.testlitle.com/vap/communicator/online
+proxy_addr: yourproxyserver
+proxy_port: 8080
+```