activemerchant 1.79.2 → 1.129.0

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

@@ -1,43 +1,63 @@
 module ActiveMerchant #:nodoc:
   module Billing #:nodoc:
     class KushkiGateway < Gateway
-      self.display_name = "Kushki"
-      self.homepage_url = "https://www.kushkipagos.com"
+      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.test_url = 'https://api-uat.kushkipagos.com/'
+      self.live_url = 'https://api.kushkipagos.com/'
 
-      self.supported_countries = ["CO", "EC"]
-      self.default_currency = "USD"
+      self.supported_countries = %w[CL CO EC MX PE]
+      self.default_currency = 'USD'
       self.money_format = :dollars
-      self.supported_cardtypes = [:visa, :master, :american_express, :discover, :diners_club]
+      self.supported_cardtypes = %i[visa master american_express discover diners_club alia]
 
-      def initialize(options={})
+      def initialize(options = {})
         requires!(options, :public_merchant_id, :private_merchant_id)
         super
       end
 
-      def purchase(amount, payment_method, options={})
+      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"
+      def authorize(amount, payment_method, options = {})
+        MultiResponse.run() do |r|
+          r.process { tokenize(amount, payment_method, options) }
+          r.process { preauthorize(amount, r.authorization, options) }
+        end
+      end
+
+      def capture(amount, authorization, options = {})
+        action = 'capture'
 
         post = {}
         post[:ticketNumber] = authorization
+        add_invoice(action, post, amount, options)
+        add_full_response(post, options)
 
         commit(action, post)
       end
 
-      def void(authorization, options={})
-        action = "void"
+      def refund(amount, authorization, options = {})
+        action = 'refund'
 
         post = {}
         post[:ticketNumber] = authorization
+        add_full_response(post, options)
+
+        commit(action, post)
+      end
+
+      def void(authorization, options = {})
+        action = 'void'
+
+        post = {}
+        post[:ticketNumber] = authorization
+        add_full_response(post, options)
 
         commit(action, post)
       end
@@ -56,27 +76,50 @@ module ActiveMerchant #:nodoc:
       private
 
       def tokenize(amount, payment_method, options)
-        action = "tokenize"
+        action = 'tokenize'
 
         post = {}
         add_invoice(action, post, amount, options)
         add_payment_method(post, payment_method, options)
+        add_full_response(post, options)
+        add_metadata(post, options)
+        add_months(post, options)
+        add_deferred(post, options)
 
         commit(action, post)
       end
 
       def charge(amount, authorization, options)
-        action = "charge"
+        action = 'charge'
 
         post = {}
         add_reference(post, authorization, options)
         add_invoice(action, post, amount, options)
+        add_contact_details(post, options[:contact_details]) if options[:contact_details]
+        add_full_response(post, options)
+        add_metadata(post, options)
+        add_months(post, options)
+        add_deferred(post, options)
+
+        commit(action, post)
+      end
+
+      def preauthorize(amount, authorization, options)
+        action = 'preAuthorization'
+
+        post = {}
+        add_reference(post, authorization, options)
+        add_invoice(action, post, amount, options)
+        add_full_response(post, options)
+        add_metadata(post, options)
+        add_months(post, options)
+        add_deferred(post, options)
 
         commit(action, post)
       end
 
       def add_invoice(action, post, money, options)
-        if action == "tokenize"
+        if action == 'tokenize'
           post[:totalAmount] = amount(money).to_f
           post[:currency] = options[:currency] || currency(money)
           post[:isDeferred] = false
@@ -94,16 +137,7 @@ module ActiveMerchant #:nodoc:
         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
+        sum[:ice] = 0 if sum[:currency] != 'COP'
       end
 
       def add_amount_by_country(sum, options)
@@ -112,7 +146,8 @@ module ActiveMerchant #:nodoc:
           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"
+          if (extra_taxes = amount[:extra_taxes])
+            sum[:extraTaxes] ||= Hash.new
             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]
@@ -135,19 +170,56 @@ module ActiveMerchant #:nodoc:
         post[:token] = authorization
       end
 
+      def add_contact_details(post, contact_details_options)
+        contact_details = {}
+        contact_details[:documentType] = contact_details_options[:document_type] if contact_details_options[:document_type]
+        contact_details[:documentNumber] = contact_details_options[:document_number] if contact_details_options[:document_number]
+        contact_details[:email] = contact_details_options[:email] if contact_details_options[:email]
+        contact_details[:firstName] = contact_details_options[:first_name] if contact_details_options[:first_name]
+        contact_details[:lastName] = contact_details_options[:last_name] if contact_details_options[:last_name]
+        contact_details[:secondLastName] = contact_details_options[:second_last_name] if contact_details_options[:second_last_name]
+        contact_details[:phoneNumber] = contact_details_options[:phone_number] if contact_details_options[:phone_number]
+        post[:contactDetails] = contact_details
+      end
+
+      def add_full_response(post, options)
+        post[:fullResponse] = options[:full_response].to_s.casecmp('true').zero? if options[:full_response]
+      end
+
+      def add_metadata(post, options)
+        post[:metadata] = options[:metadata] if options[:metadata]
+      end
+
+      def add_months(post, options)
+        post[:months] = options[:months] if options[:months]
+      end
+
+      def add_deferred(post, options)
+        return unless options[:deferred_grace_months] && options[:deferred_credit_type] && options[:deferred_months]
+
+        post[:deferred] = {
+          graceMonths: options[:deferred_grace_months],
+          creditType: options[:deferred_credit_type],
+          months: options[:deferred_months]
+        }
+      end
+
       ENDPOINT = {
-        "tokenize" => "tokens",
-        "charge" => "charges",
-        "void" => "charges",
-        "refund" => "refund"
+        'tokenize' => 'tokens',
+        'charge' => 'charges',
+        'void' => 'charges',
+        'refund' => 'refund',
+        'preAuthorization' => 'preAuthorization',
+        'capture' => 'capture'
       }
 
       def commit(action, params)
-        response = begin
-          parse(ssl_invoke(action, params))
-        rescue ResponseError => e
-          parse(e.response.body)
-        end
+        response =
+          begin
+            parse(ssl_invoke(action, params))
+          rescue ResponseError => e
+            parse(e.response.body)
+          end
 
         success = success_from(response)
 
@@ -162,7 +234,7 @@ module ActiveMerchant #:nodoc:
       end
 
       def ssl_invoke(action, params)
-        if ["void", "refund"].include?(action)
+        if %w[void refund].include?(action)
           ssl_request(:delete, url(action, params), nil, headers(action))
         else
           ssl_post(url(action, params), post_data(params), headers(action))
@@ -171,9 +243,9 @@ module ActiveMerchant #:nodoc:
 
       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['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
 
@@ -184,43 +256,41 @@ module ActiveMerchant #:nodoc:
       def url(action, params)
         base_url = test? ? test_url : live_url
 
-        if ["void", "refund"].include?(action)
-          base_url + ENDPOINT[action] + "/" + params[:ticketNumber].to_s
+        if %w[void refund].include?(action)
+          base_url + 'v1/' + ENDPOINT[action] + '/' + params[:ticketNumber].to_s
         else
-          base_url + ENDPOINT[action]
+          base_url + 'card/v1/' + 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
+        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
 
       def success_from(response)
-        return true if response["token"] || response["ticketNumber"] || response["code"] == "K000"
+        return true if response['token'] || response['ticketNumber'] || response['code'] == 'K000'
       end
 
       def message_from(succeeded, response)
         if succeeded
-          "Succeeded"
+          'Succeeded'
         else
-          response["message"]
+          response['message']
         end
       end
 
       def authorization_from(response)
-        response["token"] || response["ticketNumber"]
+        response['token'] || response['ticketNumber']
       end
 
       def error_from(response)
-        response["code"]
+        response['code']
       end
     end
   end