activemerchant 1.42.6 → 1.90.0

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

@@ -0,0 +1,296 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class EbanxGateway < Gateway
+      self.test_url = 'https://sandbox.ebanxpay.com/ws/'
+      self.live_url = 'https://api.ebanxpay.com/ws/'
+
+      self.supported_countries = ['BR', 'MX', 'CO', 'CL', 'AR']
+      self.default_currency = 'USD'
+      self.supported_cardtypes = [:visa, :master, :american_express, :discover, :diners_club]
+
+      self.homepage_url = 'http://www.ebanx.com/'
+      self.display_name = 'EBANX'
+
+      CARD_BRAND = {
+        visa: 'visa',
+        master: 'master_card',
+        american_express: 'amex',
+        discover: 'discover',
+        diners_club: 'diners'
+      }
+
+      URL_MAP = {
+        purchase: 'direct',
+        authorize: 'direct',
+        capture: 'capture',
+        refund: 'refund',
+        void: 'cancel',
+        store: 'token'
+      }
+
+      HTTP_METHOD = {
+        purchase: :post,
+        authorize: :post,
+        capture: :get,
+        refund: :post,
+        void: :get,
+        store: :post
+      }
+
+      def initialize(options={})
+        requires!(options, :integration_key)
+        super
+      end
+
+      def purchase(money, payment, options={})
+        post = { payment: {} }
+        add_integration_key(post)
+        add_operation(post)
+        add_invoice(post, money, options)
+        add_customer_data(post, payment, options)
+        add_card_or_token(post, payment)
+        add_address(post, options)
+        add_customer_responsible_person(post, payment, options)
+
+        commit(:purchase, post)
+      end
+
+      def authorize(money, payment, options={})
+        post = { payment: {} }
+        add_integration_key(post)
+        add_operation(post)
+        add_invoice(post, money, options)
+        add_customer_data(post, payment, options)
+        add_card_or_token(post, payment)
+        add_address(post, options)
+        add_customer_responsible_person(post, payment, options)
+        post[:payment][:creditcard][:auto_capture] = false
+
+        commit(:authorize, post)
+      end
+
+      def capture(money, authorization, options={})
+        post = {}
+        add_integration_key(post)
+        post[:hash] = authorization
+        post[:amount] = amount(money)
+
+        commit(:capture, post)
+      end
+
+      def refund(money, authorization, options={})
+        post = {}
+        add_integration_key(post)
+        add_operation(post)
+        add_authorization(post, authorization)
+        post[:amount] = amount(money)
+        post[:description] = options[:description]
+
+        commit(:refund, post)
+      end
+
+      def void(authorization, options={})
+        post = {}
+        add_integration_key(post)
+        add_authorization(post, authorization)
+
+        commit(:void, post)
+      end
+
+      def store(credit_card, options={})
+        post = {}
+        add_integration_key(post)
+        add_payment_details(post, credit_card)
+        post[:country] = customer_country(options)
+
+        commit(:store, post)
+      end
+
+      def verify(credit_card, options={})
+        MultiResponse.run(:use_first_response) do |r|
+          r.process { authorize(100, credit_card, options) }
+          r.process(:ignore_result) { void(r.authorization, options) }
+        end
+      end
+
+      def supports_scrubbing?
+        true
+      end
+
+      def scrub(transcript)
+        transcript.
+          gsub(/(integration_key\\?":\\?")(\d*)/, '\1[FILTERED]').
+          gsub(/(card_number\\?":\\?")(\d*)/, '\1[FILTERED]').
+          gsub(/(card_cvv\\?":\\?")(\d*)/, '\1[FILTERED]')
+      end
+
+      private
+
+      def add_integration_key(post)
+        post[:integration_key] = @options[:integration_key].to_s
+      end
+
+      def add_operation(post)
+        post[:operation] = 'request'
+      end
+
+      def add_authorization(post, authorization)
+        post[:hash] = authorization
+      end
+
+      def add_customer_data(post, payment, options)
+        post[:payment][:name] = customer_name(payment, options)
+        post[:payment][:email] = options[:email] || 'unspecified@example.com'
+        post[:payment][:document] = options[:document]
+        post[:payment][:birth_date] = options[:birth_date] if options[:birth_date]
+      end
+
+      def add_customer_responsible_person(post, payment, options)
+        post[:payment][:person_type] = options[:person_type] if options[:person_type]
+        if options[:person_type]&.casecmp('business')&.zero?
+          post[:payment][:responsible] = {}
+          post[:payment][:responsible][:name] = options[:responsible_name] if options[:responsible_name]
+          post[:payment][:responsible][:document] = options[:responsible_document] if options[:responsible_document]
+          post[:payment][:responsible][:birth_date] = options[:responsible_birth_date] if options[:responsible_birth_date]
+        end
+      end
+
+      def add_address(post, options)
+        if address = options[:billing_address] || options[:address]
+          post[:payment][:address] = address[:address1].split[1..-1].join(' ') if address[:address1]
+          post[:payment][:street_number] = address[:address1].split.first if address[:address1]
+          post[:payment][:city] = address[:city]
+          post[:payment][:state] = address[:state]
+          post[:payment][:zipcode] = address[:zip]
+          post[:payment][:country] = address[:country].downcase
+          post[:payment][:phone_number] = address[:phone]
+        end
+      end
+
+      def add_invoice(post, money, options)
+        post[:payment][:amount_total] = amount(money)
+        post[:payment][:currency_code] = (options[:currency] || currency(money))
+        post[:payment][:merchant_payment_code] = options[:order_id]
+        post[:payment][:instalments] = options[:instalments] || 1
+      end
+
+      def add_card_or_token(post, payment)
+        if payment.is_a?(String)
+          payment, brand = payment.split('|')
+        end
+        post[:payment][:payment_type_code] = payment.is_a?(String) ? brand : CARD_BRAND[payment.brand.to_sym]
+        post[:payment][:creditcard] = payment_details(payment)
+      end
+
+      def add_payment_details(post, payment)
+        post[:payment_type_code] = CARD_BRAND[payment.brand.to_sym]
+        post[:creditcard] = payment_details(payment)
+      end
+
+      def payment_details(payment)
+        if payment.is_a?(String)
+          { token: payment }
+        else
+          {
+            card_number: payment.number,
+            card_name: payment.name,
+            card_due_date: "#{payment.month}/#{payment.year}",
+            card_cvv: payment.verification_value
+          }
+        end
+      end
+
+      def parse(body)
+        JSON.parse(body)
+      end
+
+      def commit(action, parameters)
+        url = url_for((test? ? test_url : live_url), action, parameters)
+        response = parse(ssl_request(HTTP_METHOD[action], url, post_data(action, parameters), {}))
+
+        success = success_from(action, response)
+
+        Response.new(
+          success,
+          message_from(response),
+          response,
+          authorization: authorization_from(action, parameters, response),
+          test: test?,
+          error_code: error_code_from(response, success)
+        )
+      end
+
+      def success_from(action, response)
+        if [:purchase, :capture, :refund].include?(action)
+          response.try(:[], 'payment').try(:[], 'status') == 'CO'
+        elsif action == :authorize
+          response.try(:[], 'payment').try(:[], 'status') == 'PE'
+        elsif action == :void
+          response.try(:[], 'payment').try(:[], 'status') == 'CA'
+        elsif action == :store
+          response.try(:[], 'status') == 'SUCCESS'
+        else
+          false
+        end
+      end
+
+      def message_from(response)
+        return response['status_message'] if response['status'] == 'ERROR'
+        response.try(:[], 'payment').try(:[], 'transaction_status').try(:[], 'description')
+      end
+
+      def authorization_from(action, parameters, response)
+        if action == :store
+          "#{response.try(:[], "token")}|#{CARD_BRAND[parameters[:payment_type_code].to_sym]}"
+        else
+          response.try(:[], 'payment').try(:[], 'hash')
+        end
+      end
+
+      def post_data(action, parameters = {})
+        return nil if requires_http_get(action)
+        return convert_to_url_form_encoded(parameters) if action == :refund
+        "request_body=#{parameters.to_json}"
+      end
+
+      def url_for(hostname, action, parameters)
+        return "#{hostname}#{URL_MAP[action]}?#{convert_to_url_form_encoded(parameters)}" if requires_http_get(action)
+        "#{hostname}#{URL_MAP[action]}"
+      end
+
+      def requires_http_get(action)
+        return true if [:capture, :void].include?(action)
+        false
+      end
+
+      def convert_to_url_form_encoded(parameters)
+        parameters.map do |key, value|
+          next if value != false && value.blank?
+          "#{key}=#{value}"
+        end.compact.join('&')
+      end
+
+      def error_code_from(response, success)
+        unless success
+          return response['status_code'] if response['status'] == 'ERROR'
+          response.try(:[], 'payment').try(:[], 'transaction_status').try(:[], 'code')
+        end
+      end
+
+      def customer_country(options)
+        if country = options[:country] || (options[:billing_address][:country] if options[:billing_address])
+          country.downcase
+        end
+      end
+
+      def customer_name(payment, options)
+        address_name = options[:billing_address][:name] if options[:billing_address] && options[:billing_address][:name]
+        if payment.is_a?(String)
+          address_name || 'Not Provided'
+        else
+          payment.name
+        end
+      end
+    end
+  end
+end

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

@@ -2,7 +2,6 @@ require 'rexml/document'
 
 module ActiveMerchant #:nodoc:
   module Billing #:nodoc:
-
     class EfsnetGateway < Gateway
       self.supported_countries = ['US']
       self.supported_cardtypes = [:visa, :master, :american_express, :discover]
@@ -36,7 +35,7 @@ module ActiveMerchant #:nodoc:
 
       def credit(money, identification_or_credit_card, options = {})
         if identification_or_credit_card.is_a?(String)
-          deprecated CREDIT_DEPRECATION_MESSAGE
+          ActiveMerchant.deprecated CREDIT_DEPRECATION_MESSAGE
           # Perform authorization reversal
           refund(money, identification_or_credit_card, options)
         else
@@ -54,7 +53,7 @@ module ActiveMerchant #:nodoc:
 
       def void(identification, options = {})
         requires!(options, :order_id)
-        original_transaction_id, original_transaction_amount = identification.split(";")
+        original_transaction_id, _ = identification.split(';')
         commit(:void_transaction, {:reference_number => format_reference_number(options[:order_id]), :transaction_id => original_transaction_id})
       end
 
@@ -77,11 +76,11 @@ module ActiveMerchant #:nodoc:
       private
 
       def build_refund_or_settle_request(money, identification, options = {})
-        original_transaction_id, original_transaction_amount = identification.split(";")
+        original_transaction_id, original_transaction_amount = identification.split(';')
 
         requires!(options, :order_id)
 
-        post = {
+        {
           :reference_number => format_reference_number(options[:order_id]),
           :transaction_amount => amount(money),
           :original_transaction_amount => original_transaction_amount,
@@ -100,16 +99,16 @@ module ActiveMerchant #:nodoc:
           :client_ip_address => options[:ip]
 
         }
-        add_creditcard(post,creditcard)
-        add_address(post,options)
+        add_creditcard(post, creditcard)
+        add_address(post, options)
         post
       end
 
       def format_reference_number(number)
-        number.to_s.slice(0,12)
+        number.to_s.slice(0, 12)
       end
 
-      def add_address(post,options)
+      def add_address(post, options)
         if address = options[:billing_address] || options[:address]
           if address[:address2]
             post[:billing_address]    = address[:address1].to_s << ' ' <<  address[:address2].to_s
@@ -139,11 +138,10 @@ module ActiveMerchant #:nodoc:
         post[:billing_name]  = creditcard.name if creditcard.name
         post[:account_number]  = creditcard.number
         post[:card_verification_value] = creditcard.verification_value if creditcard.verification_value?
-        post[:expiration_month]  = sprintf("%.2i", creditcard.month)
-        post[:expiration_year]  = sprintf("%.4i", creditcard.year)[-2..-1]
+        post[:expiration_month]  = sprintf('%.2i', creditcard.month)
+        post[:expiration_year]  = sprintf('%.4i', creditcard.year)[-2..-1]
       end
 
-
       def commit(action, parameters)
         response = parse(ssl_post(test? ? self.test_url : self.live_url, post_data(action, parameters), 'Content-Type' => 'text/xml'))
 
@@ -169,9 +167,7 @@ module ActiveMerchant #:nodoc:
         xml = REXML::Document.new(xml)
 
         xml.elements.each('//Reply//TransactionReply/*') do |node|
-
           response[node.name.underscore.to_sym] = normalize(node.text)
-
         end unless xml.root.nil?
 
         response
@@ -179,10 +175,10 @@ module ActiveMerchant #:nodoc:
 
       def post_data(action, parameters = {})
         xml   = REXML::Document.new("<?xml version='1.0' encoding='UTF-8'?>")
-        root  = xml.add_element("Request")
-        root.attributes["StoreID"] = options[:login]
-        root.attributes["StoreKey"] = options[:password]
-        root.attributes["ApplicationID"] = 'ot 1.0'
+        root  = xml.add_element('Request')
+        root.attributes['StoreID'] = options[:login]
+        root.attributes['StoreKey'] = options[:password]
+        root.attributes['ApplicationID'] = 'ot 1.0'
         transaction = root.add_element(action.to_s.camelize)
 
         actions[action].each do |key|
@@ -194,18 +190,7 @@ module ActiveMerchant #:nodoc:
 
       def message_from(message)
         return 'Unspecified error' if message.blank?
-        message.gsub(/[^\w]/, ' ').split.join(" ").capitalize
-      end
-
-      # Make a ruby type out of the response string
-      def normalize(field)
-        case field
-        when "true"   then true
-        when "false"  then false
-        when ""       then nil
-        when "null"   then nil
-        else field
-        end
+        message.gsub(/[^\w]/, ' ').split.join(' ').capitalize
       end
 
       def actions
@@ -215,15 +200,15 @@ module ActiveMerchant #:nodoc:
       CREDIT_CARD_FIELDS =  %w(AuthorizationNumber ClientIpAddress BillingAddress BillingCity BillingState BillingPostalCode BillingCountry BillingName CardVerificationValue ExpirationMonth ExpirationYear ReferenceNumber TransactionAmount AccountNumber )
 
       ACTIONS = {
-           :credit_card_authorize		=> CREDIT_CARD_FIELDS,
-           :credit_card_charge			=> CREDIT_CARD_FIELDS,
-           :credit_card_voice_authorize		=> CREDIT_CARD_FIELDS,
-           :credit_card_capture			=> CREDIT_CARD_FIELDS,
-           :credit_card_credit			=> CREDIT_CARD_FIELDS + ["OriginalTransactionAmount"],
-           :credit_card_refund			=> %w(ReferenceNumber TransactionAmount OriginalTransactionAmount OriginalTransactionID ClientIpAddress),
-           :void_transaction			=> %w(ReferenceNumber TransactionID),
-           :credit_card_settle			=> %w(ReferenceNumber TransactionAmount OriginalTransactionAmount OriginalTransactionID ClientIpAddress),
-           :system_check			=> %w(SystemCheck),
+           :credit_card_authorize       => CREDIT_CARD_FIELDS,
+           :credit_card_charge          => CREDIT_CARD_FIELDS,
+           :credit_card_voice_authorize => CREDIT_CARD_FIELDS,
+           :credit_card_capture         => CREDIT_CARD_FIELDS,
+           :credit_card_credit          => CREDIT_CARD_FIELDS + ['OriginalTransactionAmount'],
+           :credit_card_refund          => %w(ReferenceNumber TransactionAmount OriginalTransactionAmount OriginalTransactionID ClientIpAddress),
+           :void_transaction            => %w(ReferenceNumber TransactionID),
+           :credit_card_settle          => %w(ReferenceNumber TransactionAmount OriginalTransactionAmount OriginalTransactionID ClientIpAddress),
+           :system_check                => %w(SystemCheck),
       }
     end
   end