vantiv 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 5f9b473eb8a3d878119b85cb9ad330b5ad8af5d9
-  data.tar.gz: 5734e6739eaafbd3e31e684f739f27befd9c797e
+SHA256:
+  metadata.gz: 27ec337c20c24981d68ec39f5db4634e15b1cb62880f53fd167da6d5f86eae6e
+  data.tar.gz: 9f91b90c596a142aa211d85092405bf3a2fa3543f5ff95d8ecf538410ee816d8
 SHA512:
-  metadata.gz: 45fd5a14471fa72dc275f56435f08466581163df9b5e7f8e5c000d65aee01c8c601526a4839c2d990993827a21a861b2fa7f017c4957b83a4cf0486a628e10ad
-  data.tar.gz: 64351720d5b21e19efe184fb47c28d4e7ef23c1e1d2620eb2700882fe74fe642d8a30c0809a47970fb7bd7beb64b79f5a37fde4bcd85254733317a68320d05e5
+  metadata.gz: 00bacdab79c33ef5bd48e8870f101c38c0a129c90e55b4975b16b5b3a8837bb9403fbd9992e89c2f46d13f917a342a02d7112105fb295ede8f942c949b972ddb
+  data.tar.gz: cb915f95ae7c5003369d01db7b8a026c614dd887d215b2aed7783b4c6314ebd4f40ec79b22faecfee8868b9c7c1f6bb41c07ffd10acf6842065ba15e59d5cd21

data/.gitignore

@@ -9,3 +9,4 @@
 /pkg/
 /spec/reports/
 /tmp/
+/.idea

data/.ruby-version

@@ -1 +1 @@
-2.3.1
+2.5.0

data/.travis.yml

@@ -1,5 +1,7 @@
 language: ruby
 before_install: gem install bundler -v 1.10.6
 cache: bundler
+addons:
+  firefox: "latest"
 notifications:
   email: false

data/CHANGELOG.md

@@ -1,4 +1,11 @@
 Vantiv Ruby Changes
+
+master
+-----------
+- Update Vantiv XML version to 10.5
+- Rename certiciation environment to precertification
+- Add postcertification environment
+
 1.0.0
 -----------
 - Breaking changes: replace deprecated DevHub API with XML API
@@ -8,7 +15,6 @@ Vantiv Ruby Changes
 - Implement Apple Pay
 - Implement Security Code (CVV) mismatch filtering
 
-
 0.3.0
 -----------
 - Bug/fix: adds expiry arguments to the relevant methods when running the fixture generator
@@ -81,5 +87,3 @@ NOTE: API change occurs in this version bump on:
 - Add script to run all Devhub certification environment validation tests
   via script:
   - Allows merchants to install gem and certify quickly, rather than manually
-
-

data/README.md

@@ -41,7 +41,7 @@ Vantiv requires merchants to certify their applications for usage with their API
 To certify your application, run the following script:
 
 ```
-$ bundle exec vantiv-certify-app -a sub-your-merchant-id-in-here -p your-paypage-id -u your-user -w your-password
+$ bundle exec vantiv-certify-app
 ```
 
 A certs.txt file will be generated in the directory that the script is run, and then opened. It contains a list of XML Certification Order IDs and associated Transaction IDs, like follows:
@@ -57,7 +57,7 @@ AUTH_CAPTURE_2, transaction-id-for-AUTH_CAPTURE_2-here
 If you want to just run a subset of the certifications you can pass in the Test ID that you want to which match against using the `--filter_by` option. For example, if you only want to run the Account Updater certification, which have Test IDs that are prefixed with `ACCOUNT_UPDATER`, you would filter by `ACCOUNT_UPDATER` like follows:
 
 ```
-$ bundle exec vantiv-certify-app -a bar -p bla -u uzr -w pwd --filter_by=ACCOUNT_UPDATER
+$ bundle exec vantiv-certify-app --filter_by=ACCOUNT_UPDATER
 ```
 
 
@@ -106,7 +106,7 @@ To render the payframe, the merchant must include the payframe js file in the pa
 # OR:
 <%= javascript_include_tag Vantiv.payframe_js %>
 # OR it can be hardcoded:
-<script src="https://request-prelive.np-securepaypage-litle.com/LitlePayPage/js/payframe-client.min.js" type="text/javascript"></script>
+<script src="https://request.eprotect.vantivprelive.com/LitlePayPage/js/payframe-client.min.js" type="text/javascript"></script>
 ```
 
 To initialize the payframe:
@@ -329,7 +329,7 @@ To use the gem in any non-production environment, set the client's environment t
 
 ```ruby
 Vantiv.configure do |config|
-  config.environment = Vantiv::Environment::CERTIFICATION
+  config.environment = Vantiv::Environment::PRECERTIFICATION
 end
 ```
 

data/bin/generate_sandbox_fixtures

@@ -1,12 +1,13 @@
 #!/usr/bin/env ruby
 
 require "vantiv"
+require "vantiv/environment"
 require "vantiv/mocked_sandbox/fixture_generator"
 
 require "dotenv"
 Dotenv.load
 Vantiv.configure do |config|
-  config.environment = Vantiv::Environment::CERTIFICATION
+  config.environment = Vantiv::Environment::PRECERTIFICATION
   config.merchant_id = ENV["MERCHANT_ID"]
   config.default_order_source = "ecommerce"
   config.paypage_id = ENV["PAYPAGE_ID"]

data/exe/vantiv-certify-app

@@ -6,23 +6,7 @@ require 'optparse'
 
 options = {}
 parser = OptionParser.new do |opts|
-  opts.banner = "Usage: vantiv-certify-app -a <merchant_id> -p <paypage_id> -u <user> -w <password> [--filter_by <test_name>]"
-
-  opts.on("-a", "--merchant_id MERCHANT_ID", "Vantiv Merchant ID") do |merchant_id|
-    options[:merchant_id] = merchant_id
-  end
-
-  opts.on("-p", "--paypage_id PAYPAGE_ID", "Vantiv Paypage ID") do |paypage_id|
-    options[:paypage_id] = paypage_id
-  end
-
-  opts.on("-u", "--user VANTIV_USER", "Vantiv XML User") do |user|
-    options[:user] = user
-  end
-
-  opts.on("-w", "--password VANTIV_PASSWORD", "Vantiv XML Password") do |password|
-    options[:password] = password
-  end
+  opts.banner = "Usage: vantiv-certify-app [--filter_by <test_name>]"
 
   opts.on("--filter_by [TEST_NAME]", "Filter which certifications to run") do |filter|
     options[:filter_by] = filter
@@ -31,26 +15,21 @@ end
 
 parser.parse!
 
-required_arguments = %i[merchant_id paypage_id user password]
-missing_arguments = required_arguments.select{ |required_argument| options[required_argument].nil? }
-
-if missing_arguments.any?
-  puts "Missing options: #{missing_arguments.join(", ")}"
-  puts parser.banner
-  exit
-end
-
+require "dotenv"
+Dotenv.load
 Vantiv.configure do |config|
-  config.merchant_id = options.fetch(:merchant_id)
-  config.paypage_id = options.fetch(:paypage_id)
   config.environment = Vantiv::Environment::CERTIFICATION
+  config.merchant_id = ENV["MERCHANT_ID"]
+  config.default_order_source = "ecommerce"
+  config.paypage_id = ENV["PAYPAGE_ID"]
 
-  config.user = options.fetch(:user)
-  config.password = options.fetch(:password)
+  config.user = ENV["VANTIV_USER"]
+  config.password = ENV["VANTIV_PASSWORD"]
 
   config.default_report_group = '1'
 end
 
+
 Vantiv::Certification::ValidationTestRunner.run(
   save_to: "certs.txt",
   filter_by: options[:filter_by]

data/lib/vantiv.rb

@@ -7,6 +7,7 @@ require 'vantiv/test_card'
 require 'vantiv/test_temporary_token'
 require 'vantiv/environment'
 require 'vantiv/mocked_sandbox'
+require 'vantiv/response_code_map'
 require 'vantiv/paypage'
 
 module Vantiv
@@ -42,7 +43,8 @@ module Vantiv
 
   def self.auth(amount:, payment_account_id:, customer_id:, order_id:, expiry_month:, expiry_year:,
     order_source: Vantiv.default_order_source, use_temporarily_stored_security_code: false,
-    online_payment_cryptogram: nil)
+    online_payment_cryptogram: nil, original_network_transaction_id: nil, processing_type: nil,
+    original_transaction_amount: nil)
 
     # RE use_temporarily_stored_security_code
     # From XML Docs:
@@ -62,7 +64,10 @@ module Vantiv
       expiry_year: expiry_year,
       cvv: cvv,
       order_source: order_source,
-      online_payment_cryptogram: online_payment_cryptogram
+      online_payment_cryptogram: online_payment_cryptogram,
+      original_network_transaction_id: original_network_transaction_id,
+      original_transaction_amount: original_transaction_amount,
+      processing_type: processing_type
     )
     Api::Request.new(
       endpoint: Api::Endpoints::AUTHORIZATION,
@@ -99,7 +104,8 @@ module Vantiv
 
   def self.auth_capture(amount:, payment_account_id:, customer_id:, order_id:,
       expiry_month:, expiry_year:, order_source: Vantiv.default_order_source,
-      online_payment_cryptogram: nil)
+      online_payment_cryptogram: nil, original_network_transaction_id: nil, processing_type: nil,
+      original_transaction_amount: nil)
     body = Api::RequestBody.for_auth_or_sale(
       amount: amount,
       order_id: order_id,
@@ -108,7 +114,10 @@ module Vantiv
       expiry_month: expiry_month,
       expiry_year: expiry_year,
       order_source: order_source,
-      online_payment_cryptogram: online_payment_cryptogram
+      online_payment_cryptogram: online_payment_cryptogram,
+      original_network_transaction_id: original_network_transaction_id,
+      original_transaction_amount: original_transaction_amount,
+      processing_type: processing_type
     )
     Api::Request.new(
       endpoint: Api::Endpoints::SALE,
@@ -158,6 +167,10 @@ module Vantiv
     ).run
   end
 
+  def self.get_error_description(code:)
+    ResponseCodeMap.get_error_description(code: code)
+  end
+
   def self.configure
     yield self
   end

data/lib/vantiv/api/address.rb

@@ -1,8 +1,15 @@
 module Vantiv
   module Api
     class Address
-      attr_accessor :billing_name, :billing_address_1, :billing_address_2,
-                    :billing_city, :billing_state, :billing_zipcode, :billing_country
+      attr_accessor *%i(
+        billing_address_1
+        billing_address_2
+        billing_city
+        billing_country
+        billing_name
+        billing_state
+        billing_zipcode
+      )
     end
   end
 end

data/lib/vantiv/api/live_transaction_response.rb

@@ -47,6 +47,10 @@ module Vantiv
           litle_transaction_response.account_updater || AccountUpdaterResponse.new
       end
 
+      def network_transaction_id
+        litle_transaction_response.network_transaction_id
+      end
+
       private
       def transaction_approved?
         response_code == RESPONSE_CODES[:approved]

data/lib/vantiv/api/request.rb

@@ -26,7 +26,7 @@ module Vantiv
     end
 
     def run_request
-      http_response = make_request
+      http_response = send_request(build_request)
       populated_response(@response_object, http_response)
     end
 
@@ -47,16 +47,20 @@ module Vantiv
       populated_body.transaction.application_id = populated_body.application_id
 
       populated_body.xmlns = "http://www.litle.com/schema"
-      populated_body.version = "10.2"
+      populated_body.version = "10.5"
 
       populated_body
     end
 
-    def make_request
-      http = Net::HTTP.new(uri.host, uri.port)
-      http.use_ssl = true
+    def build_request
       request = Net::HTTP::Post.new(uri.request_uri, header)
       request.body = body.to_xml
+      request
+    end
+
+    def send_request(request)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
       http.request(request)
     end
 
@@ -72,9 +76,11 @@ module Vantiv
 
     def root_uri
       if Vantiv::Environment.production?
-        "https://transact.litle.com"
-      elsif Vantiv::Environment.certification?
-        "https://transact-prelive.litle.com"
+        "https://transact.vantivcnp.com"
+      elsif Vantiv::Environment.postcertification?
+        "https://transact.vantivpostlive.com"
+      elsif Vantiv::Environment.precertification?
+        "https://transact.vantivprelive.com"
       end
     end
 

data/lib/vantiv/api/request_body.rb

@@ -40,8 +40,8 @@ module Vantiv
 
       def self.for_auth_or_sale(amount:, customer_id:, order_id:, payment_account_id:,
           expiry_month:, expiry_year:, cvv: nil, order_source: Vantiv.default_order_source,
-          online_payment_cryptogram: nil)
-
+          online_payment_cryptogram: nil, original_network_transaction_id: nil,
+          processing_type: nil, original_transaction_amount: nil)
 
         if online_payment_cryptogram
           cardholder_authentication = CardholderAuthentication.new(
@@ -57,7 +57,10 @@ module Vantiv
           customer_id: customer_id,
           order_source: order_source,
           partial_approved_flag: false,
-          cardholder_authentication: cardholder_authentication
+          cardholder_authentication: cardholder_authentication,
+          original_network_transaction_id: original_network_transaction_id,
+          processing_type: processing_type,
+          original_transaction_amount: original_transaction_amount
         )
         card = Card.new(
           expiry_month: expiry_month,

data/lib/vantiv/api/response.rb

@@ -20,15 +20,15 @@ module Vantiv
       private
 
       def litle_response_has_error?
-        body.response == "3" ||
-        # NOTE: this kind of sucks, but at the commit point, the DevHub
-        #   Api sometimes gives 200OK when litle had a parse issue and returns
-        #   'Error validating xml data...' instead of an actual error
-        !!body.body_message.match(/error/i)
+        body.response != "0" || !!body.body_message.match(/error/i)
       end
 
       def api_level_error_message
-        "API level error"
+        xml_validation_error? ? body.body_message : "API level error"
+      end
+
+      def xml_validation_error?
+        body.response == "1"
       end
 
       attr_reader :transaction_response_name

data/lib/vantiv/api/response_body.rb

@@ -3,10 +3,19 @@ module Vantiv
     class ResponseBody
       attr_writer :message, :response_code
 
-      attr_accessor :body_message, :response, :version, :request_id
-
-      attr_accessor :authorization_response, :sale_response, :credit_response, :void_response,
-                    :auth_reversal_response, :capture_response, :register_token_response
+      attr_accessor *%i(
+        body_message
+        request_id
+        response
+        version
+        auth_reversal_response
+        authorization_response
+        capture_response
+        credit_response
+        register_token_response
+        sale_response
+        void_response
+      )
     end
   end
 end

data/lib/vantiv/api/transaction.rb

@@ -1,12 +1,27 @@
 module Vantiv
   module Api
     class Transaction
-      attr_accessor :id, :order_id, :customer_id, :order_source, :partial_approved_flag,
-                    :amount_in_cents, :report_group, :card, :type, :application_id, :address,
-                    :cardholder_authentication
+      attr_accessor *%i(
+        address
+        amount_in_cents
+        application_id
+        card
+        cardholder_authentication
+        customer_id
+        id
+        order_id
+        order_source
+        original_network_transaction_id
+        original_transaction_amount
+        partial_approved_flag
+        processing_type
+        report_group
+        type
+      )
 
       def initialize(id: nil, amount_in_cents: nil, order_id: nil, customer_id: nil,
-        partial_approved_flag: nil, order_source: nil,  cardholder_authentication: nil)
+        partial_approved_flag: nil, order_source: nil,  cardholder_authentication: nil,
+        original_network_transaction_id: nil, processing_type: nil, original_transaction_amount: nil)
         @id = id
         @amount_in_cents = amount_in_cents
         @order_id = order_id
@@ -14,6 +29,9 @@ module Vantiv
         @partial_approved_flag = partial_approved_flag
         @order_source = order_source
         @cardholder_authentication = cardholder_authentication
+        @original_network_transaction_id = original_network_transaction_id
+        @processing_type = processing_type
+        @original_transaction_amount = original_transaction_amount
       end
 
       def amount

data/lib/vantiv/api/transaction_request_representer_xml.rb

@@ -54,4 +54,8 @@ class TransactionRequestRepresenterXml < Representable::Decorator
   end
 
   property :partial_approved_flag, as: :allowPartialAuth
+
+  property :processing_type, as: :processingType
+  property :original_network_transaction_id, as: :originalNetworkTransactionId
+  property :original_transaction_amount, as: :originalTransactionAmount
 end

data/lib/vantiv/api/transaction_response.rb

@@ -1,9 +1,28 @@
 module Vantiv
   module Api
     class TransactionResponse
-      attr_accessor :message, :response_code, :transaction_id, :response_time, :id, :report_group, :payment_account_id,
-                    :post_date, :type, :bin, :auth_code, :customer_id, :order_id, :token_response_code, :token_message,
-                    :fraud_result, :account_updater, :token_response, :apple_pay_response
+      attr_accessor *%i(
+        account_updater
+        apple_pay_response
+        auth_code
+        bin
+        customer_id
+        fraud_result
+        id
+        message
+        network_transaction_id
+        order_id
+        payment_account_id
+        post_date
+        report_group
+        response_code
+        response_time
+        token_message
+        token_response
+        token_response_code
+        transaction_id
+        type
+      )
     end
   end
 end