genesis_ruby 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d5d3d0e9a97a91f74ce48b4e8607d40362b6c1b7559480aaa8c6996a64077215
-  data.tar.gz: 156b75a8de3262f3cea5587b2f149307aada10b25c53b3e9710f1ccc8b8374db
+  metadata.gz: f29c5f143d903c4fb42a353861744b184de9a7d48dd8788e7ed53baedc11849a
+  data.tar.gz: 824210216d4e2f029faf1e8f1896d8c03ad28c4b79f8d7bdd647e73f169175a3
 SHA512:
-  metadata.gz: ee6d13886cf45ec36864c50dd6ce6f2803818bd990bbdccb9e25bd8209b96ed8b3885fd66d770a01e77105162cfec84c3a8b144ccdac5baf95d574aa608f1f51
-  data.tar.gz: 22b62855963c557566a2bf95e439f337234fd0039d182e7903f3bb89ff03b8947902cd6526643c2c5aa138c2f38f7294617ce2c1a74d3d364e4cab115f14a153
+  metadata.gz: a403425c5236e42412d7e103272a1a4895211e3ea5594f27396fdb330d1cef7d538807da4f08fcd9872f3edfd98fa836b30199d3c45080cce12579062c7d00b2
+  data.tar.gz: 8ea6cf3090a5346a6bdbf760d3ed91908e2b7bb609b050e66a5904b6f965b21defe9b0878cb4bea92772cb70447e5b80003547dcc8b1d9a8556eabc5ac3f8d79

data/CHANGELOG.md

@@ -1,3 +1,18 @@
+0.2.1
+-----
+**Features**:
+
+* Added Online Banking PayOut transaction request
+* Added Funding Parameters support to Google Pay and Apple Pay transaction requests
+* Added Bancontact transaction request support
+* Added Cash transaction request support
+* Added COF and UCOF parameters support to the following transaction requests:
+  * Authorize
+  * Authorize 3D
+  * Sale
+  * Sale 3D
+* Added Tokenized e-commerce payment support
+
 0.2.0
 -----
 **Features**:

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    genesis_ruby (0.2.0)
+    genesis_ruby (0.2.1)
       net-http (~> 0.3.2)
       nokogiri (~> 1.14)
 
@@ -41,13 +41,13 @@ GEM
     json (2.7.2)
     language_server-protocol (3.17.0.3)
     mini_mime (1.1.5)
-    mini_portile2 (2.8.7)
+    mini_portile2 (2.8.8)
     multi_xml (0.6.0)
     mustermann (3.0.3)
       ruby2_keywords (~> 0.0.1)
     net-http (0.3.2)
       uri
-    nokogiri (1.15.6)
+    nokogiri (1.15.7)
       mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
     octokit (7.2.0)
@@ -135,7 +135,7 @@ GEM
     thor (1.3.2)
     tilt (2.4.0)
     unicode-display_width (2.6.0)
-    uri (1.0.1)
+    uri (1.0.3)
     webmock (3.24.0)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)

data/README.md

@@ -996,6 +996,7 @@ GenesisRuby::Api::Requests::Financial::Cards::Argencard
 GenesisRuby::Api::Requests::Financial::Cards::Aura
 GenesisRuby::Api::Requests::Financial::Cards::Authorize
 GenesisRuby::Api::Requests::Financial::Cards::Authorize3d
+GenesisRuby::Api::Requests::Financial::Cards::Bancontact
 GenesisRuby::Api::Requests::Financial::Cards::Cabal
 GenesisRuby::Api::Requests::Financial::Cards::Cencosud
 GenesisRuby::Api::Requests::Financial::Cards::Elo
@@ -1016,6 +1017,7 @@ GenesisRuby::Api::Requests::Financial::Wallets::PayPal
 GenesisRuby::Api::Requests::Financial::CashPayments::Baloto
 GenesisRuby::Api::Requests::Financial::CashPayments::BancoDeOccidente
 GenesisRuby::Api::Requests::Financial::CashPayments::Boleto
+GenesisRuby::Api::Requests::Financial::CashPayments::Cash
 GenesisRuby::Api::Requests::Financial::CashPayments::Efecty
 GenesisRuby::Api::Requests::Financial::CashPayments::Oxxo
 GenesisRuby::Api::Requests::Financial::CashPayments::PagoFacil
@@ -1039,6 +1041,8 @@ GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::Santander
 GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::Webpay
 # PayIn
 GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::OnlineBanking::PayIn
+# PayOut
+GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::OnlineBanking::PayOut
 
 # References
 GenesisRuby::Api::Requests::Financial::Capture

data/VERSION

@@ -1 +1 @@
-0.2.0
+0.2.1

data/lib/genesis_ruby/api/constants/date_time_formats.rb

@@ -24,6 +24,9 @@ module GenesisRuby
         # Date Format ISO 8601
         YYYY_MM_DD_ISO_8601   = '%Y-%m-%d'.freeze
 
+        # Date Format
+        MM_DD                 = '%m%d'.freeze
+
         class << self
 
           def all
@@ -33,6 +36,7 @@ module GenesisRuby
               DD_MM_YYYY_L_SLASHES,
               YYYY_MM_DD_H_I_S_ZULU,
               YYYY_MM_DD_H_I_S,
+              MM_DD,
               YYYY_MM_DD_ISO_8601 # Always keep it last!!!
             ]
           end

data/lib/genesis_ruby/api/constants/transactions/parameters/cash_payments/cash_payment_types.rb

@@ -0,0 +1,36 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module CashPayments
+            # Cash Payment Types allowed values
+            class CashPaymentTypes
+
+              extend Mixins::Constants::Common
+
+              # 7 Eleven
+              SEVEN_ELEVEN             = 'seven_eleven'.freeze
+
+              # Bancomer
+              BANCOMER                 = 'bancomer'.freeze
+
+              # Farmacias del Dr. Ahorro
+              PHARMACIES_DEL_DR_AHORRO = 'pharmacies_del_dr_ahorro'.freeze
+
+              # Farmacias Santa Maria
+              PHARMACIES_SANTA_MARIA   = 'pharmacies_santa_maria'.freeze
+
+              # OXXO
+              OXXO                     = 'oxxo'.freeze
+
+              # Scotiabank
+              SCOTIABANK               = 'scotiabank'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/credential_on_files.rb

@@ -0,0 +1,29 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          # Credential On Files allowed values
+          class CredentialOnFiles
+
+            extend Mixins::Constants::Common
+
+            # Initial transaction used to store payment credentials for future customer initiated payments while
+            # processing. Required for external tokenization, and optional for gateway-based tokenization
+            INITIAL_CUSTOMER_INITIATED    = 'initial_customer_initiated'.freeze
+
+            # Subsequent customer initiated transaction using previously stored payment credentials.
+            # Required for external tokenization, and optional for gateway-based tokenization
+            SUBSEQUENT_CUSTOMER_INITIATED = 'subsequent_customer_initiated'.freeze
+
+            # For UCOF transaction, the scheme transaction identifier of the initial transaction must be sent in
+            # the transaction request. For MasterCard or Maestro UCOF, the scheme settlement date in MMDD format
+            # (e.g. 0107) of the initial transaction must be sent in the transaction request.
+            MERCHANT_UNSCHEDULED          = 'merchant_unscheduled'.freeze
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/online_banking/bank_account_types.rb

@@ -0,0 +1,30 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module OnlineBanking
+            # Bank Payout Account Types allowed values
+            class BankAccountTypes
+
+              extend Mixins::Constants::Common
+
+              # Checking accounts
+              CHECKING = 'C'.freeze
+
+              # Savings accounts
+              SAVINGS  = 'S'.freeze
+
+              # Maestra accounts(Only Peru)
+              MAESTRA  = 'M'.freeze
+
+              # Payment accounts
+              PAYMENT  = 'P'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/online_banking/payout_payment_types.rb

@@ -0,0 +1,42 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module OnlineBanking
+            # Bank Payout Payment Types allowed values
+            class PayoutPaymentTypes
+
+              extend Api::Mixins::Constants::Common
+
+              # Bank to Bank
+              BANK_TO_BANK     = 'bank_to_bank'.freeze
+
+              # PIX
+              PIX              = 'pix'.freeze
+
+              # BSB
+              BSB              = 'bsb'.freeze
+
+              # Pay ID
+              PAY_ID           = 'pay_id'.freeze
+
+              # Bank to Bank, Business to Business
+              BANK_TO_BANK_B2B = 'bank_to_bank_b2b'.freeze
+
+              # PIX Business to Business
+              PIX_B2B          = 'pix_b2b'.freeze
+
+              # Clabe
+              CLABE            = 'clabe'.freeze
+
+              # Cellphone
+              CELLPHONE        = 'cellphone'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions.rb

@@ -79,6 +79,10 @@ module GenesisRuby
         # Capture settles a transaction which has been authorized before.
         CAPTURE = 'capture'.freeze
 
+        # Cash payment methods allow customers to pay bills and online purchases in cash at convenient
+        # physical locations such as stores, banks, ATMs, even pharmacies in some countries.
+        CASH = 'cash'.freeze
+
         # Voucher-based payment
         CASHU = 'cashu'.freeze
 

data/lib/genesis_ruby/api/mixins/requests/financial/cards/credential_on_file_attributes.rb

@@ -0,0 +1,29 @@
+require 'genesis_ruby/api/constants/transactions/parameters/credential_on_files'
+
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          module Cards
+            # Credential On File shared attributes mixin
+            module CredentialOnFileAttributes
+
+              attr_accessor :credential_on_file
+
+              protected
+
+              # Credential on file allowed field values validations
+              def credential_on_file_field_validations
+                {
+                  credential_on_file: Api::Constants::Transactions::Parameters::CredentialOnFiles.all
+                }
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/financial/cards/mpi_attributes.rb

@@ -55,6 +55,16 @@ module GenesisRuby
                 }
               end
 
+              # Field value dependencies for MPI parameters
+              def mpi_attributes_field_dependencies
+                {
+                  mpi_protocol_version: Hash[
+                    Api::Constants::Transactions::Parameters::MpiProtocolVersions::PROTOCOL_VERSION_2,
+                    %w(mpi_directory_server_id)
+                  ]
+                }
+              end
+
             end
           end
         end

data/lib/genesis_ruby/api/mixins/requests/financial/cards/ucof_attributes.rb

@@ -0,0 +1,33 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          module Cards
+            # UCOF shared attributes mixin
+            module UcofAttributes
+
+              attr_reader :credential_on_file_transaction_identifier
+
+              # UCOF Transaction Identifier
+              def credential_on_file_transaction_identifier=(value)
+                limited_string attribute: __method__, value: value.to_s, min: 15, max: 32
+              end
+
+              # UCOF Settlement Date
+              def credential_on_file_settlement_date
+                @credential_on_file_settlement_date&.strftime Api::Constants::DateTimeFormats::MM_DD
+              end
+
+              # UCOF Settlement Date
+              def credential_on_file_settlement_date=(value)
+                parse_date attribute: __method__, value: value, allow_empty: true
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/financial/online_banking_payments/pix_attributes.rb

@@ -0,0 +1,28 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          module OnlineBankingPayments
+            # PIX shared attributes
+            module PixAttributes
+
+              attr_accessor :company_type, :company_activity, :mothers_name
+
+              # Incorporation Date Accessor
+              def incorporation_date
+                @incorporation_date&.strftime GenesisRuby::Api::Constants::DateTimeFormats::YYYY_MM_DD_ISO_8601
+              end
+
+              # Incorporation Date Accessor
+              def incorporation_date=(value)
+                parse_date attribute: __method__, value: value, allow_empty: true
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/base/financials/credit_card.rb

@@ -7,23 +7,46 @@ module GenesisRuby
           class CreditCard < GenesisRuby::Api::Requests::Base::Financial
 
             include Mixins::Requests::Financial::Cards::AccountOwnerAttributes
+            include Mixins::Requests::Financial::Cards::CredentialOnFileAttributes
             include Mixins::Requests::Financial::Cards::CreditCardAttributes
             include Mixins::Requests::Financial::Cards::TokenizationAttributes
+            include Mixins::Requests::Financial::Cards::UcofAttributes
             include Mixins::Requests::Financial::PaymentAttributes
 
+            attr_reader :scheme_tokenized
+
+            # Visa tokenization for Visa
+            # Digital Secure Remote Payments (DSRP) for Mastercard.
+            def scheme_tokenized=(value)
+              allowed_options attribute:      __method__,
+                              allowed:        [true, false],
+                              value:          value,
+                              allow_empty:    true,
+                              error_message: 'Accepts only boolean values'
+            end
+
             protected
 
             # Request Field validations
             def init_field_validations
               required_fields.push *%i[transaction_id amount currency]
-              field_values.merge! currency: Api::Constants::Currencies::Iso4217.all.map(&:upcase)
+              field_values.merge!(
+                { currency: Api::Constants::Currencies::Iso4217.all.map(&:upcase) },
+                credential_on_file_field_validations
+              )
             end
 
             # Credit Card attributes
             def payment_transaction_structure
               payment_attributes_structure.merge(
                 credit_card_attributes_structure, tokenization_attributes_structure,
-                { account_owner: account_owner_attributes_structure }
+                {
+                  account_owner:                             account_owner_attributes_structure,
+                  credential_on_file:                        credential_on_file,
+                  credential_on_file_transaction_identifier: credential_on_file_transaction_identifier,
+                  credential_on_file_settlement_date:        credential_on_file_settlement_date,
+                  scheme_tokenized:                          scheme_tokenized
+                }
               )
             end
 

data/lib/genesis_ruby/api/requests/financial/cards/authorize3d.rb

@@ -46,12 +46,14 @@ module GenesisRuby
 
               field_value_dependencies.merge! required_tokenization_fields_conditional, required_cc_fields_conditional,
                                               required_recurring_managed_type_field_conditional,
-                                              threeds_field_conditional_validations
+                                              threeds_field_conditional_validations, mpi_attributes_field_dependencies
             end
 
             # Special validations upon document building
             def check_requirements
               validate_threeds_card_holder_dates
+              # MPI Directory Server ID is optional when Scheme Tokenized with MPI Protocol Version 2
+              field_value_dependencies.delete :mpi_protocol_version if scheme_tokenized
 
               super
             end

data/lib/genesis_ruby/api/requests/financial/cards/bancontact.rb

@@ -0,0 +1,47 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module Cards
+          #  Bancontact is a local Belgian debit card scheme. All Belgian debit cards are co-branded
+          # Bancontact and Maestro.
+          class Bancontact < Requests::Base::Financial
+
+            include Api::Mixins::Requests::CustomerAddress::BillingInfoAttributes
+            include Api::Mixins::Requests::CustomerAddress::ShippingInfoAttributes
+            include Api::Mixins::Requests::Financial::AsyncAttributes
+            include Api::Mixins::Requests::Financial::PaymentAttributes
+
+            protected
+
+            # BCMC transaction type
+            def transaction_type
+              Api::Constants::Transactions::BANCONTACT
+            end
+
+            # Bancontact field validations
+            def init_field_validations
+              required_fields.push *%i[transaction_id amount currency return_success_url return_failure_url
+                billing_country]
+              field_values.merge! currency:        'EUR',
+                                  billing_country: 'BE'
+            end
+
+            # Bancontact transaction structure
+            def payment_transaction_structure
+              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
+                }
+              )
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/cards/sale3d.rb

@@ -45,12 +45,14 @@ module GenesisRuby
 
               field_value_dependencies.merge! required_tokenization_fields_conditional, required_cc_fields_conditional,
                                               required_recurring_managed_type_field_conditional,
-                                              threeds_field_conditional_validations
+                                              threeds_field_conditional_validations, mpi_attributes_field_dependencies
             end
 
             # Special validations upon document building
             def check_requirements
               validate_threeds_card_holder_dates
+              # MPI Directory Server ID is optional when Scheme Tokenized with MPI Protocol Version 2
+              field_value_dependencies.delete :mpi_protocol_version if scheme_tokenized
 
               super
             end

data/lib/genesis_ruby/api/requests/financial/cash_payments/cash.rb

@@ -0,0 +1,56 @@
+require 'genesis_ruby/api/constants/transactions/parameters/cash_payments/cash_payment_types'
+
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module CashPayments
+          # Cash payment methods allow customers to pay bills and online purchases in cash at convenient
+          # physical locations such as stores, banks, ATMs, even pharmacies in some countries.
+          class Cash < Requests::Base::Financial
+
+            include Api::Mixins::Requests::AddressInfoAttributes
+            include Api::Mixins::Requests::DocumentAttributes
+            include Api::Mixins::Requests::Financial::AsyncAttributes
+            include Api::Mixins::Requests::Financial::PaymentAttributes
+
+            attr_accessor :payment_type
+
+            protected
+
+            # Cash transaction type
+            def transaction_type
+              Api::Constants::Transactions::CASH
+            end
+
+            # Cash field validations
+            def init_field_validations
+              required_fields.push *%i[transaction_id return_success_url return_failure_url amount currency
+               payment_type document_id billing_country]
+
+              field_values.merge! currency:     %w(MXN),
+                                  payment_type: Constants::Transactions::Parameters::CashPayments::CashPaymentTypes.all
+            end
+
+            # Cash request attributes 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,
+                  customer_email:     customer_email,
+                  customer_phone:     customer_phone,
+                  payment_type:       payment_type,
+                  document_id:        document_id,
+                  billing_address:    billing_address_parameters_structure,
+                  shipping_address:   shipping_address_parameters_structure
+                }
+              )
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/cash_payments/pix.rb

@@ -15,11 +15,12 @@ module GenesisRuby
             include Api::Mixins::Requests::BirthDateAttributes
             include Api::Mixins::Requests::DocumentAttributes
             include Api::Mixins::Requests::Financial::AsyncAttributes
+            include Api::Mixins::Requests::Financial::OnlineBankingPayments::PixAttributes
             include Api::Mixins::Requests::Financial::PaymentAttributes
             include Api::Mixins::Requests::Financial::PendingPaymentAttributes
 
             attr_accessor :gender, :marital_status, :sender_occupation, :nationality, :country_of_origin, :birth_city,
-                          :birth_state, :company_type, :company_activity, :mothers_name
+                          :birth_state
 
             # Billing Country custom accessor
             def billing_country
@@ -28,14 +29,9 @@ module GenesisRuby
               @billing_country.to_s.upcase
             end
 
-            # Incorporation date
+            # Override incorpocation date with specific format for Pix request
             def incorporation_date
-              @incorporation_date&.strftime GenesisRuby::Api::Constants::DateTimeFormats::DD_MM_YYYY_L_HYPHENS
-            end
-
-            # Incorporation date
-            def incorporation_date=(value)
-              parse_date attribute: __method__, value: value, allow_empty: true
+              @incorporation_date&.strftime Api::Constants::DateTimeFormats::DD_MM_YYYY_L_HYPHENS
             end
 
             protected

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

@@ -15,6 +15,7 @@ module GenesisRuby
             include Mixins::Requests::Financial::Cards::Recurring::RecurringTypeAttributes
             include Mixins::Requests::Financial::CryptoAttributes
             include Mixins::Requests::Financial::DynamicDescriptorAttributes
+            include Mixins::Requests::Financial::FundingAttributes
             include Mixins::Requests::Financial::Mobile::ApplePayTokenAttributes
             include Mixins::Requests::Financial::PaymentAttributes
 
@@ -43,6 +44,7 @@ module GenesisRuby
                                   payment_subtype: Api::Constants::Transactions::Parameters::Mobile::ApplePay::
                                       PaymentSubtypes.all,
                                   recurring_type:  [Api::Constants::Transactions::Parameters::Recurring::Types::INITIAL]
+              field_values.merge! funding_attributes_field_validations
             end
 
             # Apple Pay payment transaction structure
@@ -60,7 +62,8 @@ module GenesisRuby
                   crypto:                    crypto,
                   recurring_type:            recurring_type,
                   business_attributes:       business_attributes_structure,
-                  dynamic_descriptor_params: dynamic_descriptor_structure
+                  dynamic_descriptor_params: dynamic_descriptor_structure,
+                  funding:                   funding_attributes_structure
                 }
               )
             end

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

@@ -17,6 +17,7 @@ module GenesisRuby
             include Mixins::Requests::Financial::Business::BusinessAttributes
             include Mixins::Requests::Financial::Cards::Recurring::RecurringTypeAttributes
             include Mixins::Requests::Financial::DynamicDescriptorAttributes
+            include Mixins::Requests::Financial::FundingAttributes
             include Mixins::Requests::Financial::Mobile::GooglePayTokenAttributes
             include Mixins::Requests::Financial::NotificationAttributes
             include Mixins::Requests::Financial::PaymentAttributes
@@ -47,7 +48,7 @@ module GenesisRuby
                                   payment_subtype: Constants::Transactions::Parameters::Mobile::GooglePay::
                                       PaymentSubtypes.all,
                                   recurring_type:  [Api::Constants::Transactions::Parameters::Recurring::Types::INITIAL]
-              field_values.merge! threeds_field_validations
+              field_values.merge! threeds_field_validations, funding_attributes_field_validations
 
               field_value_dependencies.merge! threeds_field_conditional_validations
             end
@@ -60,7 +61,7 @@ module GenesisRuby
             end
 
             # Google Pay Payment Transaction Structure
-            def payment_transaction_structure # rubocop:disable Metrics/MethodLength
+            def payment_transaction_structure # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
               payment_attributes_structure.merge(
                 {
                   payment_subtype:           payment_subtype,
@@ -77,7 +78,8 @@ module GenesisRuby
                   dynamic_descriptor_params: dynamic_descriptor_structure,
                   document_id:               document_id,
                   recurring_type:            recurring_type,
-                  threeds_v2_params:         threeds_v2_common_attributes_structure
+                  threeds_v2_params:         threeds_v2_common_attributes_structure,
+                  funding:                   funding_attributes_structure
                 }
               )
             end

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

@@ -0,0 +1,129 @@
+require 'genesis_ruby/api/constants/transactions/parameters/online_banking/bank_account_types'
+require 'genesis_ruby/api/constants/transactions/parameters/online_banking/payout_payment_types'
+
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module OnlineBankingPayments
+          module OnlineBanking
+            # Bank Pay-out option allows merchants to transfer funds directly to their consumers' bank account.
+            class PayOut < Base::Financial
+
+              include Api::Mixins::Requests::AddressInfoAttributes
+              include Api::Mixins::Requests::BirthDateAttributes
+              include Api::Mixins::Requests::DocumentAttributes
+              include Api::Mixins::Requests::Financial::AsyncAttributes
+              include Api::Mixins::Requests::Financial::NotificationAttributes
+              include Api::Mixins::Requests::Financial::OnlineBankingPayments::PixAttributes
+              include Api::Mixins::Requests::Financial::PaymentAttributes
+
+              attr_reader :id_card_number, :payer_bank_phone_number, :document_type, :account_id, :user_id
+              attr_accessor :bank_name, :bank_code, :bank_branch, :bank_account_name, :bank_account_number, :pix_key,
+                            :bank_province, :bank_account_type, :bank_account_verification_digit, :payment_type
+
+              # Id Card Number
+              def id_card_number=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 30
+              end
+
+              # Payer bank phone Number
+              def payer_bank_phone_number=(value)
+                limited_string attribute: __method__, value: value.to_s, min: 11, max: 14
+              end
+
+              # ID card/document type
+              def document_type=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 10
+              end
+
+              # Unique account identifier in Trustly's system
+              def account_id=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 255
+              end
+
+              # Unique user identifier defined by merchant in their own system
+              def user_id=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 255
+              end
+
+              protected
+
+              # Bank Payout transaction type
+              def transaction_type
+                Api::Constants::Transactions::ONLINE_BANKING_PAYOUT
+              end
+
+              # Set field validations
+              def init_field_validations
+                required_fields.push *%i[transaction_id amount currency notification_url return_success_url
+                return_failure_url billing_first_name billing_last_name billing_state billing_country]
+
+                field_values.merge! currency: %w(CNY MYR THB IDR INR ARS BRL CAD CLP COP MXN PEN UYU),
+                                    bank_account_type: Constants::Transactions::Parameters::OnlineBanking::
+                                        BankAccountTypes.all,
+                                    payment_type: Constants::Transactions::Parameters::OnlineBanking::
+                                        PayoutPaymentTypes.all
+              end
+
+              # Custom validations
+              def check_requirements
+                validate_brl_currency
+
+                super
+              end
+
+              # Bank Payout payment transaction structure
+              def payment_transaction_structure # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+                payment_attributes_structure.merge(
+                  {
+                    return_success_url:              return_success_url,
+                    return_failure_url:              return_failure_url,
+                    notification_url:                notification_url,
+                    customer_email:                  customer_email,
+                    customer_phone:                  customer_phone,
+                    bank_name:                       bank_name,
+                    bank_code:                       bank_code,
+                    bank_account_name:               bank_account_name,
+                    bank_account_number:             bank_account_number,
+                    bank_account_type:               bank_account_type,
+                    bank_account_verification_digit: bank_account_verification_digit,
+                    bank_province:                   bank_province,
+                    bank_branch:                     bank_branch,
+                    id_card_number:                  id_card_number,
+                    payer_bank_phone_number:         payer_bank_phone_number,
+                    document_type:                   document_type,
+                    document_id:                     document_id,
+                    account_id:                      account_id,
+                    user_id:                         user_id,
+                    birth_date:                      birth_date,
+                    payment_type:                    payment_type,
+                    company_type:                    company_type,
+                    company_activity:                company_activity,
+                    incorporation_date:              incorporation_date,
+                    mothers_name:                    mothers_name,
+                    pix_key:                         pix_key,
+                    billing_address:                 billing_address_parameters_structure,
+                    shipping_address:                shipping_address_parameters_structure
+                  }
+                )
+              end
+
+              private
+
+              # Specific validations for BRL currency
+              def validate_brl_currency
+                return unless @currency == 'BRL'
+                return if bank_code || bank_name
+
+                raise ParameterError, 'Please verify the following attributes: BRL currency requires one of: ' \
+                                         'bank_code and/or bank_name'
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/version.rb

@@ -1,5 +1,5 @@
 module GenesisRuby
 
-  VERSION = '0.2.0'.freeze
+  VERSION = '0.2.1'.freeze
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: genesis_ruby
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - emerchantpay Ltd.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-11-15 00:00:00.000000000 Z
+date: 2025-02-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http
@@ -245,9 +245,11 @@ files:
 - lib/genesis_ruby/api/constants/states/state.rb
 - lib/genesis_ruby/api/constants/transactions.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/business/payment_types.rb
+- lib/genesis_ruby/api/constants/transactions/parameters/cash_payments/cash_payment_types.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/cash_payments/company_types.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/cash_payments/genders.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/cash_payments/marital_statuses.rb
+- lib/genesis_ruby/api/constants/transactions/parameters/credential_on_files.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/funding/business_application_identifier_types.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/funding/identifier_types.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/funding/receiver_account_types.rb
@@ -260,9 +262,11 @@ files:
 - lib/genesis_ruby/api/constants/transactions/parameters/mobile/google_pay/payment_subtypes.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/mpi_protocol_sub_versions.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/mpi_protocol_versions.rb
+- lib/genesis_ruby/api/constants/transactions/parameters/online_banking/bank_account_types.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/online_banking/bank_code_currencies.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/online_banking/bank_codes.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/online_banking/payment_types.rb
+- lib/genesis_ruby/api/constants/transactions/parameters/online_banking/payout_payment_types.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/recurring/categories.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/recurring/types.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/refund/bank_account_types.rb
@@ -305,6 +309,7 @@ files:
 - lib/genesis_ruby/api/mixins/requests/financial/business/hotels_and_real_estate_rentals_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/business/travel_agencies_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/cards/account_owner_attributes.rb
+- lib/genesis_ruby/api/mixins/requests/financial/cards/credential_on_file_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/cards/credit_card_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/cards/fx_rate_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/cards/mpi_attributes.rb
@@ -313,6 +318,7 @@ files:
 - lib/genesis_ruby/api/mixins/requests/financial/cards/recurring/recurring_category_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/cards/recurring/recurring_type_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/cards/tokenization_attributes.rb
+- lib/genesis_ruby/api/mixins/requests/financial/cards/ucof_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/consumer_identifier_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/crypto_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/dynamic_descriptor_attributes.rb
@@ -322,6 +328,7 @@ files:
 - lib/genesis_ruby/api/mixins/requests/financial/mobile/google_pay_token_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/moto_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/notification_attributes.rb
+- lib/genesis_ruby/api/mixins/requests/financial/online_banking_payments/pix_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/online_banking_payments/virtual_payment_address_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/payment_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/pending_payment_attributes.rb
@@ -356,6 +363,7 @@ files:
 - lib/genesis_ruby/api/requests/financial/cards/aura.rb
 - lib/genesis_ruby/api/requests/financial/cards/authorize.rb
 - lib/genesis_ruby/api/requests/financial/cards/authorize3d.rb
+- lib/genesis_ruby/api/requests/financial/cards/bancontact.rb
 - lib/genesis_ruby/api/requests/financial/cards/cabal.rb
 - lib/genesis_ruby/api/requests/financial/cards/cencosud.rb
 - lib/genesis_ruby/api/requests/financial/cards/elo.rb
@@ -368,6 +376,7 @@ files:
 - lib/genesis_ruby/api/requests/financial/cash_payments/baloto.rb
 - lib/genesis_ruby/api/requests/financial/cash_payments/banco_de_occidente.rb
 - lib/genesis_ruby/api/requests/financial/cash_payments/boleto.rb
+- lib/genesis_ruby/api/requests/financial/cash_payments/cash.rb
 - lib/genesis_ruby/api/requests/financial/cash_payments/efecty.rb
 - lib/genesis_ruby/api/requests/financial/cash_payments/oxxo.rb
 - lib/genesis_ruby/api/requests/financial/cash_payments/pago_facil.rb
@@ -380,6 +389,7 @@ files:
 - lib/genesis_ruby/api/requests/financial/online_banking_payments/davivienda.rb
 - lib/genesis_ruby/api/requests/financial/online_banking_payments/itau.rb
 - lib/genesis_ruby/api/requests/financial/online_banking_payments/online_banking/pay_in.rb
+- lib/genesis_ruby/api/requests/financial/online_banking_payments/online_banking/pay_out.rb
 - lib/genesis_ruby/api/requests/financial/online_banking_payments/pse.rb
 - lib/genesis_ruby/api/requests/financial/online_banking_payments/rapi_pago.rb
 - lib/genesis_ruby/api/requests/financial/online_banking_payments/santander.rb