vantiv 0.1.0

data/cert_fixtures/L_T_9.json

@@ -0,0 +1,20 @@
+{
+  "endpoint": "AUTHORIZATION",
+  "body": {
+    "Transaction": {
+      "ReferenceNumber": "1",
+      "TransactionAmount": "150.00",
+      "OrderSource": "ecommerce",
+      "CustomerID": "345",
+      "PartialApprovedFlag": "false"
+    },
+    "Card": {
+      "ExpirationMonth": "11",
+      "ExpirationYear": "16",
+      "CVV": "987"
+    },
+    "PaymentAccount": {
+      "PaymentAccountID": "#{L_T_8.litleOnlineResponse.authorizationResponse.tokenResponse.PaymentAccountID}"
+    }
+  }
+}

data/cert_fixtures/L_V_1.json

@@ -0,0 +1,27 @@
+{
+  "endpoint": "AUTHORIZATION",
+  "body": {
+    "Transaction": {
+      "ReferenceNumber": "1",
+      "TransactionAmount": "101.00",
+      "OrderSource": "ecommerce",
+      "CustomerID": "345",
+      "PartialApprovedFlag": "false"
+    },
+    "Card": {
+      "Type": "VI",
+      "CardNumber": "4457010000000009",
+      "ExpirationMonth": "01",
+      "ExpirationYear": "16",
+      "CVV": "349"
+    },
+    "Address": {
+      "BillingName": "John & Mary Smith",
+      "BillingAddress1": "1 Main St.",
+      "BillingCity": "Burlington",
+      "BillingState": "MA",
+      "BillingZipcode": "01803-3747",
+      "BillingCountry": "US"
+    }
+  }
+}

data/cert_fixtures/L_V_1A.json

@@ -0,0 +1,8 @@
+{
+  "endpoint": "CAPTURE",
+  "body": {
+    "Transaction": {
+      "TransactionID": "#{L_V_1.litleOnlineResponse.authorizationResponse.TransactionID}"
+    }
+  }
+}

data/cert_fixtures/L_V_1B.json

@@ -0,0 +1,8 @@
+{
+  "endpoint": "CREDIT",
+  "body": {
+    "Transaction": {
+      "TransactionID": "#{L_V_1A.litleOnlineResponse.captureResponse.TransactionID}"
+    }
+  }
+}

data/cert_fixtures/L_V_1C.json

@@ -0,0 +1,8 @@
+{
+  "endpoint": "VOID",
+  "body": {
+    "Transaction": {
+      "TransactionID": "#{L_V_1B.litleOnlineResponse.creditResponse.TransactionID}"
+    }
+  }
+}

data/cert_fixtures/L_V_2.json

@@ -0,0 +1,27 @@
+{
+  "endpoint": "SALE",
+  "body": {
+    "Transaction": {
+      "ReferenceNumber": "1",
+      "TransactionAmount": "101.00",
+      "OrderSource": "ecommerce",
+      "CustomerID": "345"
+    },
+    "Card": {
+      "Type": "MC",
+      "CardNumber": "5112010000000003",
+      "ExpirationMonth": "02",
+      "ExpirationYear": "16",
+      "CVV": "261"
+    },
+    "Address": {
+      "BillingName": "Mike J. Hammer",
+      "BillingAddress1": "2 Main St.",
+      "BillingAddress2": "Apt. 222",
+      "BillingCity": "Riverside",
+      "BillingState": "RI",
+      "BillingZipcode": "02915",
+      "BillingCountry": "US"
+    }
+  }
+}

data/cert_fixtures/L_V_2A.json

@@ -0,0 +1,8 @@
+{
+  "endpoint": "VOID",
+  "body": {
+    "Transaction": {
+      "TransactionID": "#{L_V_2.litleOnlineResponse.saleResponse.TransactionID}"
+    }
+  }
+}

data/cert_fixtures/L_V_3.json

@@ -0,0 +1,18 @@
+{
+  "endpoint": "RETURN",
+  "body": {
+    "Transaction": {
+      "ReferenceNumber": "1",
+      "TransactionAmount": "101.00",
+      "OrderSource": "ecommerce",
+      "CustomerID": "345"
+    },
+    "Card": {
+      "Type": "VI",
+      "CardNumber": "4457010000000009",
+      "ExpirationMonth": "01",
+      "ExpirationYear": "16",
+      "CVV": "349"
+    }
+  }
+}

data/cert_fixtures/L_V_3A.json

@@ -0,0 +1,8 @@
+{
+  "endpoint": "VOID",
+  "body": {
+    "Transaction": {
+      "TransactionID": "#{L_V_3.litleOnlineResponse.creditResponse.TransactionID}"
+    }
+  }
+}

data/cert_fixtures/L_V_4.json

@@ -0,0 +1,26 @@
+{
+  "endpoint": "SALE",
+  "body": {
+    "Transaction": {
+      "ReferenceNumber": "1",
+      "TransactionAmount": "101.00",
+      "OrderSource": "ecommerce",
+      "CustomerID": "345"
+    },
+    "Card": {
+      "Type": "VI",
+      "CardNumber": "4457010100000008",
+      "ExpirationMonth": "06",
+      "ExpirationYear": "16",
+      "CVV": "992"
+    },
+    "Address": {
+      "BillingName": "Joe Green",
+      "BillingAddress1": "6 Main St.",
+      "BillingCity": "Derry",
+      "BillingState": "NH",
+      "BillingZipcode": "03038",
+      "BillingCountry": "US"
+    }
+  }
+}

data/cert_fixtures/L_V_4A.json

@@ -0,0 +1,8 @@
+{
+  "endpoint": "VOID",
+  "body": {
+    "Transaction": {
+      "TransactionID": "#{L_V_4.litleOnlineResponse.saleResponse.TransactionID}"
+    }
+  }
+}

data/exe/vantiv-certify-app

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+
+require 'vantiv'
+require 'vantiv/certification/validation_test_runner'
+
+unless ENV['ACCEPTOR_ID'] && ENV['LICENSE_ID'] && ENV['PAYPAGE_ID']
+  raise "Vantiv License ID, Acceptor ID, Paypage ID and Application ID required"
+end
+
+Vantiv.configure do |config|
+  config.license_id = ENV["LICENSE_ID"]
+  config.acceptor_id = ENV["ACCEPTOR_ID"]
+  config.paypage_id = ENV["PAYPAGE_ID"]
+
+  config.default_report_group = '1'
+end
+
+Vantiv::Certification::ValidationTestRunner.run(
+  filter_by: ENV["FILTER_BY"],
+  save_to: "certs.txt"
+)
+
+%x(open certs.txt)

data/lib/vantiv.rb

@@ -0,0 +1,152 @@
+require 'json'
+require 'net/http'
+require 'vantiv/api'
+require 'vantiv/test_card'
+require 'vantiv/environment'
+require 'vantiv/mocked_sandbox'
+require 'vantiv/paypage'
+
+module Vantiv
+  def self.tokenize(temporary_token:)
+    if temporary_token == "" or temporary_token == nil
+      raise ArgumentError.new("Blank temporary token (PaypageRegistrationID): \n
+                               Check that paypage error handling is implemented correctly.")
+    end
+
+    body = Api::RequestBody.for_tokenization(
+      paypage_registration_id: temporary_token
+    )
+    Api::Request.new(
+      endpoint: Api::Endpoints::TOKENIZATION,
+      body: body,
+      response_object: Api::TokenizationResponse.new
+    ).run
+  end
+
+  def self.tokenize_by_direct_post(card_number:, expiry_month:, expiry_year:, cvv:)
+    body = Api::RequestBody.for_direct_post_tokenization(
+      card_number: card_number,
+      expiry_month: expiry_month,
+      expiry_year: expiry_year,
+      cvv: cvv
+    )
+    Api::Request.new(
+      endpoint: Api::Endpoints::TOKENIZATION,
+      body: body,
+      response_object: Api::TokenizationResponse.new
+    ).run
+  end
+
+  def self.auth(amount:, payment_account_id:, customer_id:, order_id:)
+    body = Api::RequestBody.for_auth_or_sale(
+      amount: amount,
+      order_id: order_id,
+      customer_id: customer_id,
+      payment_account_id: payment_account_id
+    )
+    Api::Request.new(
+      endpoint: Api::Endpoints::AUTHORIZATION,
+      body: body,
+      response_object: Api::LiveTransactionResponse.new(:auth)
+    ).run
+  end
+
+  def self.auth_reversal(transaction_id:, amount: nil)
+    body = Api::RequestBody.for_auth_reversal(
+      transaction_id: transaction_id,
+      amount: amount
+    )
+
+    Api::Request.new(
+      endpoint: Api::Endpoints::AUTH_REVERSAL,
+      body: body,
+      response_object: Api::TiedTransactionResponse.new(:auth_reversal)
+    ).run
+  end
+
+  def self.capture(transaction_id:, amount: nil)
+    body = Api::RequestBody.for_capture(
+      transaction_id: transaction_id,
+      amount: amount
+    )
+
+    Api::Request.new(
+      endpoint: Api::Endpoints::CAPTURE,
+      body: body,
+      response_object: Api::TiedTransactionResponse.new(:capture)
+    ).run
+  end
+
+  def self.auth_capture(amount:, payment_account_id:, customer_id:, order_id:)
+    body = Api::RequestBody.for_auth_or_sale(
+      amount: amount,
+      order_id: order_id,
+      customer_id: customer_id,
+      payment_account_id: payment_account_id
+    )
+    Api::Request.new(
+      endpoint: Api::Endpoints::SALE,
+      body: body,
+      response_object: Api::LiveTransactionResponse.new(:sale)
+    ).run
+  end
+
+  # NOTE: ActiveMerchant's #refund... only for use on a capture or sale it seems
+  #       -> 'returns' are refunds too, credits are tied to a sale/capture, returns can be willy nilly
+  def self.credit(transaction_id:, amount:)
+    body = Api::RequestBody.for_credit(
+      amount: amount,
+      transaction_id: transaction_id
+    )
+    Api::Request.new(
+      endpoint: Api::Endpoints::CREDIT,
+      body: body,
+      response_object: Api::TiedTransactionResponse.new(:credit)
+    ).run
+  end
+
+  def self.refund(amount:, payment_account_id:, customer_id:, order_id:)
+    body = Api::RequestBody.for_return(
+      amount: amount,
+      customer_id: customer_id,
+      order_id: order_id,
+      payment_account_id: payment_account_id
+    )
+    Api::Request.new(
+      endpoint: Api::Endpoints::RETURN,
+      body: body,
+      response_object: Api::TiedTransactionResponse.new(:return)
+    ).run
+  end
+
+  # NOTE: can void credits
+  def self.void(transaction_id:)
+    Api::Request.new(
+      endpoint: Api::Endpoints::VOID,
+      body: Api::RequestBody.for_void(transaction_id: transaction_id),
+      response_object: Api::TiedTransactionResponse.new(:void)
+    ).run
+  end
+
+  def self.configure
+    yield self
+  end
+
+  class << self
+    [:environment, :license_id, :acceptor_id, :default_report_group, :order_source, :paypage_id].each do |config_var|
+      define_method :"#{config_var}" do
+        value = instance_variable_get(:"@#{config_var}")
+        raise "Missing Vantiv configuration: #{config_var}" unless value
+        value
+      end
+
+      define_method :"#{config_var}=" do |value|
+        instance_variable_set(:"@#{config_var}", value)
+      end
+    end
+  end
+
+  def self.root
+    File.dirname __dir__
+  end
+end

data/lib/vantiv/api.rb

@@ -0,0 +1,10 @@
+require 'vantiv/api/response'
+require 'vantiv/api/tied_transaction_response'
+require 'vantiv/api/live_transaction_response'
+require 'vantiv/api/tokenization_response'
+
+require 'vantiv/api/request'
+require 'vantiv/api/request_body_generator'
+require 'vantiv/api/request_body'
+
+require 'vantiv/api/endpoints'

data/lib/vantiv/api/capture_response.rb

@@ -0,0 +1,26 @@
+module Vantiv
+  module Api
+    class CaptureResponse < Api::Response
+      ResponseCodes = {
+        transaction_received: '001',
+        # TODO: check this and other possible response codes for this txn,
+        #       because currently the API _ONLY_ returns 001... :'(
+        invalid_amount: '209'
+      }
+
+      def success?
+        !api_level_failure? && response_code == ResponseCodes[:transaction_received]
+      end
+
+      def failure?
+        !success?
+      end
+
+      private
+
+      def transaction_response_name
+        "captureResponse"
+      end
+    end
+  end
+end

data/lib/vantiv/api/endpoints.rb

@@ -0,0 +1,15 @@
+module Vantiv
+  module Api
+    module Endpoints
+      AUTHORIZATION = "payment/sp2/credit/v1/authorization"
+      CAPTURE = "payment/sp2/credit/v1/authorizationCompletion"
+      AUTH_REVERSAL = "payment/sp2/credit/v1/reversal"
+      SALE = "payment/sp2/credit/v1/sale"
+      CREDIT = "payment/sp2/credit/v1/credit"
+      RETURN = "payment/sp2/credit/v1/return"
+      TOKENIZATION = "payment/sp2/services/v1/paymentAccountCreate"
+      VOID = "payment/sp2/credit/v1/void"
+    end
+  end
+end
+

data/lib/vantiv/api/live_transaction_response.rb

@@ -0,0 +1,50 @@
+module Vantiv
+  module Api
+    class LiveTransactionResponse < Api::Response
+      RESPONSE_CODES = {
+        approved: '000',
+        insufficient_funds: '110',
+        invalid_account_number: '301',
+        expired_card: '305',
+        token_not_found: '822'
+      }
+
+      LIVE_TRANSACTION_RESPONSE_NAMES = {
+        auth: "authorizationResponse",
+        sale: "saleResponse"
+      }
+
+      def initialize(transaction_name)
+        unless @transaction_response_name = LIVE_TRANSACTION_RESPONSE_NAMES[transaction_name]
+          raise "Implementation Error: Live transactions do not include #{transaction_name}"
+        end
+      end
+
+      def success?
+        !api_level_failure? && transaction_approved?
+      end
+
+      def failure?
+        !success?
+      end
+
+      def insufficient_funds?
+        response_code == RESPONSE_CODES[:insufficient_funds]
+      end
+
+      def invalid_account_number?
+        response_code == RESPONSE_CODES[:invalid_account_number]
+      end
+
+      def expired_card?
+        response_code == RESPONSE_CODES[:expired_card]
+      end
+
+      private
+
+      def transaction_approved?
+        response_code == RESPONSE_CODES[:approved]
+      end
+    end
+  end
+end