archetype2142_activemerchant 1.124.0

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

@@ -0,0 +1,295 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class DigitzsGateway < Gateway
+      include Empty
+
+      self.test_url = 'https://beta.digitzsapi.com/sandbox'
+      self.live_url = 'https://beta.digitzsapi.com/v3'
+
+      self.supported_countries = ['US']
+      self.default_currency = 'USD'
+      self.supported_cardtypes = %i[visa master american_express discover]
+      self.money_format = :cents
+
+      self.homepage_url = 'https://digitzs.com'
+      self.display_name = 'Digitzs'
+
+      def initialize(options = {})
+        requires!(options, :app_key, :api_key)
+        super
+      end
+
+      def purchase(money, payment, options = {})
+        MultiResponse.run do |r|
+          r.process { commit('auth/token', app_token_request(options)) }
+          r.process { commit('payments', purchase_request(money, payment, options), options.merge({ app_token: app_token_from(r) })) }
+        end
+      end
+
+      def refund(money, authorization, options = {})
+        MultiResponse.run do |r|
+          r.process { commit('auth/token', app_token_request(options)) }
+          r.process { commit('payments', refund_request(money, authorization, options), options.merge({ app_token: app_token_from(r) })) }
+        end
+      end
+
+      def store(payment, options = {})
+        MultiResponse.run do |r|
+          r.process { commit('auth/token', app_token_request(options)) }
+          options[:app_token] = app_token_from(r)
+
+          if options[:customer_id].present?
+            customer_id = check_customer_exists(options)
+
+            if customer_id
+              r.process { add_credit_card_to_customer(payment, options) }
+            else
+              r.process { add_customer_with_credit_card(payment, options) }
+            end
+          else
+            r.process { add_customer_with_credit_card(payment, options) }
+          end
+        end
+      end
+
+      def supports_scrubbing?
+        true
+      end
+
+      def scrub(transcript)
+        transcript.
+          gsub(%r((Authorization: Bearer ).+), '\1[FILTERED]').
+          gsub(%r((X-Api-Key: )\w+), '\1[FILTERED]').
+          gsub(%r((\"id\\\":\\\").+), '\1[FILTERED]').
+          gsub(%r((\"appKey\\\":\\\").+), '\1[FILTERED]').
+          gsub(%r((\"appToken\\\":\\\").+), '\1[FILTERED]').
+          gsub(%r((\"code\\\":\\\")\d+), '\1[FILTERED]').
+          gsub(%r((\"number\\\":\\\")\d+), '\1[FILTERED]')
+      end
+
+      private
+
+      def new_post
+        {
+          data: {
+            attributes: {}
+          }
+        }
+      end
+
+      def add_split(post, options)
+        return unless options[:payment_type] == 'card_split' || options[:payment_type] == 'token_split'
+
+        post[:data][:attributes][:split] = {
+          merchantId: options[:split_merchant_id],
+          amount: amount(options[:split_amount])
+        }
+      end
+
+      def add_payment(post, payment, options)
+        if payment.is_a? String
+          customer_id, token = split_authorization(payment)
+          post[:data][:attributes][:token] = {
+            customerId: customer_id,
+            tokenId: token
+          }
+        else
+          post[:data][:attributes][:card] = {
+            type: payment.brand,
+            holder: payment.name,
+            number: payment.number,
+            expiry: expdate(payment),
+            code: payment.verification_value
+          }
+        end
+      end
+
+      def add_transaction(post, money, options)
+        post[:data][:attributes][:transaction] = {
+          amount: amount(money),
+          currency: (options[:currency] || currency(money)),
+          invoice: options[:order_id] || generate_unique_id
+        }
+      end
+
+      def add_address(post, options)
+        if address = options[:billing_address] || options[:address]
+          post[:data][:attributes][:billingAddress] = {
+            line1: address[:address1] || '',
+            line2: address[:address2] || '',
+            city: address[:city] || '',
+            state: address[:state] || '',
+            zip: address[:zip] || '',
+            country: address['country'] || 'USA'
+          }
+        end
+      end
+
+      def app_token_request(options)
+        post = new_post
+        post[:data][:type] = 'auth'
+        post[:data][:attributes] = { appKey: @options[:app_key] }
+
+        post
+      end
+
+      def purchase_request(money, payment, options)
+        post = new_post
+        post[:data][:type] = 'payments'
+        post[:data][:attributes][:merchantId] = options[:merchant_id]
+        post[:data][:attributes][:paymentType] = determine_payment_type(payment, options)
+        add_split(post, options)
+        add_payment(post, payment, options)
+        add_transaction(post, money, options)
+        add_address(post, options)
+
+        post
+      end
+
+      def refund_request(money, authorization, options)
+        post = new_post
+        post[:data][:type] = 'payments'
+        post[:data][:attributes][:merchantId] = options[:merchant_id]
+        post[:data][:attributes][:paymentType] = 'cardRefund'
+        post[:data][:attributes][:originalTransaction] = { id: authorization }
+        add_transaction(post, money, options)
+
+        post
+      end
+
+      def create_customer_request(payment, options)
+        post = new_post
+        post[:data][:type] = 'customers'
+        post[:data][:attributes] = {
+          merchantId: options[:merchant_id],
+          name: payment.name,
+          externalId: SecureRandom.hex(16)
+        }
+
+        post
+      end
+
+      def create_token_request(payment, options)
+        post = new_post
+        post[:data][:type] = 'tokens'
+        post[:data][:attributes] = {
+          tokenType: 'card',
+          customerId: options[:customer_id],
+          label: 'Credit Card'
+        }
+        add_payment(post, payment, options)
+        add_address(post, options)
+
+        post
+      end
+
+      def check_customer_exists(options = {})
+        url = (test? ? test_url : live_url)
+        response = parse(ssl_get(url + "/customers/#{options[:customer_id]}", headers(options)))
+
+        return response.try(:[], 'data').try(:[], 'customerId') if success_from(response)
+
+        return nil
+      end
+
+      def add_credit_card_to_customer(payment, options = {})
+        commit('tokens', create_token_request(payment, options), options)
+      end
+
+      def add_customer_with_credit_card(payment, options = {})
+        customer_response = commit('customers', create_customer_request(payment, options), options)
+        options[:customer_id] = customer_response.authorization
+        commit('tokens', create_token_request(payment, options), options)
+      end
+
+      def parse(body)
+        JSON.parse(body)
+      end
+
+      def commit(action, parameters, options = {})
+        url = (test? ? test_url : live_url)
+        response = parse(ssl_post(url + "/#{action}", parameters.to_json, headers(options)))
+
+        Response.new(
+          success_from(response),
+          message_from(response),
+          response,
+          authorization: authorization_from(response),
+          avs_result: AVSResult.new(code: avs_result_from(response)),
+          cvv_result: CVVResult.new(cvv_result_from(response)),
+          test: test?,
+          error_code: error_code_from(response)
+        )
+      end
+
+      def success_from(response)
+        response['errors'].nil? && response['message'].nil?
+      end
+
+      def message_from(response)
+        return response['message'] if response['message']
+        return 'Success' if success_from(response)
+
+        response['errors'].map { |error_hash| error_hash['detail'] }.join(', ')
+      end
+
+      def authorization_from(response)
+        if customer_id = response.try(:[], 'data').try(:[], 'attributes').try(:[], 'customerId')
+          "#{customer_id}|#{response.try(:[], 'data').try(:[], 'id')}"
+        else
+          response.try(:[], 'data').try(:[], 'id')
+        end
+      end
+
+      def avs_result_from(response)
+        response.try(:[], 'data').try(:[], 'attributes').try(:[], 'transaction').try(:[], 'avsResult')
+      end
+
+      def cvv_result_from(response)
+        response.try(:[], 'data').try(:[], 'attributes').try(:[], 'transaction').try(:[], 'codeResult')
+      end
+
+      def app_token_from(response)
+        response.params.try(:[], 'data').try(:[], 'attributes').try(:[], 'appToken')
+      end
+
+      def headers(options)
+        headers = {
+          'Content-Type' => 'application/json',
+          'x-api-key' => @options[:api_key]
+        }
+
+        headers['Authorization'] = "Bearer #{options[:app_token]}" if options[:app_token]
+        headers
+      end
+
+      def error_code_from(response)
+        unless success_from(response)
+          response['errors'].nil? ? response['message'] : response['errors'].map { |error_hash| error_hash['code'] }.join(', ')
+        end
+      end
+
+      def split_authorization(authorization)
+        customer_id, token = authorization.split('|')
+        [customer_id, token]
+      end
+
+      def determine_payment_type(payment, options)
+        return 'cardSplit' if options[:payment_type] == 'card_split'
+        return 'tokenSplit' if options[:payment_type] == 'token_split'
+        return 'token' if payment.is_a? String
+
+        'card'
+      end
+
+      def handle_response(response)
+        case response.code.to_i
+        when 200..499
+          response.body
+        else
+          raise ResponseError.new(response)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,333 @@
+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 = %w(BR MX CO CL AR PE)
+      self.default_currency = 'USD'
+      self.supported_cardtypes = %i[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
+      }
+
+      VERIFY_AMOUNT_PER_COUNTRY = {
+        'br' => 100,
+        'ar' => 100,
+        'co' => 100,
+        'pe' => 300,
+        'mx' => 300,
+        'cl' => 5000
+      }
+
+      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)
+        add_additional_data(post, 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)
+        add_additional_data(post, 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) if options[:include_capture_amount].to_s == 'true'
+
+        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(VERIFY_AMOUNT_PER_COUNTRY[customer_country(options)], 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\\?":\\?")(\w*)/, '\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] = Digest::MD5.hexdigest(options[:order_id])
+        post[:payment][:instalments] = options[:instalments] || 1
+      end
+
+      def add_card_or_token(post, payment)
+        payment, brand = payment.split('|') if payment.is_a?(String)
+        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 add_additional_data(post, options)
+        post[:device_id] = options[:device_id] if options[:device_id]
+        post[:metadata] = options[:metadata] if options[:metadata]
+        post[:metadata] = {} if post[:metadata].nil?
+        post[:metadata][:merchant_payment_code] = options[:order_id] if options[:order_id]
+        post[:processing_type] = options[:processing_type] if options[:processing_type]
+      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), headers(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 headers(params)
+        processing_type = params[:processing_type]
+        commit_headers = { 'x-ebanx-client-user-agent': "ActiveMerchant/#{ActiveMerchant::VERSION}" }
+
+        add_processing_type_to_commit_headers(commit_headers, processing_type) if processing_type == 'local'
+
+        commit_headers
+      end
+
+      def add_processing_type_to_commit_headers(commit_headers, processing_type)
+        commit_headers['x-ebanx-api-processing-type'] = processing_type
+      end
+
+      def success_from(action, response)
+        if %i[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 %i[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