activemerchant 1.62.0 → 1.79.2

data/lib/active_merchant/billing/gateways/jetpay_v2.rb

@@ -0,0 +1,437 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class JetpayV2Gateway < Gateway
+      self.test_url = 'https://test1.jetpay.com/jetpay'
+      self.live_url = 'https://gateway20.jetpay.com/jetpay'
+
+      self.money_format = :cents
+      self.default_currency = 'USD'
+      self.supported_countries = ['US', 'CA']
+      self.supported_cardtypes = [:visa, :master, :american_express, :discover]
+
+      self.homepage_url = 'http://www.jetpay.com'
+      self.display_name = 'JetPay'
+
+      API_VERSION = '2.2'
+
+      ACTION_CODE_MESSAGES = {
+        "000" =>  "Approved.",
+        "001" =>  "Refer to card issuer.",
+        "002" =>  "Refer to card issuer, special condition.",
+        "003" =>  "Invalid merchant or service provider.",
+        "004" =>  "Pick up card.",
+        "005" =>  "Do not honor.",
+        "006" =>  "Error.",
+        "007" =>  "Pick up card, special condition.",
+        "008" =>  "Honor with ID (Show ID).",
+        "010" =>  "Partial approval.",
+        "011" =>  "VIP approval.",
+        "012" =>  "Invalid transaction.",
+        "013" =>  "Invalid amount or exceeds maximum for card program.",
+        "014" =>  "Invalid account number (no such number).",
+        "015" =>  "No such issuer.",
+        "019" =>  "Re-enter Transaction.",
+        "021" =>  "No action taken (unable to back out prior transaction).",
+        "025" =>  "Transaction Not Found.",
+        "027" =>  "File update field edit error.",
+        "028" =>  "File is temporarily unavailable.",
+        "030" =>  "Format error.",
+        "039" =>  "No credit account.",
+        "041" =>  "Pick up card (lost card).",
+        "043" =>  "Pick up card (stolen card).",
+        "051" =>  "Insufficient funds.",
+        "052" =>  "No checking account.",
+        "053" =>  "Mp savomgs accpimt.",
+        "054" =>  "Expired Card.",
+        "055" =>  "Incorrect PIN.",
+        "057" =>  "Transaction not permitted to cardholder.",
+        "058" =>  "Transaction not allowed at terminal.",
+        "061" =>  "Exceeds withdrawal limit.",
+        "062" =>  "Restricted card (eg, Country Exclusion).",
+        "063" =>  "Security violation.",
+        "065" =>  "Activity count limit exceeded.",
+        "068" =>  "Response late.",
+        "070" =>  "Contact card issuer.",
+        "071" =>  "PIN not changed.",
+        "075" =>  "Allowable number of PIN-entry tries exceeded.",
+        "076" =>  "Unable to locate previous message (no matching retrieval reference number).",
+        "077" =>  "Repeat or reversal data are inconsistent with original message.",
+        "078" =>  "Blocked (first use), or non-existent account.",
+        "079" =>  "Key exchange validation failed.",
+        "080" =>  "Credit issuer unavailable or invalid date.",
+        "081" =>  "PIN cryptographic error found.",
+        "082" =>  "Negative online CVV results.",
+        "084" =>  "Invalid auth life cycle.",
+        "085" =>  "No reason to decline - CVV or AVS approved.",
+        "086" =>  "Cannot verify PIN.",
+        "087" =>  "Cashback not allowed.",
+        "089" =>  "Issuer Down.",
+        "091" =>  "Issuer Down.",
+        "092" =>  "Unable to route transaction.",
+        "093" =>  "Transaction cannot be completed - violation of law.",
+        "094" =>  "Duplicate transmission.",
+        "096" =>  "System error.",
+        "100" =>  "Deny.",
+        "101" =>  "Expired Card.",
+        "103" =>  "Deny - Invalid manual Entry 4DBC.",
+        "104" =>  "Deny - New card issued.",
+        "105" =>  "Deny - Account Cancelled.",
+        "106" =>  "Exceeded PIN Attempts.",
+        "107" =>  "Please Call Issuer.",
+        "109" =>  "Invalid merchant.",
+        "110" =>  "Invalid amount.",
+        "111" =>  "Invalid account.",
+        "115" =>  "Service not permitted.",
+        "117" =>  "Invalid PIN.",
+        "119" =>  "Card member not enrolled.",
+        "122" =>  "Invalid card (CID) security code.",
+        "125" =>  "Invalid effective date.",
+        "181" =>  "Format error.",
+        "182" =>  "Please wait.",
+        "183" =>  "Invalid currency code.",
+        "187" =>  "Deny - new card issued.",
+        "188" =>  "Deny - Expiration date required.",
+        "189" =>  "Deny - Cancelled or Closed Merchant/SE.",
+        "200" =>  "Deny - Pick up card.",
+        "400" =>  "Reversal accepted.",
+        "601" =>  "Reject - EMV Chip Declined Transaction.",
+        "602" =>  "Reject - Suspected Fraud.",
+        "603" =>  "Reject - Communications Error.",
+        "604" =>  "Reject - Insufficient Approval.",
+        "750" =>  "Velocity Check Fail.",
+        "899" =>  "Misc Decline.",
+        "900" =>  "Invalid Message Type.",
+        "901" =>  "Invalid Merchant ID.",
+        "903" =>  "Debit not supported.",
+        "904" =>  "Private label not supported.",
+        "905" =>  "Invalid card type.",
+        "906" =>  "Unit not active.",
+        "908" =>  "Manual card entry invalid.",
+        "909" =>  "Invalid track information.",
+        "911" =>  "Master merchant not found.",
+        "912" =>  "Invalid card format.",
+        "913" =>  "Invalid card type.",
+        "914" =>  "Invalid card length.",
+        "917" =>  "Expired card.",
+        "919" =>  "Invalid entry type.",
+        "920" =>  "Invalid amount.",
+        "921" =>  "Invalid messge format.",
+        "923" =>  "Invalid ABA.",
+        "924" =>  "Invalid DDA.",
+        "925" =>  "Invalid TID.",
+        "926" =>  "Invalid Password.",
+        "930" =>  "Invalid zipcode.",
+        "931" =>  "Invalid Address.",
+        "932" =>  "Invalid ZIP and Address.",
+        "933" =>  "Invalid CVV2.",
+        "934" =>  "Program Not Allowed.",
+        "935" =>  "Invalid Device/App.",
+        "940" =>  "Record Not Found.",
+        "941" =>  "Merchant ID error.",
+        "942" =>  "Refund Not Allowed.",
+        "943" =>  "Refund denied.",
+        "955" =>  "Invalid PIN block.",
+        "956" =>  "Invalid KSN.",
+        "958" =>  "Bad Status.",
+        "959" =>  "Seek Record limit exceeded.",
+        "960" =>  "Internal Key Database Error.",
+        "961" =>  "TRANS not Supported. Cash Disbursement required a specific MCC.",
+        "962" =>  "Invalid PIN key (Unknown KSN).",
+        "981" =>  "Invalid AVS.",
+        "987" =>  "Issuer Unavailable.",
+        "988" =>  "System error SD.",
+        "989" =>  "Database Error.",
+        "992" =>  "Transaction Timeout.",
+        "996" =>  "Bad Terminal ID.",
+        "997" =>  "Message rejected by association.",
+        "999" =>  "Communication failure",
+        nil   =>  "No response returned (missing credentials?)."
+      }
+
+      def initialize(options = {})
+        requires!(options, :login)
+        super
+      end
+
+      def purchase(money, payment, options = {})
+        commit(money, build_sale_request(money, payment, options))
+      end
+
+      def authorize(money, payment, options = {})
+        commit(money, build_authonly_request(money, payment, options))
+      end
+
+      def capture(money, reference, options = {})
+        transaction_id, _, _, token = reference.split(";")
+        commit(money, build_capture_request(money, transaction_id, options), token)
+      end
+
+      def void(reference, options = {})
+        transaction_id, _, amount, token = reference.split(";")
+        commit(amount.to_i, build_void_request(amount.to_i, transaction_id, options), token)
+      end
+
+      def credit(money, payment, options = {})
+        commit(money, build_credit_request(money, nil, payment, options))
+      end
+
+      def refund(money, reference, options = {})
+        transaction_id, _, _, token = reference.split(";")
+        commit(money, build_credit_request(money, transaction_id, token, options), token)
+      end
+
+      def verify(credit_card, options = {})
+        authorize(0, credit_card, options)
+      end
+
+      def store(credit_card, options = {})
+        commit(nil, build_store_request(credit_card, options))
+      end
+
+      def supports_scrubbing
+        true
+      end
+
+      def scrub(transcript)
+        transcript.
+          gsub(%r((Authorization: Basic )\w+), '\1[FILTERED]').
+          gsub(%r((>)\d+(</CardNum>)), '\1[FILTERED]\2').
+          gsub(%r((<CVV2>)\d+(</CVV2>)), '\1[FILTERED]\2')
+      end
+
+      private
+
+      def build_xml_request(transaction_type, options = {}, transaction_id = nil, &block)
+        xml = Builder::XmlMarkup.new
+        xml.tag! 'JetPay', 'Version' => API_VERSION do
+          # Basic values needed for any request
+          xml.tag! 'TerminalID', @options[:login]
+          xml.tag! 'TransactionType', transaction_type
+          xml.tag! 'TransactionID', transaction_id.nil? ? generate_unique_id.slice(0, 18) : transaction_id
+          xml.tag! 'Origin', options[:origin] || 'INTERNET'
+          xml.tag! 'IndustryInfo', 'Type' => options[:industry_info] || 'ECOMMERCE'
+          xml.tag! 'Application', (options[:application] || 'n/a'), {'Version' => options[:application_version] || '1.0'}
+          xml.tag! 'Device', (options[:device] || 'n/a'), {'Version' => options[:device_version] || '1.0'}
+          xml.tag! 'Library', 'VirtPOS SDK', 'Version' => '1.5'
+          xml.tag! 'Gateway', 'JetPay'
+          xml.tag! 'DeveloperID', options[:developer_id] || 'n/a'
+
+          if block_given?
+            yield xml
+          else
+            xml.target!
+          end
+        end
+      end
+
+      def build_sale_request(money, payment, options)
+        build_xml_request('SALE', options) do |xml|
+          add_payment(xml, payment)
+          add_addresses(xml, options)
+          add_customer_data(xml, options)
+          add_invoice_data(xml, options)
+          add_user_defined_fields(xml, options)
+          xml.tag! 'TotalAmount', amount(money)
+
+          xml.target!
+        end
+      end
+
+      def build_authonly_request(money, payment, options)
+        build_xml_request('AUTHONLY', options) do |xml|
+          add_payment(xml, payment)
+          add_addresses(xml, options)
+          add_customer_data(xml, options)
+          add_invoice_data(xml, options)
+          add_user_defined_fields(xml, options)
+          xml.tag! 'TotalAmount', amount(money)
+
+          xml.target!
+        end
+      end
+
+      def build_capture_request(money, transaction_id, options)
+        build_xml_request('CAPT', options, transaction_id) do |xml|
+          add_invoice_data(xml, options)
+          add_purchase_order(xml, options)
+          add_user_defined_fields(xml, options)
+          xml.tag! 'TotalAmount', amount(money)
+
+          xml.target!
+        end
+      end
+
+      def build_void_request(money, transaction_id, options)
+        build_xml_request('VOID', options, transaction_id) do |xml|
+          xml.tag! 'TotalAmount', amount(money)
+          xml.target!
+        end
+      end
+
+      def build_credit_request(money, transaction_id, payment, options)
+        build_xml_request('CREDIT', options, transaction_id) do |xml|
+          add_payment(xml, payment)
+          add_invoice_data(xml, options)
+          add_addresses(xml, options)
+          add_customer_data(xml, options)
+          add_user_defined_fields(xml, options)
+          xml.tag! 'TotalAmount', amount(money)
+
+          xml.target!
+        end
+      end
+
+      def build_store_request(credit_card, options)
+        build_xml_request('TOKENIZE', options) do |xml|
+          add_payment(xml, credit_card)
+          add_addresses(xml, options)
+          add_customer_data(xml, options)
+
+          xml.target!
+        end
+      end
+
+      def commit(money, request, token = nil)
+        response = parse(ssl_post(url, request))
+
+        success = success?(response)
+        Response.new(success,
+          success ? 'APPROVED' : message_from(response),
+          response,
+          :test => test?,
+          :authorization => authorization_from(response, money, token),
+          :avs_result => AVSResult.new(:code => response[:avs]),
+          :cvv_result => CVVResult.new(response[:cvv2]),
+          :error_code => success ? nil : error_code_from(response)
+        )
+      end
+
+      def url
+        test? ? test_url : live_url
+      end
+
+      def parse(body)
+        return {} if body.blank?
+
+        xml = REXML::Document.new(body)
+
+        response = {}
+        xml.root.elements.to_a.each do |node|
+          parse_element(response, node)
+        end
+        response
+      end
+
+      def parse_element(response, node)
+        if node.has_elements?
+          node.elements.each{|element| parse_element(response, element) }
+        else
+          response[node.name.underscore.to_sym] = node.text
+        end
+      end
+
+      def format_exp(value)
+        format(value, :two_digits)
+      end
+
+      def success?(response)
+        response[:action_code] == "000"
+      end
+
+      def message_from(response)
+        ACTION_CODE_MESSAGES[response[:action_code]]
+      end
+
+      def authorization_from(response, money, previous_token)
+        original_amount = amount(money) if money
+        [ response[:transaction_id], response[:approval], original_amount, (response[:token] || previous_token)].join(";")
+      end
+
+      def error_code_from(response)
+        response[:action_code]
+      end
+
+      def add_payment(xml, payment)
+        return unless payment
+
+        if payment.is_a? String
+          token = payment
+          _, _, _, token = payment.split(";") if payment.include? ";"
+          xml.tag! 'Token', token if token
+        else
+          add_credit_card(xml, payment)
+        end
+      end
+
+      def add_credit_card(xml, credit_card)
+        xml.tag! 'CardNum', credit_card.number, "CardPresent" => false, "Tokenize" => true
+        xml.tag! 'CardExpMonth', format_exp(credit_card.month)
+        xml.tag! 'CardExpYear', format_exp(credit_card.year)
+
+        if credit_card.first_name || credit_card.last_name
+          xml.tag! 'CardName', [credit_card.first_name,credit_card.last_name].compact.join(' ')
+        end
+
+        unless credit_card.verification_value.nil? || (credit_card.verification_value.length == 0)
+          xml.tag! 'CVV2', credit_card.verification_value
+        end
+      end
+
+      def add_addresses(xml, options)
+        if billing_address = options[:billing_address] || options[:address]
+          xml.tag! 'Billing' do
+            xml.tag! 'Address', [billing_address[:address1], billing_address[:address2]].compact.join(" ")
+            xml.tag! 'City', billing_address[:city]
+            xml.tag! 'StateProv', billing_address[:state]
+            xml.tag! 'PostalCode', billing_address[:zip]
+            xml.tag! 'Country', lookup_country_code(billing_address[:country])
+            xml.tag! 'Phone', billing_address[:phone]
+            xml.tag! 'Email', options[:email] if options[:email]
+          end
+        end
+
+        if shipping_address = options[:shipping_address]
+          xml.tag! 'Shipping' do
+            xml.tag! 'Name', shipping_address[:name]
+            xml.tag! 'Address', [shipping_address[:address1], shipping_address[:address2]].compact.join(" ")
+            xml.tag! 'City', shipping_address[:city]
+            xml.tag! 'StateProv', shipping_address[:state]
+            xml.tag! 'PostalCode', shipping_address[:zip]
+            xml.tag! 'Country', lookup_country_code(shipping_address[:country])
+            xml.tag! 'Phone', shipping_address[:phone]
+          end
+        end
+      end
+
+      def add_customer_data(xml, options)
+        xml.tag! 'UserIPAddress', options[:ip] if options[:ip]
+      end
+
+      def add_invoice_data(xml, options)
+        xml.tag! 'OrderNumber', options[:order_id] if options[:order_id]
+        if tax_amount = options[:tax_amount]
+          xml.tag! 'TaxAmount', tax_amount, {'ExemptInd' => options[:tax_exempt] || "false"}
+        end
+      end
+
+      def add_purchase_order(xml, options)
+        if purchase_order = options[:purchase_order]
+          xml.tag! 'Billing' do
+            xml.tag! 'CustomerPO', purchase_order
+          end
+        end
+      end
+
+      def add_user_defined_fields(xml, options)
+        xml.tag! 'UDField1', options[:ud_field_1] if options[:ud_field_1]
+        xml.tag! 'UDField2', options[:ud_field_2] if options[:ud_field_2]
+        xml.tag! 'UDField3', options[:ud_field_3] if options[:ud_field_3]
+      end
+
+      def lookup_country_code(code)
+        country = Country.find(code) rescue nil
+        country && country.code(:alpha3)
+      end
+    end
+  end
+end

data/lib/active_merchant/billing/gateways/kushki.rb

@@ -0,0 +1,227 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class KushkiGateway < Gateway
+      self.display_name = "Kushki"
+      self.homepage_url = "https://www.kushkipagos.com"
+
+      self.test_url = "https://api-uat.kushkipagos.com/v1/"
+      self.live_url = "https://api.kushkipagos.com/v1/"
+
+      self.supported_countries = ["CO", "EC"]
+      self.default_currency = "USD"
+      self.money_format = :dollars
+      self.supported_cardtypes = [:visa, :master, :american_express, :discover, :diners_club]
+
+      def initialize(options={})
+        requires!(options, :public_merchant_id, :private_merchant_id)
+        super
+      end
+
+      def purchase(amount, payment_method, options={})
+        MultiResponse.run() do |r|
+          r.process { tokenize(amount, payment_method, options) }
+          r.process { charge(amount, r.authorization, options) }
+        end
+      end
+
+      def refund(amount, authorization, options={})
+        action = "refund"
+
+        post = {}
+        post[:ticketNumber] = authorization
+
+        commit(action, post)
+      end
+
+      def void(authorization, options={})
+        action = "void"
+
+        post = {}
+        post[:ticketNumber] = authorization
+
+        commit(action, post)
+      end
+
+      def supports_scrubbing?
+        true
+      end
+
+      def scrub(transcript)
+        transcript.
+          gsub(%r((Private-Merchant-Id: )\d+), '\1[FILTERED]').
+          gsub(%r((\"card\\\":{\\\"number\\\":\\\")\d+), '\1[FILTERED]').
+          gsub(%r((\"cvv\\\":\\\")\d+), '\1[FILTERED]')
+      end
+
+      private
+
+      def tokenize(amount, payment_method, options)
+        action = "tokenize"
+
+        post = {}
+        add_invoice(action, post, amount, options)
+        add_payment_method(post, payment_method, options)
+
+        commit(action, post)
+      end
+
+      def charge(amount, authorization, options)
+        action = "charge"
+
+        post = {}
+        add_reference(post, authorization, options)
+        add_invoice(action, post, amount, options)
+
+        commit(action, post)
+      end
+
+      def add_invoice(action, post, money, options)
+        if action == "tokenize"
+          post[:totalAmount] = amount(money).to_f
+          post[:currency] = options[:currency] || currency(money)
+          post[:isDeferred] = false
+        else
+          sum = {}
+          sum[:currency] = options[:currency] || currency(money)
+          add_amount_defaults(sum, money, options)
+          add_amount_by_country(sum, options)
+          post[:amount] = sum
+        end
+      end
+
+      def add_amount_defaults(sum, money, options)
+        sum[:subtotalIva] = amount(money).to_f
+        sum[:iva] = 0
+        sum[:subtotalIva0] = 0
+
+        if sum[:currency] == "COP"
+          extra_taxes = {}
+          extra_taxes[:propina] = 0
+          extra_taxes[:tasaAeroportuaria] = 0
+          extra_taxes[:agenciaDeViaje] = 0
+          extra_taxes[:iac] = 0
+          sum[:extraTaxes] = extra_taxes
+        else
+          sum[:ice] = 0
+        end
+      end
+
+      def add_amount_by_country(sum, options)
+        if amount = options[:amount]
+          sum[:subtotalIva] = amount[:subtotal_iva].to_f if amount[:subtotal_iva]
+          sum[:iva] = amount[:iva].to_f if amount[:iva]
+          sum[:subtotalIva0] = amount[:subtotal_iva_0].to_f if amount[:subtotal_iva_0]
+          sum[:ice] = amount[:ice].to_f if amount[:ice]
+          if extra_taxes = amount[:extra_taxes] && sum[:currency] == "COP"
+            sum[:extraTaxes][:propina] = extra_taxes[:propina].to_f if extra_taxes[:propina]
+            sum[:extraTaxes][:tasaAeroportuaria] = extra_taxes[:tasa_aeroportuaria].to_f if extra_taxes[:tasa_aeroportuaria]
+            sum[:extraTaxes][:agenciaDeViaje] = extra_taxes[:agencia_de_viaje].to_f if extra_taxes[:agencia_de_viaje]
+            sum[:extraTaxes][:iac] = extra_taxes[:iac].to_f if extra_taxes[:iac]
+          end
+        end
+      end
+
+      def add_payment_method(post, payment_method, options)
+        card = {}
+        card[:number] = payment_method.number
+        card[:cvv] = payment_method.verification_value
+        card[:expiryMonth] = format(payment_method.month, :two_digits)
+        card[:expiryYear] = format(payment_method.year, :two_digits)
+        card[:name] = payment_method.name
+        post[:card] = card
+      end
+
+      def add_reference(post, authorization, options)
+        post[:token] = authorization
+      end
+
+      ENDPOINT = {
+        "tokenize" => "tokens",
+        "charge" => "charges",
+        "void" => "charges",
+        "refund" => "refund"
+      }
+
+      def commit(action, params)
+        response = begin
+          parse(ssl_invoke(action, params))
+        rescue ResponseError => e
+          parse(e.response.body)
+        end
+
+        success = success_from(response)
+
+        Response.new(
+          success,
+          message_from(success, response),
+          response,
+          authorization: success ? authorization_from(response) : nil,
+          error_code: success ? nil : error_from(response),
+          test: test?
+        )
+      end
+
+      def ssl_invoke(action, params)
+        if ["void", "refund"].include?(action)
+          ssl_request(:delete, url(action, params), nil, headers(action))
+        else
+          ssl_post(url(action, params), post_data(params), headers(action))
+        end
+      end
+
+      def headers(action)
+        hfields = {}
+        hfields["Public-Merchant-Id"] = @options[:public_merchant_id] if action == "tokenize"
+        hfields["Private-Merchant-Id"] = @options[:private_merchant_id] unless action == "tokenize"
+        hfields["Content-Type"] = "application/json"
+        hfields
+      end
+
+      def post_data(params)
+        params.to_json
+      end
+
+      def url(action, params)
+        base_url = test? ? test_url : live_url
+
+        if ["void", "refund"].include?(action)
+          base_url + ENDPOINT[action] + "/" + params[:ticketNumber].to_s
+        else
+          base_url + ENDPOINT[action]
+        end
+      end
+
+      def parse(body)
+        begin
+          JSON.parse(body)
+        rescue JSON::ParserError
+          message = "Invalid JSON response received from KushkiGateway. Please contact KushkiGateway if you continue to receive this message."
+          message += " (The raw response returned by the API was #{body.inspect})"
+          {
+            "message" => message
+          }
+        end
+      end
+
+      def success_from(response)
+        return true if response["token"] || response["ticketNumber"] || response["code"] == "K000"
+      end
+
+      def message_from(succeeded, response)
+        if succeeded
+          "Succeeded"
+        else
+          response["message"]
+        end
+      end
+
+      def authorization_from(response)
+        response["token"] || response["ticketNumber"]
+      end
+
+      def error_from(response)
+        response["code"]
+      end
+    end
+  end
+end

data/lib/active_merchant/billing/gateways/linkpoint.rb

@@ -143,9 +143,9 @@ module ActiveMerchant #:nodoc:
           :pem => LinkpointGateway.pem_file
         }.update(options)
 
-        @options[:pem].strip!
-
         raise ArgumentError, "You need to pass in your pem file using the :pem parameter or set it globally using ActiveMerchant::Billing::LinkpointGateway.pem_file = File.read( File.dirname(__FILE__) + '/../mycert.pem' ) or similar" if @options[:pem].blank?
+
+        @options[:pem].strip!
       end
 
       # Send a purchase request with periodic options