genesis_ruby 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f03e064990c5ab2c2f8d128db6cdda17ffb306ab6b945dbec7e66e28c9a40ebc
-  data.tar.gz: 8aadefd87afbfb72e608fa702161a0ec5653397cc2a3e31f480004d631ae8985
+  metadata.gz: 9072aff1c90817e3c33b33fb2edb13dd233eb1215a431ea48929f04097f0bb0b
+  data.tar.gz: 3799ea143d2abddaf7c8afded420e332a60ceeef1218c839483575428c735eda
 SHA512:
-  metadata.gz: bdee942af8926d926df609438829638c0bf71b404e03b85e9614e30e252d11a300f268aa6d12936ce19403898292556c631a3e05043941b30a6701378a6d4a0c
-  data.tar.gz: 2f2bcfd52842fdf936589908a8d82b6dc97bfd928363cf663a83eebc6d2dad40067e6de916150428c919d6f9cd4ec195a9487ecc41b8626d0173726f204b6a09
+  metadata.gz: ed1030a2956b575dc61ff111e07bc89f45b78a61c33c2d8ae5b0278c350313c1308fec9c046e2bcb59a33e4b258b765ca49761f052fa10ce95d5514f40d6379e
+  data.tar.gz: 6efa9c63b505b4c5ab09518e12db4e68131e93e203c964bf20b57263c2569d67ef5fb72acf0c742fbe9027783bae64d891a43cd58d79de4af25bae71a738814b

data/CHANGELOG.md

@@ -1,3 +1,43 @@
+0.2.4
+-----
+**Features**:
+
+* Added Tokenization API support:
+  * Tokenize
+  * Detokenize
+  * Token
+  * Cryptogram
+  * Validate token
+  * Delete token
+  * Get Card
+* Added Payer attributes support to Bank Payout
+* Added Beneficiary attributes support to PIX transaction request
+* Added Processed Transactions API support:
+  * Single Processed Transaction
+  * By Date Range
+  * Post By Date Range
+* Added SCA Checker API support
+* Added Retrieval API support:
+  * Single Retrieval
+  * List of Retrievals
+  * By Date Range
+* Added Consumer API support:
+  * Create
+  * Retrieve
+  * Update
+  * Disable
+  * Enable
+  * Get Consumer Cards
+* Added PayU transaction request support
+* Added Post Finance transaction request support
+* Added SafetyPay transaction request support
+* Added TrustlySale transaction request support
+* Added MyBank transaction request support
+* Added InstaDebit transaction request support
+* Added UPI transaction request support
+* Added Sofort transaction request support
+* Added Multibanco transaction request support
+
 0.2.3
 -----
 **Features**:

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    genesis_ruby (0.2.3)
+    genesis_ruby (0.2.4)
       net-http (~> 0.3.2)
       nokogiri (~> 1.14)
 

data/README.md

@@ -1038,9 +1038,17 @@ GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::Bradesco
 GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::Davivienda
 GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::Eps
 GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::Itau
+GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::Multibanco
+GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::PayU
+GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::PostFinance
+GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::MyBank
 GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::Pse
 GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::RapiPago
+GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::SafetyPay
 GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::Santander
+GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::TrustlySale
+GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::Upi
+GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::Sofort
 GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::Webpay
 GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::Wechat
 # PayIn
@@ -1050,6 +1058,9 @@ GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::OnlineBanking::Pay
 # iDebit
 GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::Idebit::PayIn
 GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::Idebit::PayOut
+# InstaDebit
+GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::InstaDebit::PayIn
+GenesisRuby::Api::Requests::Financial::OnlineBankingPayments::InstaDebit::PayOut
 
 # SDD
 GenesisRuby::Api::Requests::Financial::Sdd::Sale
@@ -1073,6 +1084,35 @@ GenesisRuby::Api::Requests::NonFinancial::Installments::Fetch
 ## Billing API
 GenesisRuby::Api::Requests::NonFinancial::BillingApi::Transactions
 
+## Consumer API
+GenesisRuby::Api::Requests::NonFinancial::Consumers::Create
+GenesisRuby::Api::Requests::NonFinancial::Consumers::Retrieve
+GenesisRuby::Api::Requests::NonFinancial::Consumers::Update
+GenesisRuby::Api::Requests::NonFinancial::Consumers::Disable
+GenesisRuby::Api::Requests::NonFinancial::Consumers::Enable
+GenesisRuby::Api::Requests::NonFinancial::Consumers::GetCards
+
+## Retrieval API
+GenesisRuby::Api::Requests::NonFinancial::Fraud::Retrieval::Transaction
+GenesisRuby::Api::Requests::NonFinancial::Fraud::Retrieval::DateRange
+
+## SCA API
+GenesisRuby::Api::Requests::NonFinancial::Sca::Checker
+
+## Processed Transaction API
+GenesisRuby::Api::Requests::NonFinancial::ProcessedTransactions::Transaction
+GenesisRuby::Api::Requests::NonFinancial::ProcessedTransactions::DateRange
+GenesisRuby::Api::Requests::NonFinancial::ProcessedTransactions::PostDateRange
+
+## Tokenization API
+GenesisRuby::Api::Requests::NonFinancial::Tokenization::Tokenize
+GenesisRuby::Api::Requests::NonFinancial::Tokenization::Detokenize
+GenesisRuby::Api::Requests::NonFinancial::Tokenization::UpdateToken
+GenesisRuby::Api::Requests::NonFinancial::Tokenization::Cryptogram
+GenesisRuby::Api::Requests::NonFinancial::Tokenization::ValidateToken
+GenesisRuby::Api::Requests::NonFinancial::Tokenization::DeleteToken
+GenesisRuby::Api::Requests::NonFinancial::Tokenization::GetCard
+
 ```
 
 ### Manual initialization

data/VERSION

@@ -1 +1 @@
-0.2.3
+0.2.4

data/lib/genesis_ruby/api/constants/transactions/parameters/non_financial/externally_processed.rb

@@ -0,0 +1,22 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module NonFinancial
+            # Filter requests by being externally processed or being native to Genesis
+            class ExternallyProcessed
+
+              extend Mixins::Constants::Common
+
+              GENESIS  = 'genesis'.freeze
+              EXTERNAL = 'external'.freeze
+              ALL      = 'all'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/non_financial/processing_type.rb

@@ -0,0 +1,22 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module NonFinancial
+            # Filter requests by being card present or card not present
+            class ProcessingType
+
+              extend Mixins::Constants::Common
+
+              CARD_PRESENT     = 'card_present'.freeze
+              CARD_NOT_PRESENT = 'card_not_present'.freeze
+              ALL              = 'all'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/non_financial/sca_exemptions.rb

@@ -0,0 +1,25 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module NonFinancial
+            # SCA Exemption Values
+            class ScaExemptions
+
+              extend Mixins::Constants::Common
+
+              LOW_VALUE                = 'low_value'.freeze
+              LOW_RISK                 = 'low_risk'.freeze
+              TRUSTED_MERCHANT         = 'trusted_merchant'.freeze
+              CORPORATE_PAYMENT        = 'corporate_payment'.freeze
+              DELEGATED_AUTHENTICATION = 'delegated_authentication'.freeze
+              AUTH_NETWORK_OUTAGE      = 'auth_network_outage'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module OnlineBanking
+            # Return URL Target attributes
+            class IframeTargets
+
+              extend Api::Mixins::Constants::Common
+
+              # URL target for successful payment in Trustly iFrame.
+              # Self
+              SELF   = 'self'.freeze
+              # Parent
+              PARENT = 'parent'.freeze
+              # Top
+              TOP    = 'TOP'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/financial/beneficiary_attributes.rb

@@ -0,0 +1,38 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          # The beneficiary parameters attributes
+          module BeneficiaryAttributes
+
+            attr_accessor :beneficiary_name
+            attr_reader   :beneficiary_document_id, :beneficiary_pix_key
+
+            # The Document ID of the beneficiary, such as CPF or CNPJ for Brazilian entities
+            def beneficiary_document_id=(value)
+              limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 14
+            end
+
+            # The PIX key associated with the beneficiary
+            def beneficiary_pix_key=(value)
+              limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 36
+            end
+
+            protected
+
+            # Beneficiary parameters structure
+            def beneficiary_parameters_structure
+              {
+                name:        beneficiary_name,
+                document_id: beneficiary_document_id,
+                pix_key:     beneficiary_pix_key
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/financial/customer_account_attributes.rb

@@ -0,0 +1,21 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          # Customer Account Attributes
+          module CustomerAccountAttributes
+
+            attr_reader :customer_account_id
+
+            # Customer account id parameter validation
+            def customer_account_id=(value)
+              limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 20
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,65 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          module OnlineBankingPayments
+            # Payer attributes
+            module PayerAttributes
+
+              attr_reader :payer_document_id, :payer_bank_code, :payer_bank_account_number,
+                          :payer_bank_branch, :payer_bank_account_verification_digit,
+                          :payer_bank_phone_number
+
+              # Payer document ID
+              def payer_document_id=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 16
+              end
+
+              # The bank code used to process the transaction
+              def payer_bank_code=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 12
+              end
+
+              # The payer's bank account number
+              def payer_bank_account_number=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 33
+              end
+
+              # The name of the bank branch where the account is held
+              def payer_bank_branch=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 11
+              end
+
+              # Single digit verification code assigned by the external provider,
+              # used to validate the bank account
+              def payer_bank_account_verification_digit=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 1
+              end
+
+              # The payer's bank contact phone number
+              def payer_bank_phone_number=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 11
+              end
+
+              protected
+
+              # Payer parameters structure
+              def payer_parameters_structure
+                {
+                  document_id:                     payer_document_id,
+                  bank_code:                       payer_bank_code,
+                  bank_account_number:             payer_bank_account_number,
+                  bank_branch:                     payer_bank_branch,
+                  bank_account_verification_digit: payer_bank_account_verification_digit,
+                  bank_phone_number:               payer_bank_phone_number
+                }
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/non_financial/mode_attributes.rb

@@ -0,0 +1,24 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module NonFinancial
+          # Mode Attributes mixin
+          module ModeAttributes
+
+            attr_reader :mode
+
+            # Mode
+            def mode=(value)
+              allowed_options attribute: __method__,
+                              allowed: %w(list),
+                              value: value.to_s.downcase,
+                              allow_empty: true
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/non_financial/tokenization/card_data_attributes.rb

@@ -0,0 +1,62 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module NonFinancial
+          module Tokenization
+            # Card Data Attributes mixin
+            module CardDataAttributes
+
+              attr_accessor :card_holder
+              attr_reader   :card_number, :expiration_month, :expiration_year
+
+              # Complete credit/debit card number of customer
+              def card_number=(value)
+                limited_string attribute: __method__, value: value.to_s, min: 13, max: 19
+              end
+
+              # Expiration month as printed on credit card
+              def expiration_month=(value)
+                error_message = format(
+                  'Invalid value "%{value}" given for %{attribute}, should be in MM format',
+                  value: value,
+                  attribute: __method__
+                )
+
+                raise GenesisRuby::ParameterError, error_message unless value.nil? || value =~ /^(0[1-9]|1[0-2])$/
+
+                @expiration_month = value
+              end
+
+              # Expiration year as printed on credit card
+              def expiration_year=(value)
+                error_message = format(
+                  'Invalid value "%{value}" given for %{attribute}, should be in YYYY format',
+                  value: value,
+                  attribute: __method__
+                )
+
+                raise GenesisRuby::ParameterError, error_message unless value.nil? || value =~ /^(20)\d{2}$/
+
+                @expiration_year = value
+              end
+
+              protected
+
+              # Card Data Attributes Structure
+              def card_data_attributes_structure
+                {
+                  card_number:      card_number,
+                  card_holder:      card_holder,
+                  expiration_month: expiration_month,
+                  expiration_year:  expiration_year
+                }
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/non_financial/tokenization/token_attributes.rb

@@ -0,0 +1,23 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module NonFinancial
+          module Tokenization
+            # Token Attributes mixin
+            module TokenAttributes
+
+              attr_reader :token
+
+              # Plain-text token value
+              def token=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 36
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/non_financial/tokenization/tokenization_attributes.rb

@@ -0,0 +1,51 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module NonFinancial
+          module Tokenization
+            # Common Tokenization API Attributes mixin
+            module TokenizationAttributes
+
+              attr_accessor :token_type
+              attr_reader   :consumer_id, :email
+
+              # Consumer unique reference
+              def consumer_id=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 10
+              end
+
+              # Consumer e-mail address
+              def email=(value)
+                error_message = format(
+                  'Invalid value given for %{attribute}',
+                  attribute: __method__
+                )
+
+                raise GenesisRuby::ParameterError, error_message unless value.nil? || value =~ /\A.+@.+\..+\Z/
+
+                @email = value
+              end
+
+              protected
+
+              def tokenization_required_fields
+                %i[consumer_id email token_type]
+              end
+
+              # Tokenization Attributes Structure
+              def tokenization_attributes_structure
+                {
+                  consumer_id: consumer_id,
+                  email:       email,
+                  token_type:  token_type
+                }
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/base/consumer.rb

@@ -0,0 +1,24 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Base
+        # Consumers API base request class
+        class Consumer < Versioned
+
+          def initialize(configuration, builder_interface = Builder::XML)
+            super configuration, builder_interface
+          end
+
+          protected
+
+          def populate_structure
+            super
+
+            @tree_structure = Hash["#{request_path}_request", request_structure]
+          end
+
+        end
+      end
+    end
+  end
+end

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

@@ -6,6 +6,7 @@ module GenesisRuby
         class Financial < Request
 
           include Mixins::Requests::Financial::BaseAttributes
+          include Mixins::Requests::Financial::PaymentAttributes
 
           # Use Smart Router endpoint for the current request
           def use_smart_router
@@ -48,6 +49,7 @@ module GenesisRuby
             super
           end
 
+          # Populate the request structure
           def populate_structure
             self.tree_structure = {
               payment_transaction: {
@@ -55,7 +57,7 @@ module GenesisRuby
                 transaction_id:   transaction_id,
                 usage:            usage,
                 remote_ip:        remote_ip
-              }.merge(payment_transaction_structure)
+              }.merge(payment_attributes_structure, payment_transaction_structure)
             }
           end
 
@@ -64,6 +66,13 @@ module GenesisRuby
             api_config.url = build_request_url({ subdomain: 'smart_router', path: 'transactions' })
           end
 
+          # Initialize Financial class validations
+          def init_field_validations
+            super
+
+            field_values.merge! currency: Api::Constants::Currencies::Iso4217.all.map(&:upcase)
+          end
+
         end
       end
     end

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

@@ -11,7 +11,6 @@ module GenesisRuby
             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
 
@@ -29,17 +28,16 @@ module GenesisRuby
 
             # Request Field validations
             def init_field_validations
+              super
+
               required_fields.push *%i[transaction_id amount currency]
-              field_values.merge!(
-                { currency: Api::Constants::Currencies::Iso4217.all.map(&:upcase) },
-                credential_on_file_field_validations
-              )
+              field_values.merge! credential_on_file_field_validations
             end
 
             # Credit Card attributes
             def payment_transaction_structure
-              payment_attributes_structure.merge(
-                credit_card_attributes_structure, tokenization_attributes_structure,
+              credit_card_attributes_structure.merge(
+                tokenization_attributes_structure,
                 {
                   account_owner:                             account_owner_attributes_structure,
                   credential_on_file:                        credential_on_file,

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

@@ -9,7 +9,6 @@ module GenesisRuby
             include Api::Mixins::Requests::AddressInfoAttributes
             include Api::Mixins::Requests::Financial::AsyncAttributes
             include Api::Mixins::Requests::BirthDateAttributes
-            include Api::Mixins::Requests::Financial::PaymentAttributes
             include Api::Mixins::Requests::Financial::ConsumerIdentifierAttributes
 
             # Billing Country custom accessor
@@ -36,19 +35,17 @@ module GenesisRuby
             end
 
             # South American payments
-            def payment_transaction_structure # rubocop:disable Metrics/MethodLength
-              payment_attributes_structure.merge(
-                {
-                  return_success_url: return_success_url,
-                  return_failure_url: return_failure_url,
-                  consumer_reference: consumer_reference,
-                  national_id:        national_id,
-                  birth_date:         birth_date,
-                  customer_email:     customer_email,
-                  billing_address:    billing_address_parameters_structure,
-                  shipping_address:   shipping_address_parameters_structure
-                }
-              )
+            def payment_transaction_structure
+              {
+                return_success_url: return_success_url,
+                return_failure_url: return_failure_url,
+                consumer_reference: consumer_reference,
+                national_id:        national_id,
+                birth_date:         birth_date,
+                customer_email:     customer_email,
+                billing_address:    billing_address_parameters_structure,
+                shipping_address:   shipping_address_parameters_structure
+              }
             end
 
           end

data/lib/genesis_ruby/api/requests/base/reference.rb

@@ -11,8 +11,9 @@ module GenesisRuby
           protected
 
           def init_field_validations
+            super
+
             required_fields.push *%i[transaction_id reference_id amount currency]
-            field_values.merge! currency: Api::Constants::Currencies::Iso4217.all.map(&:upcase)
           end
 
           # Reference transaction request structure