activemerchant 1.133.0 → 1.138.0

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

@@ -1,8 +1,8 @@
 require 'nokogiri'
 require 'securerandom'
 
-module ActiveMerchant #:nodoc:
-  module Billing #:nodoc:
+module ActiveMerchant # :nodoc:
+  module Billing # :nodoc:
     class ElementGateway < Gateway
       self.test_url = 'https://certtransaction.elementexpress.com/express.asmx'
       self.live_url = 'https://transaction.elementexpress.com/express.asmx'
@@ -37,6 +37,7 @@ module ActiveMerchant #:nodoc:
             add_transaction(xml, money, options)
             add_terminal(xml, options)
             add_address(xml, options)
+            add_lodging(xml, options)
           end
         end
 
@@ -51,6 +52,7 @@ module ActiveMerchant #:nodoc:
             add_transaction(xml, money, options)
             add_terminal(xml, options)
             add_address(xml, options)
+            add_lodging(xml, options)
           end
         end
 
@@ -102,7 +104,7 @@ module ActiveMerchant #:nodoc:
 
       def void(authorization, options = {})
         trans_id, trans_amount = split_authorization(authorization)
-        options.merge!({ trans_id: trans_id, trans_amount: trans_amount, reversal_type: 'Full' })
+        options.merge!({ trans_id:, trans_amount:, reversal_type: 'Full' })
 
         request = build_soap_request do |xml|
           xml.CreditCardReversal(xmlns: 'https://transaction.elementexpress.com') do
@@ -222,16 +224,44 @@ module ActiveMerchant #:nodoc:
         options[:market_code] || 'Default'
       end
 
+      def add_lodging(xml, options)
+        if lodging = options[:lodging]
+          xml.extendedParameters do
+            xml.ExtendedParameters do
+              xml.Key 'Lodging'
+              xml.Value('xsi:type' => 'Lodging') do
+                xml.LodgingAgreementNumber lodging[:agreement_number] if lodging[:agreement_number]
+                xml.LodgingCheckInDate lodging[:check_in_date] if lodging[:check_in_date]
+                xml.LodgingCheckOutDate lodging[:check_out_date] if lodging[:check_out_date]
+                xml.LodgingRoomAmount lodging[:room_amount] if lodging[:room_amount]
+                xml.LodgingRoomTax lodging[:room_tax] if lodging[:room_tax]
+                xml.LodgingNoShowIndicator lodging[:no_show_indicator] if lodging[:no_show_indicator]
+                xml.LodgingDuration lodging[:duration] if lodging[:duration]
+                xml.LodgingCustomerName lodging[:customer_name] if lodging[:customer_name]
+                xml.LodgingClientCode lodging[:client_code] if lodging[:client_code]
+                xml.LodgingExtraChargesDetail lodging[:extra_charges_detail] if lodging[:extra_charges_detail]
+                xml.LodgingExtraChargesAmounts lodging[:extra_charges_amounts] if lodging[:extra_charges_amounts]
+                xml.LodgingPrestigiousPropertyCode lodging[:prestigious_property_code] if lodging[:prestigious_property_code]
+                xml.LodgingSpecialProgramCode lodging[:special_program_code] if lodging[:special_program_code]
+                xml.LodgingChargeType lodging[:charge_type] if lodging[:charge_type]
+              end
+            end
+          end
+        end
+      end
+
       def add_terminal(xml, options)
         xml.terminal do
           xml.TerminalID options[:terminal_id] || '01'
+          xml.TerminalType options[:terminal_type] if options[:terminal_type]
           xml.CardPresentCode options[:card_present_code] || 'UseDefault'
-          xml.CardholderPresentCode 'UseDefault'
-          xml.CardInputCode 'UseDefault'
-          xml.CVVPresenceCode 'UseDefault'
-          xml.TerminalCapabilityCode 'UseDefault'
-          xml.TerminalEnvironmentCode 'UseDefault'
+          xml.CardholderPresentCode options[:card_holder_present_code] || 'UseDefault'
+          xml.CardInputCode options[:card_input_code] || 'UseDefault'
+          xml.CVVPresenceCode options[:cvv_presence_code] || 'UseDefault'
+          xml.TerminalCapabilityCode options[:terminal_capability_code] || 'UseDefault'
+          xml.TerminalEnvironmentCode options[:terminal_environment_code] || 'UseDefault'
           xml.MotoECICode 'NonAuthenticatedSecureECommerceTransaction'
+          xml.PartialApprovedFlag options[:partial_approved_flag] if options[:partial_approved_flag]
         end
       end
 
@@ -240,7 +270,7 @@ module ActiveMerchant #:nodoc:
           xml.CardNumber payment.number
           xml.ExpirationMonth format(payment.month, :two_digits)
           xml.ExpirationYear format(payment.year, :two_digits)
-          xml.CardholderName payment.first_name + ' ' + payment.last_name
+          xml.CardholderName "#{payment.first_name} #{payment.last_name}"
           xml.CVV payment.verification_value
         end
       end
@@ -363,7 +393,6 @@ module ActiveMerchant #:nodoc:
           xml['soap'].Envelope('xmlns:xsi' => 'http://www.w3.org/2001/XMLSchema-instance',
                                'xmlns:xsd' => 'http://www.w3.org/2001/XMLSchema',
                                'xmlns:soap' => 'http://schemas.xmlsoap.org/soap/envelope/') do
-
             xml['soap'].Body do
               yield(xml)
             end

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

@@ -1,5 +1,5 @@
-module ActiveMerchant #:nodoc:
-  module Billing #:nodoc:
+module ActiveMerchant # :nodoc:
+  module Billing # :nodoc:
     class EpayGateway < Gateway
       self.live_url = 'https://ssl.ditonlinebetalingssystem.dk/'
 
@@ -174,17 +174,21 @@ module ActiveMerchant #:nodoc:
         response = send("do_#{action}", params)
 
         if action == :authorize
-          Response.new response['accept'].to_i == 1,
+          Response.new(
+            response['accept'].to_i == 1,
             response['errortext'],
             response,
             test: test?,
             authorization: response['tid']
+          )
         else
-          Response.new response['result'] == 'true',
+          Response.new(
+            response['result'] == 'true',
             messages(response['epay'], response['pbs']),
             response,
             test: test?,
             authorization: params[:transaction]
+          )
         end
       end
 

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

@@ -1,5 +1,5 @@
-module ActiveMerchant #:nodoc:
-  module Billing #:nodoc:
+module ActiveMerchant # :nodoc:
+  module Billing # :nodoc:
     # === EVO Canada payment gateway.
     #
     # EVO returns two different identifiers for most transactions, the
@@ -279,11 +279,15 @@ module ActiveMerchant #:nodoc:
         response = parse(data)
         message = message_from(response)
 
-        Response.new(success?(response), message, response,
+        Response.new(
+          success?(response),
+          message,
+          response,
           test: test?,
           authorization: response['transactionid'],
           avs_result: { code: response['avsresponse'] },
-          cvv_result: response['cvvresponse'])
+          cvv_result: response['cvvresponse']
+        )
       end
 
       def message_from(response)

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

@@ -1,7 +1,7 @@
 require 'rexml/document'
 
-module ActiveMerchant #:nodoc:
-  module Billing #:nodoc:
+module ActiveMerchant # :nodoc:
+  module Billing # :nodoc:
     # Public: For more information on the Eway Gateway please visit their
     # {Developers Area}[http://www.eway.com.au/developers/api/direct-payments]
     class EwayGateway < Gateway
@@ -111,11 +111,13 @@ module ActiveMerchant #:nodoc:
         raw_response = ssl_post(url, post_data(parameters))
         response = parse(raw_response)
 
-        Response.new(success?(response),
+        Response.new(
+          success?(response),
           message_from(response[:ewaytrxnerror]),
           response,
           authorization: response[:ewaytrxnnumber],
-          test: test?)
+          test: test?
+        )
       end
 
       def success?(response)

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

@@ -1,5 +1,5 @@
-module ActiveMerchant #:nodoc:
-  module Billing #:nodoc:
+module ActiveMerchant # :nodoc:
+  module Billing # :nodoc:
     class EwayManagedGateway < Gateway
       self.test_url = 'https://www.eway.com.au/gateway/ManagedPaymentService/test/managedCreditCardPayment.asmx'
       self.live_url = 'https://www.eway.com.au/gateway/ManagedPaymentService/managedCreditCardPayment.asmx'
@@ -222,9 +222,13 @@ module ActiveMerchant #:nodoc:
           end
         response = parse(raw)
 
-        EwayResponse.new(response[:success], response[:message], response,
+        EwayResponse.new(
+          response[:success],
+          response[:message],
+          response,
           test: test?,
-          authorization: response[:auth_code])
+          authorization: response[:auth_code]
+        )
       end
 
       # Where we build the full SOAP 1.2 request using builder

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

@@ -1,7 +1,7 @@
 require 'json'
 
-module ActiveMerchant #:nodoc:
-  module Billing #:nodoc:
+module ActiveMerchant # :nodoc:
+  module Billing # :nodoc:
     class EwayRapidGateway < Gateway
       self.test_url = 'https://api.sandbox.ewaypayments.com/'
       self.live_url = 'https://api.ewaypayments.com/'
@@ -378,7 +378,7 @@ module ActiveMerchant #:nodoc:
           else
             'I'
           end
-        { code: code }
+        { code: }
       end
 
       def cvv_result_from(response)

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

@@ -1,5 +1,5 @@
-module ActiveMerchant #:nodoc:
-  module Billing #:nodoc:
+module ActiveMerchant # :nodoc:
+  module Billing # :nodoc:
     class ExactGateway < Gateway
       self.live_url = self.test_url = 'https://secure2.e-xact.com/vplug-in/transaction/rpc-enc/service.asmx'
 
@@ -158,11 +158,15 @@ module ActiveMerchant #:nodoc:
       def commit(action, request)
         response = parse(ssl_post(self.live_url, build_request(action, request), POST_HEADERS))
 
-        Response.new(successful?(response), message_from(response), response,
+        Response.new(
+          successful?(response),
+          message_from(response),
+          response,
           test: test?,
           authorization: authorization_from(response),
           avs_result: { code: response[:avs] },
-          cvv_result: response[:cvv2])
+          cvv_result: response[:cvv2]
+        )
       rescue ResponseError => e
         case e.response.code
         when '401'

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

@@ -1,10 +1,12 @@
 require 'json'
 
-module ActiveMerchant #:nodoc:
-  module Billing #:nodoc:
+module ActiveMerchant # :nodoc:
+  module Billing # :nodoc:
     class FatZebraGateway < Gateway
-      self.live_url = 'https://gateway.fatzebra.com.au/v1.0'
-      self.test_url = 'https://gateway.sandbox.fatzebra.com.au/v1.0'
+      version 'v1.0'
+
+      self.live_url = "https://gateway.fatzebra.com.au/#{fetch_version}"
+      self.test_url = "https://gateway.sandbox.fatzebra.com.au/#{fetch_version}"
 
       self.supported_countries = ['AU']
       self.default_currency = 'AUD'
@@ -28,6 +30,7 @@ module ActiveMerchant #:nodoc:
         add_order_id(post, options)
         add_ip(post, options)
         add_metadata(post, options)
+        add_three_ds(post, options)
 
         commit(:post, 'purchases', post)
       end
@@ -41,6 +44,7 @@ module ActiveMerchant #:nodoc:
         add_order_id(post, options)
         add_ip(post, options)
         add_metadata(post, options)
+        add_three_ds(post, options)
 
         post[:capture] = false
 
@@ -125,16 +129,42 @@ module ActiveMerchant #:nodoc:
       def add_extra_options(post, options)
         extra = {}
         extra[:ecm] = '32' if options[:recurring]
-        extra[:cavv] = options[:cavv] || options.dig(:three_d_secure, :cavv) if options[:cavv] || options.dig(:three_d_secure, :cavv)
-        extra[:xid] = options[:xid] || options.dig(:three_d_secure, :xid) if options[:xid] || options.dig(:three_d_secure, :xid)
-        extra[:sli] = options[:sli] || options.dig(:three_d_secure, :eci) if options[:sli] || options.dig(:three_d_secure, :eci)
         extra[:name] = options[:merchant] if options[:merchant]
         extra[:location] = options[:merchant_location] if options[:merchant_location]
         extra[:card_on_file] = options.dig(:extra, :card_on_file) if options.dig(:extra, :card_on_file)
         extra[:auth_reason]  = options.dig(:extra, :auth_reason) if options.dig(:extra, :auth_reason)
+
+        unless options[:three_d_secure].present?
+          extra[:sli] = options[:sli] if options[:sli]
+          extra[:xid] = options[:xid] if options[:xid]
+          extra[:cavv] = options[:cavv] if options[:cavv]
+        end
+
         post[:extra] = extra if extra.any?
       end
 
+      def add_three_ds(post, options)
+        return unless three_d_secure = options[:three_d_secure]
+
+        post[:extra] = {
+          sli: three_d_secure[:eci],
+          xid: three_d_secure[:xid],
+          cavv: three_d_secure[:cavv],
+          par: three_d_secure[:authentication_response_status],
+          ver: formatted_enrollment(three_d_secure[:enrolled]),
+          threeds_version: three_d_secure[:version],
+          directory_server_txn_id: three_d_secure[:ds_transaction_id]
+        }.compact
+      end
+
+      def formatted_enrollment(val)
+        case val
+        when 'Y', 'N', 'U' then val
+        when true, 'true' then 'Y'
+        when false, 'false' then 'N'
+        end
+      end
+
       def add_order_id(post, options)
         post[:reference] = options[:order_id] || SecureRandom.hex(15)
       end

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

@@ -1,5 +1,5 @@
-module ActiveMerchant #:nodoc:
-  module Billing #:nodoc:
+module ActiveMerchant # :nodoc:
+  module Billing # :nodoc:
     class FederatedCanadaGateway < Gateway
       # Same URL for both test and live, testing is done by using the test username (demo) and password (password).
       self.live_url = self.test_url = 'https://secure.federatedgateway.com/api/transact.php'
@@ -121,11 +121,15 @@ module ActiveMerchant #:nodoc:
         response = parse(data)
         message = message_from(response)
 
-        Response.new(success?(response), message, response,
+        Response.new(
+          success?(response),
+          message,
+          response,
           test: test?,
           authorization: response['transactionid'],
           avs_result: { code: response['avsresponse'] },
-          cvv_result: response['cvvresponse'])
+          cvv_result: response['cvvresponse']
+        )
       end
 
       def success?(response)

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

@@ -1,7 +1,7 @@
 require 'active_merchant/billing/gateways/cc5'
 
-module ActiveMerchant #:nodoc:
-  module Billing #:nodoc:
+module ActiveMerchant # :nodoc:
+  module Billing # :nodoc:
     class FinansbankGateway < CC5Gateway
       self.live_url = 'https://www.fbwebpos.com/servlet/cc5ApiServer'
       self.test_url = 'https://entegrasyon.asseco-see.com.tr/fim/api'

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

@@ -1,7 +1,7 @@
 require 'nokogiri'
 
-module ActiveMerchant #:nodoc:
-  module Billing #:nodoc:
+module ActiveMerchant # :nodoc:
+  module Billing # :nodoc:
     class FirstGivingGateway < Gateway
       self.test_url = 'http://usapisandbox.fgdev.net'
       self.live_url = 'https://api.firstgiving.com'

data/lib/active_merchant/billing/gateways/first_pay/first_pay_common.rb

@@ -0,0 +1,15 @@
+module FirstPayCommon
+  def self.included(base)
+    base.supported_countries = ['US']
+    base.default_currency = 'USD'
+    base.money_format = :dollars
+    base.supported_cardtypes = %i[visa master american_express discover]
+
+    base.homepage_url = 'http://1stpaygateway.net/'
+    base.display_name = '1stPayGateway.Net'
+  end
+
+  def supports_scrubbing?
+    true
+  end
+end

data/lib/active_merchant/billing/gateways/first_pay/first_pay_json.rb

@@ -0,0 +1,190 @@
+require 'active_merchant/billing/gateways/first_pay/first_pay_common'
+
+module ActiveMerchant # :nodoc:
+  module Billing # :nodoc:
+    class FirstPayJsonGateway < Gateway
+      include FirstPayCommon
+
+      ACTIONS = {
+        purchase: 'Sale',
+        authorize: 'Auth',
+        capture: 'Settle',
+        refund: 'Refund',
+        void: 'Void'
+      }.freeze
+
+      WALLET_TYPES = {
+        apple_pay: 'ApplePay',
+        google_pay: 'GooglePay'
+      }.freeze
+
+      self.test_url = 'https://secure-v.1stPaygateway.net/secure/RestGW/Gateway/Transaction/'
+      self.live_url = 'https://secure.1stPaygateway.net/secure/RestGW/Gateway/Transaction/'
+
+      # Creates a new FirstPayJsonGateway
+      #
+      # The gateway requires two values for connection to be passed
+      # in the +options+ hash.
+      #
+      # ==== Options
+      #
+      # * <tt>:merchant_key</tt>  -- FirstPay's merchant_key (REQUIRED)
+      # * <tt>:processor_id</tt>  -- FirstPay's processor_id or processorId (REQUIRED)
+      def initialize(options = {})
+        requires!(options, :merchant_key, :processor_id)
+        super
+      end
+
+      def purchase(money, payment, options = {})
+        post = {}
+        add_invoice(post, money, options)
+        add_payment(post, payment, options)
+        add_address(post, payment, options)
+
+        commit(:purchase, post)
+      end
+
+      def authorize(money, payment, options = {})
+        post = {}
+        add_invoice(post, money, options)
+        add_payment(post, payment, options)
+        add_address(post, payment, options)
+
+        commit(:authorize, post)
+      end
+
+      def capture(money, authorization, options = {})
+        post = {}
+        add_invoice(post, money, options)
+        add_reference(post, authorization)
+
+        commit(:capture, post)
+      end
+
+      def refund(money, authorization, options = {})
+        post = {}
+        add_invoice(post, money, options)
+        add_reference(post, authorization)
+
+        commit(:refund, post)
+      end
+
+      def void(authorization, options = {})
+        post = {}
+        add_reference(post, authorization)
+
+        commit(:void, post)
+      end
+
+      def scrub(transcript)
+        transcript.
+          gsub(%r(("processorId\\?"\s*:\s*\\?")[^"]*)i, '\1[FILTERED]').
+          gsub(%r(("merchantKey\\?"\s*:\s*\\?")[^"]*)i, '\1[FILTERED]').
+          gsub(%r(("cardNumber\\?"\s*:\s*\\?")[^"]*)i, '\1[FILTERED]').
+          gsub(%r(("paymentCryptogram\\?"\s*:\s*\\?")[^"]*)i, '\1[FILTERED]').
+          gsub(%r(("cvv\\?"\s*:\s*\\?)[^,]*)i, '\1[FILTERED]')
+      end
+
+      private
+
+      def add_address(post, creditcard, options)
+        if address = options[:billing_address] || options[:address]
+          post[:ownerName] = address[:name]
+          post[:ownerStreet] = address[:address1]
+          post[:ownerCity] = address[:city]
+          post[:ownerState] = address[:state]
+          post[:ownerZip] = address[:zip]
+          post[:ownerCountry] = address[:country]
+        end
+      end
+
+      def add_invoice(post, money, options)
+        post[:orderId] = options[:order_id]
+        post[:transactionAmount] = amount(money)
+      end
+
+      def add_payment(post, payment, options)
+        post[:cardNumber] = payment.number
+        post[:cardExpMonth] = payment.month
+        post[:cardExpYear] = format(payment.year, :two_digits)
+        post[:cvv] = payment.verification_value
+        post[:recurring] = options[:recurring] if options[:recurring]
+        post[:recurringStartDate] = options[:recurring_start_date] if options[:recurring_start_date]
+        post[:recurringEndDate] = options[:recurring_end_date] if options[:recurring_end_date]
+
+        case payment
+        when NetworkTokenizationCreditCard
+          post[:walletType] = WALLET_TYPES[payment.source]
+          other_fields = post[:otherFields] = {}
+          other_fields[:paymentCryptogram] = payment.payment_cryptogram
+          other_fields[:eciIndicator] = payment.eci || '07'
+        when CreditCard
+          post[:cvv] = payment.verification_value
+        end
+      end
+
+      def add_reference(post, authorization)
+        post[:refNumber] = authorization
+      end
+
+      def commit(action, parameters)
+        response = parse(api_request(base_url + ACTIONS[action], post_data(parameters)))
+
+        Response.new(
+          success_from(response),
+          message_from(response),
+          response,
+          authorization: authorization_from(response),
+          error_code: error_code_from(response),
+          test: test?
+        )
+      end
+
+      def base_url
+        test? ? self.test_url : self.live_url
+      end
+
+      def api_request(url, data)
+        ssl_post(url, data, headers)
+      rescue ResponseError => e
+        e.response.body
+      end
+
+      def parse(data)
+        JSON.parse data
+      end
+
+      def headers
+        { 'Content-Type' => 'application/json' }
+      end
+
+      def format_messages(messages)
+        return unless messages.present?
+
+        messages.map { |message| message['message'] || message }.join('; ')
+      end
+
+      def success_from(response)
+        response['isSuccess']
+      end
+
+      def message_from(response)
+        format_messages(response['errorMessages'] + response['validationFailures']) || response['data']['authResponse']
+      end
+
+      def error_code_from(response)
+        return 'isError' if response['isError']
+
+        return 'validationHasFailed' if response['validationHasFailed']
+      end
+
+      def authorization_from(response)
+        response.dig('data', 'referenceNumber') || ''
+      end
+
+      def post_data(params)
+        params.merge({ processorId: @options[:processor_id], merchantKey: @options[:merchant_key] }).to_json
+      end
+    end
+  end
+end