genesis_ruby 0.1.7 → 0.1.9

data/lib/genesis_ruby/api/requests/financial/mobile/apple_pay.rb

@@ -0,0 +1,91 @@
+require 'genesis_ruby/api/constants/transactions/parameters/mobile/apple_pay/payment_subtypes'
+
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module Mobile
+          # Apple Pay transaction request
+          class ApplePay < Requests::Base::Financial
+
+            include Mixins::Requests::AddressInfoAttributes
+            include Mixins::Requests::BirthDateAttributes
+            include Mixins::Requests::DocumentAttributes
+            include Mixins::Requests::Financial::Business::BusinessAttributes
+            include Mixins::Requests::Financial::CryptoAttributes
+            include Mixins::Requests::Financial::DynamicDescriptorAttributes
+            include Mixins::Requests::Financial::Mobile::ApplePayTokenAttributes
+            include Mixins::Requests::Financial::PaymentAttributes
+
+            attr_accessor :payment_subtype
+
+            # Define Payment Token from a JSON string
+            def json_token=(value)
+              json_object = Utils::Common.parse_json_string value
+
+              map_apple_pay_token_attributes json_object
+            end
+
+            protected
+
+            # Apple Pay transaction request type
+            def transaction_type
+              Api::Constants::Transactions::APPLE_PAY
+            end
+
+            def init_field_validations
+              required_fields.push *%i[transaction_id payment_subtype token_version token_data token_signature
+                token_ephemeral_public_key token_public_key_hash token_transaction_id token_display_name token_network
+                token_type token_transaction_identifier amount currency]
+
+              field_values.merge! currency:        Api::Constants::Currencies::Iso4217.all.map(&:upcase),
+                                  payment_subtype: Api::Constants::Transactions::Parameters::Mobile::ApplePay::
+                                      PaymentSubtypes.all
+            end
+
+            # Apple Pay payment transaction structure
+            def payment_transaction_structure # rubocop:disable Metrics/MethodLength
+              payment_attributes_structure.merge(
+                {
+                  payment_subtype:           payment_subtype,
+                  payment_token:             payment_token_structure,
+                  customer_email:            customer_email,
+                  customer_phone:            customer_phone,
+                  birth_date:                birth_date,
+                  billing_address:           billing_address_parameters_structure,
+                  shipping_address:          shipping_address_parameters_structure,
+                  document_id:               document_id,
+                  crypto:                    crypto,
+                  business_attributes:       business_attributes_structure,
+                  dynamic_descriptor_params: dynamic_descriptor_structure
+                }
+              )
+            end
+
+            private
+
+            # Map the Apple Pay Token attributes from the given Hash object
+            def map_apple_pay_token_attributes(json_object)
+              return nil unless json_object.is_a? Hash
+
+              json_object.each do |token_key, token_value|
+                if token_value.is_a? Hash
+                  map_apple_pay_token_attributes token_value
+
+                  next
+                end
+
+                token_method = "token_#{GenesisRuby::Utils::Common.camel_to_snake_case(token_key)}="
+
+                __send__ token_method, token_value if respond_to? token_method
+              end
+
+              nil
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/mobile/google_pay.rb

@@ -0,0 +1,108 @@
+require 'genesis_ruby/api/constants/transactions/parameters/mobile/google_pay/payment_subtypes'
+
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module Mobile
+          # Google Pay transaction request
+          class GooglePay < Requests::Base::Financial
+
+            attr_accessor :payment_subtype
+
+            include Mixins::Requests::AddressInfoAttributes
+            include Mixins::Requests::BirthDateAttributes
+            include Mixins::Requests::DocumentAttributes
+            include Mixins::Requests::Financial::AsyncAttributes
+            include Mixins::Requests::Financial::Business::BusinessAttributes
+            include Mixins::Requests::Financial::DynamicDescriptorAttributes
+            include Mixins::Requests::Financial::Mobile::GooglePayTokenAttributes
+            include Mixins::Requests::Financial::NotificationAttributes
+            include Mixins::Requests::Financial::PaymentAttributes
+            include Mixins::Requests::Financial::Threeds::Version2::CommonAttributes
+
+            # Define a payment token from a JSON string
+            def json_token=(value)
+              json_object = Utils::Common.parse_json_string value
+
+              map_google_pay_token_attributes json_object
+            end
+
+            protected
+
+            # Google Pay transaction request type
+            def transaction_type
+              Constants::Transactions::GOOGLE_PAY
+            end
+
+            # Google Pay Required fields
+            def init_field_validations
+              super
+
+              required_fields.push *%i[transaction_id payment_subtype amount currency token_signature token_signed_key
+                token_signatures token_protocol_version token_signed_message]
+
+              field_values.merge! currency:        Constants::Currencies::Iso4217.all.map(&:upcase),
+                                  payment_subtype: Constants::Transactions::Parameters::Mobile::GooglePay::
+                                      PaymentSubtypes.all
+              field_values.merge! threeds_field_validations
+
+              field_value_dependencies.merge! threeds_field_conditional_validations
+            end
+
+            # Special validations upon document building
+            def check_requirements
+              validate_threeds_card_holder_dates
+
+              super
+            end
+
+            # Google Pay Payment Transaction Structure
+            def payment_transaction_structure # rubocop:disable Metrics/MethodLength
+              payment_attributes_structure.merge(
+                {
+                  payment_subtype:           payment_subtype,
+                  payment_token:             google_pay_token_structure,
+                  customer_email:            customer_email,
+                  customer_phone:            customer_phone,
+                  birth_date:                birth_date,
+                  notification_url:          notification_url,
+                  return_success_url:        return_success_url,
+                  return_failure_url:        return_failure_url,
+                  billing_address:           billing_address_parameters_structure,
+                  shipping_address:          shipping_address_parameters_structure,
+                  business_attributes:       business_attributes_structure,
+                  dynamic_descriptor_params: dynamic_descriptor_structure,
+                  document_id:               document_id,
+                  threeds_v2_params:         threeds_v2_common_attributes_structure
+                }
+              )
+            end
+
+            private
+
+            # Map the Google Pay Token attributes from the given Hash object
+            def map_google_pay_token_attributes(json_object)
+              return nil unless json_object.is_a? Hash
+
+              json_object.each do |token_key, token_value|
+                if token_value.is_a? Hash
+                  map_google_pay_token_attributes token_value
+
+                  next
+                end
+
+                token_method = "token_#{GenesisRuby::Utils::Common.camel_to_snake_case(token_key)}="
+
+                __send__ token_method, token_value if respond_to? token_method
+              end
+
+              nil
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/online_banking_payments/bancomer.rb

@@ -0,0 +1,33 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module OnlineBankingPayments
+          # Bancomer offers two options for payments in Mexico, cash payment and bank transfer
+          class Bancomer < Base::Financials::SouthAmericanPayments
+
+            include Api::Mixins::Requests::Financial::PendingPaymentAttributes
+
+            protected
+
+            # Bancomer transaction type
+            def transaction_type
+              Api::Constants::Transactions::BANCOMER
+            end
+
+            # Allowed billing country for Bancomer transaction request
+            def allowed_billing_countries
+              %w(MX)
+            end
+
+            # Bancomer request structure
+            def payment_transaction_structure
+              super.merge return_pending_url: return_pending_url
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/online_banking_payments/bradesco.rb

@@ -0,0 +1,33 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module OnlineBankingPayments
+          # Bradesco is a payment service in Brazil
+          class Bradesco < Base::Financials::SouthAmericanPayments
+
+            include Api::Mixins::Requests::Financial::PendingPaymentAttributes
+
+            protected
+
+            # Bradesco transaction type
+            def transaction_type
+              Api::Constants::Transactions::BRADESCO
+            end
+
+            # Allowed billing countries for Bradesco transaction type
+            def allowed_billing_countries
+              %w(BR)
+            end
+
+            # Bradesco request structure
+            def payment_transaction_structure
+              super.merge return_pending_url: return_pending_url
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/online_banking_payments/davivienda.rb

@@ -0,0 +1,34 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module OnlineBankingPayments
+          # Davivienda is offering the Bill pay service which is a fast, easy and secure way to pay and manage your
+          # bills online to anyone, anytime in Colombia.
+          class Davivienda < Base::Financials::SouthAmericanPayments
+
+            include Api::Mixins::Requests::Financial::PendingPaymentAttributes
+
+            protected
+
+            # Davivienda transaction type
+            def transaction_type
+              Api::Constants::Transactions::DAVIVIENDA
+            end
+
+            # Allowed billing countries for Davivienda transaction request
+            def allowed_billing_countries
+              %w(CO)
+            end
+
+            # Davivienda payment transaction structure
+            def payment_transaction_structure
+              super.merge return_pending_url: return_pending_url
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/online_banking_payments/itau.rb

@@ -0,0 +1,33 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module OnlineBankingPayments
+          # Itau is a real-time online bank transfer method and a virtual card.
+          class Itau < Base::Financials::SouthAmericanPayments
+
+            include Api::Mixins::Requests::Financial::PendingPaymentAttributes
+
+            protected
+
+            # Itau transaction type
+            def transaction_type
+              Api::Constants::Transactions::ITAU
+            end
+
+            # Allowed billing countries for Itau transaction request
+            def allowed_billing_countries
+              %w(BR)
+            end
+
+            # Itau payment transaction structure
+            def payment_transaction_structure
+              super.merge return_pending_url: return_pending_url
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/online_banking_payments/online_banking/pay_in.rb

@@ -0,0 +1,157 @@
+require 'genesis_ruby/api/constants/transactions/parameters/online_banking/payment_types'
+require 'genesis_ruby/api/constants/transactions/parameters/online_banking/bank_code_currencies'
+
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module OnlineBankingPayments
+          module OnlineBanking
+            # Online Banking PayIn transaction class
+            class PayIn < Base::Financial # rubocop:disable Metrics/ClassLength
+
+              include Api::Mixins::Requests::AddressInfoAttributes
+              include Api::Mixins::Requests::DocumentAttributes
+              include Api::Mixins::Requests::Financial::AsyncAttributes
+              include Api::Mixins::Requests::Financial::OnlineBankingPayments::VirtualPaymentAddressAttributes
+              include Api::Mixins::Requests::Financial::PaymentAttributes
+
+              attr_accessor :user_category, :payment_type, :bank_code, :consumer_reference, :auth_code
+
+              protected
+
+              # Online Banking PayIn transaction type
+              def transaction_type
+                Api::Constants::Transactions::ONLINE_BANKING_PAYIN
+              end
+
+              # Online Banking PayIn field validations
+              def init_field_validations # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+                required_fields.push *%i[transaction_id return_success_url return_failure_url amount currency bank_code]
+
+                field_values.merge! payment_type: Api::Constants::Transactions::Parameters::OnlineBanking::
+                                        PaymentTypes.all,
+                                    currency:     Api::Constants::Transactions::Parameters::OnlineBanking::
+                                        BankCodeCurrencies.all.map(&:upcase),
+                                    bank_code:    Api::Constants::Transactions::Parameters::OnlineBanking::BankCodes.all
+
+                field_value_dependencies.merge!(
+                  {
+                    currency: {
+                      AUD: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('AUD')
+                      },
+                      BRL: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('BRL')
+                      },
+                      CAD: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('CAD')
+                      },
+                      CHF: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('CHF')
+                      },
+                      CNY: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('CNY')
+                      },
+                      CLP: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('CLP')
+                      },
+                      EUR: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('EUR')
+                      },
+                      THB: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('THB')
+                      },
+                      USD: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('USD')
+                      },
+                      MYR: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('MYR')
+                      },
+                      PEN: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('PEN')
+                      },
+                      PYG: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('PYG')
+                      },
+                      IDR: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('IDR')
+                      },
+                      INR: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('INR')
+                      },
+                      MXN: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('MXN')
+                      },
+                      PHP: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('PHP')
+                      },
+                      SGD: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('SGD')
+                      },
+                      UYU: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('UYU')
+                      },
+                      VND: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('VND')
+                      },
+                      PLN: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('PLN')
+                      },
+                      GBP: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('GBP')
+                      }
+                    }
+                  }
+                )
+              end
+
+              # Online Banking PayIn parameters structure
+              def payment_transaction_structure # rubocop:disable Metrics/MethodLength
+                payment_attributes_structure.merge(
+                  {
+                    return_success_url:      return_success_url,
+                    return_failure_url:      return_failure_url,
+                    billing_address:         billing_address_parameters_structure,
+                    shipping_address:        shipping_address_parameters_structure,
+                    customer_email:          customer_email,
+                    customer_phone:          customer_phone,
+                    payment_type:            payment_type,
+                    bank_code:               bank_code,
+                    document_id:             document_id,
+                    user_category:           user_category,
+                    virtual_payment_address: virtual_payment_address,
+                    consumer_reference:      consumer_reference,
+                    auth_code:               auth_code
+                  }
+                )
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/online_banking_payments/pse.rb

@@ -0,0 +1,33 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module OnlineBankingPayments
+          # PSE (Pagos Seguros en Linea) is the preferred alternative payment solution in Colombia.
+          class Pse < Base::Financials::SouthAmericanPayments
+
+            include Api::Mixins::Requests::Financial::PendingPaymentAttributes
+
+            protected
+
+            # PSE (Pagos Seguros en Linea) transaction type
+            def transaction_type
+              Api::Constants::Transactions::PSE
+            end
+
+            # Allowed billing countries for PSE (Pagos Seguros en Linea) transaction request
+            def allowed_billing_countries
+              %w(CO)
+            end
+
+            # PSE (Pagos Seguros en Linea) transaction request structure
+            def payment_transaction_structure
+              super.merge return_pending_url: return_pending_url
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/online_banking_payments/rapi_pago.rb

@@ -0,0 +1,33 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module OnlineBankingPayments
+          # RapiPago from Argentina is an offline payment method used for online purchases
+          class RapiPago < Base::Financials::SouthAmericanPayments
+
+            include Api::Mixins::Requests::Financial::PendingPaymentAttributes
+
+            protected
+
+            # RapiPago transaction type
+            def transaction_type
+              Api::Constants::Transactions::RAPI_PAGO
+            end
+
+            # Allowed billing countries for RapiPago transaction request
+            def allowed_billing_countries
+              %w(AR)
+            end
+
+            # RapiPago transaction request structure
+            def payment_transaction_structure
+              super.merge return_pending_url: return_pending_url
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/online_banking_payments/santander.rb

@@ -0,0 +1,33 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module OnlineBankingPayments
+          # Santander is an online bank transfer for ecommerce purchases
+          class Santander < Base::Financials::SouthAmericanPayments
+
+            include Api::Mixins::Requests::Financial::PendingPaymentAttributes
+
+            protected
+
+            # Santander transaction type
+            def transaction_type
+              Api::Constants::Transactions::SANTANDER
+            end
+
+            # Allowed billing countries for Santander transaction request
+            def allowed_billing_countries
+              %w(AR BR MX CL)
+            end
+
+            # Santander payment transaction structure
+            def payment_transaction_structure
+              super.merge return_pending_url: return_pending_url
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/online_banking_payments/webpay.rb

@@ -0,0 +1,33 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module OnlineBankingPayments
+          # Webpay is a Chilean real-time bank transfer method.
+          class Webpay < Base::Financials::SouthAmericanPayments
+
+            include Api::Mixins::Requests::Financial::PendingPaymentAttributes
+
+            protected
+
+            # Webpay transaction type
+            def transaction_type
+              Api::Constants::Transactions::WEBPAY
+            end
+
+            # Allowed billing countries for Webpay transaction request
+            def allowed_billing_countries
+              %w(CL)
+            end
+
+            # Webpay transaction request structure
+            def payment_transaction_structure
+              super.merge return_pending_url: return_pending_url
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/void.rb

@@ -14,8 +14,8 @@ module GenesisRuby
             Api::Constants::Transactions::VOID
           end
 
-          def init_required_fields
-            self.required_fields = %i[transaction_id reference_id]
+          def init_field_validations
+            required_fields.push *%i[transaction_id reference_id]
           end
 
           # Void transaction request structure