activemerchant 1.62.0 → 1.79.2

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

@@ -0,0 +1,292 @@
+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 = [: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.merge!({ 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.merge!({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.merge!({"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,296 @@
+module ActiveMerchant #:nodoc:
+  module Billing #:nodoc:
+    class EbanxGateway < Gateway
+      self.test_url = 'https://sandbox.ebanx.com/ws/'
+      self.live_url = 'https://api.ebanx.com/ws/'
+
+      self.supported_countries = ['BR', 'MX', 'CO']
+      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] && options[:person_type].downcase == 'business'
+          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