genesis_ruby 0.2.4 → 0.2.5

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

@@ -0,0 +1,30 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          # African Mobile Attributes mixin
+          module AfricanMobileAttributes
+
+            attr_reader :target, :operator
+
+            # Number of the Paybill for which the transaction is intended
+            def target=(value)
+              limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 20
+            end
+
+            # Name of the Mobile network operator which should process the transaction
+            def operator=(value)
+              allowed_options attribute: __method__,
+                              allowed:
+                                GenesisRuby::Api::Constants::Transactions::Parameters::AfricanMobileOperators.all,
+                              value: value.to_s.upcase,
+                              allow_empty: false
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          module Cards
+            # Tokenization Params Attributes mixin
+            module TokenizationParamsAttributes
+
+              attr_accessor :tokenization_tavv
+              attr_reader :tokenization_eci
+
+              # Electronic Commerce Indicator (ECI) is a value that is returned from the Directory Server
+              # (Visa, MasterCard, etc.) to indicate the authentication results of your customer’s
+              # credit card payment on 3D Secure
+              def tokenization_eci=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 2
+              end
+
+              protected
+
+              # Tokenization Params Attributes Structure
+              def tokenization_params_attributes_structure
+                {
+                  eci:  tokenization_eci,
+                  tavv: tokenization_tavv
+                }
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,82 @@
+require 'genesis_ruby/api/constants/transactions/parameters/customer_identification/customer_identification_owner'
+require 'genesis_ruby/api/constants/transactions/parameters/customer_identification/customer_identification_type'
+require 'genesis_ruby/api/constants/transactions/parameters/customer_identification/customer_identification_subtype'
+require 'genesis_ruby/utils/country'
+
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          # Customer Identification Attributes
+          module CustomerIdentificationAttributes
+
+            attr_accessor :customer_identification_document_id
+
+            attr_reader   :customer_identification_owner, :customer_identification_type,
+                          :customer_identification_subtype, :customer_identification_issuing_country
+
+            # Customer Identification Owner
+            def customer_identification_owner=(value)
+              allowed_options(
+                attribute: __method__,
+                allowed:
+                  GenesisRuby::Api::Constants::Transactions::Parameters::CustomerIdentification::CustomerIdentificationOwner.all, # rubocop:disable Layout/LineLength
+                value: value,
+                error_message: 'Invalid data for Customer Identification Document Owner',
+                allow_empty: true
+              )
+            end
+
+            # Customer Identification Type
+            def customer_identification_type=(value)
+              allowed_options(
+                attribute: __method__,
+                allowed:
+                  GenesisRuby::Api::Constants::Transactions::Parameters::CustomerIdentification::CustomerIdentificationType.all, # rubocop:disable Layout/LineLength
+                value: value,
+                error_message: 'Invalid data for Customer Identification Document Type',
+                allow_empty: true
+              )
+            end
+
+            # Customer Identification Issuing Country
+            def customer_identification_issuing_country=(value)
+              allowed_options(
+                attribute: __method__,
+                allowed: GenesisRuby::Utils::Country::COUNTRIES.keys,
+                value: value,
+                error_message: 'Invalid country code for Document issuer country',
+                allow_empty: true
+              )
+            end
+
+            # Customer Identification Document Subtype
+            def customer_identification_subtype=(value)
+              allowed_options(
+                attribute: __method__,
+                allowed: GenesisRuby::Api::Constants::Transactions::Parameters::CustomerIdentification::CustomerIdentificationSubtype.all, # rubocop:disable Layout/LineLength
+                value: value,
+                error_message: 'Invalid value for Customer Identification Document Subtype',
+                allow_empty: true
+              )
+            end
+
+            protected
+
+            def customer_identification_attributes_structure
+              {
+                owner:           customer_identification_owner,
+                type:            customer_identification_type,
+                subtype:         customer_identification_subtype,
+                document_id:     customer_identification_document_id,
+                issuing_country: customer_identification_issuing_country
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          # Gift Cards Attributes mixin
+          module GiftCardsAttributes
+
+            attr_reader :card_number, :cvv
+
+            # Gift card number
+            def card_number=(value)
+              limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, min: 19, max: 21
+            end
+
+            # Verification code of the gift card
+            def cvv=(value)
+              limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, min: 5, max: 8
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          # Mixin Preauthorization Attributes
+          module PreauthorizationAttributes
+
+            attr_reader :preauthorization
+
+            # Preauthorization setter
+            def preauthorization=(value)
+              allowed_options attribute:     __method__,
+                              allowed:       [true, false],
+                              value:         value,
+                              allow_empty:   true,
+                              error_message: 'Accepts only boolean values'
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+require 'genesis_ruby/api/constants/transactions/parameters/purpose_of_payment'
+
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          # Purpose of Payment Attributes
+          module PurposeOfPaymentAttributes
+
+            attr_reader :purpose_of_payment
+
+            # Purpose of Payment setter
+            def purpose_of_payment=(value)
+              allowed_options(
+                attribute: __method__,
+                allowed: GenesisRuby::Api::Constants::Transactions::Parameters::PurposeOfPayment.all,
+                value: value,
+                error_message: 'Invalid data for Purpose of Payment',
+                allow_empty: true
+              )
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,38 @@
+require 'genesis_ruby/api/constants/transactions/parameters/source_of_funds'
+
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          # Source of Funds Attributes
+          module SourceOfFundsAttributes
+
+            attr_reader :source_of_funds
+
+            # Source of Funds setter
+            def source_of_funds=(value)
+              allowed_options(
+                attribute: __method__,
+                allowed: GenesisRuby::Api::Constants::Transactions::Parameters::SourceOfFunds.all,
+                value: value,
+                error_message: 'Invalid data for Source of Funds',
+                allow_empty: true
+              )
+            end
+
+            protected
+
+            # Source of Funds attributes structure
+            def source_of_funds_attributes_structure
+              {
+                source_of_funds: source_of_funds
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/financial/travel_data/airline_itinerary_attributes.rb

@@ -135,7 +135,7 @@ module GenesisRuby
               end
 
               # Attributes Structure
-              def airline_attributes_structure # rubocop:disable RSpec/MethodLength
+              def airline_attributes_structure # rubocop:disable Metrics/MethodLength
                 {
                   ticket_number:               travel_aid_ticket_number,
                   passenger_name:              travel_aid_passenger_name,

data/lib/genesis_ruby/api/mixins/requests/non_financial/fx/id_attributes.rb

@@ -0,0 +1,28 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module NonFinancial
+          module Fx
+            # ID Attributes mixin
+            module IdAttributes
+
+              attr_writer :id
+
+              # Tier ID
+              def id
+                @id.to_s
+              end
+
+              # Required fields
+              def id_required_fields
+                [:id]
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/non_financial/fx/tier_id_attributes.rb

@@ -0,0 +1,28 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module NonFinancial
+          module Fx
+            # Tier ID Attributes mixin
+            module TierIdAttributes
+
+              attr_writer :tier_id
+
+              # Identification of the tier
+              def tier_id
+                @tier_id.to_s
+              end
+
+              # Required fields
+              def tier_id_required_fields
+                [:tier_id]
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/non_financial/kyc/customer_information_attributes.rb

@@ -0,0 +1,62 @@
+require 'genesis_ruby/api/constants/non_financial/kyc/document_types'
+require 'genesis_ruby/api/constants/non_financial/kyc/genders'
+
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module NonFinancial
+          module Kyc
+            # Customer Information Attributes mixin
+            module CustomerInformationAttributes
+
+              include Api::Mixins::Requests::BirthDateAttributes
+
+              attr_accessor :first_name, :middle_name, :last_name, :customer_email,
+                            :address1, :address2, :city, :zip_code, :country,
+                            :province, :phone1, :phone2, :document_number, :document_type, :gender
+
+              protected
+
+              # Sets the request field validations
+              def customer_information_required_fields
+                %i[first_name last_name customer_email address1 city province zip_code country]
+              end
+
+              # Sets the request field values validations
+              def customer_information_required_field_values
+                {
+                  gender:        Api::Constants::NonFinancial::Kyc::Genders.all,
+                  document_type: Api::Constants::NonFinancial::Kyc::DocumentTypes.all
+                }
+              end
+
+              # Returns the customer information structure as a hash
+              def customer_information_structure # rubocop:disable Metrics/MethodLength
+                {
+                  first_name:      first_name,
+                  middle_name:     middle_name,
+                  last_name:       last_name,
+                  customer_email:  customer_email,
+                  address1:        address1,
+                  address2:        address2,
+                  city:            city,
+                  province:        province,
+                  zip_code:        zip_code,
+                  country:         country,
+                  phone1:          phone1,
+                  phone2:          phone2,
+                  birth_date:      birth_date,
+                  document_type:   document_type,
+                  document_number: document_number,
+                  gender:          gender
+                }
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/request.rb

@@ -116,6 +116,13 @@ module GenesisRuby
         api_config.url = build_request_url({ subdomain: 'api_service', path: request_path })
       end
 
+      # Initializes KYC Service Configuration
+      def init_kyc_service_configuration(options = { request_path: '' })
+        request_path = options.fetch :request_path, ''
+
+        api_config.url = build_request_url({ subdomain: 'kyc_service', path: request_path })
+      end
+
       # Process Everything the variables set previously
       #
       # Step 1: Execute per-field actions

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

@@ -10,6 +10,7 @@ module GenesisRuby
             include Mixins::Requests::Financial::Cards::CredentialOnFileAttributes
             include Mixins::Requests::Financial::Cards::CreditCardAttributes
             include Mixins::Requests::Financial::Cards::TokenizationAttributes
+            include Mixins::Requests::Financial::Cards::TokenizationParamsAttributes
             include Mixins::Requests::Financial::Cards::UcofAttributes
 
             attr_reader :scheme_tokenized
@@ -35,7 +36,7 @@ module GenesisRuby
             end
 
             # Credit Card attributes
-            def payment_transaction_structure
+            def payment_transaction_structure # rubocop:disable Metrics/MethodLength
               credit_card_attributes_structure.merge(
                 tokenization_attributes_structure,
                 {
@@ -43,7 +44,8 @@ module GenesisRuby
                   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
+                  scheme_tokenized:                          scheme_tokenized,
+                  tokenization_params:                       tokenization_params_attributes_structure
                 }
               )
             end

data/lib/genesis_ruby/api/requests/base/non_financial/kyc/base.rb

@@ -0,0 +1,33 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Base
+        module NonFinancial
+          module Kyc
+            # Base Request class for KYC Non-Financial API services
+            class Base < Api::Requests::Base::Versioned
+
+              # Constructor for the KYC Base Request
+              def initialize(configuration, builder_interface = Builder::JSON)
+                super(configuration, builder_interface)
+              end
+
+              # Initializes the request path and version
+              def init_configuration
+                super
+
+                init_kyc_service_configuration request_path: "api/#{version}/#{request_path}"
+              end
+
+              # Empty request structure
+              def request_structure
+                {}
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -5,7 +5,6 @@ module GenesisRuby
         # Base class used in the Reference transaction requests
         class Reference < Financial
 
-          include Mixins::Requests::Financial::PaymentAttributes
           include Mixins::Requests::Financial::ReferenceAttributes
 
           protected
@@ -25,7 +24,7 @@ module GenesisRuby
           def payment_transaction_structure
             {
               reference_id: reference_id
-            }.merge payment_attributes_structure, reference_transaction_structure
+            }.merge reference_transaction_structure
           end
 
         end

data/lib/genesis_ruby/api/requests/financial/Preauthorizations/incremental_authorize.rb

@@ -0,0 +1,24 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module Preauthorizations
+          # Incremental Authorize transaction type
+          class IncrementalAuthorize < Base::Reference
+
+            # Incremental Authorize transaction type
+            def transaction_type
+              Constants::Transactions::INCREMENTAL_AUTHORIZE
+            end
+
+            # Returns the transaction structure
+            def reference_transaction_structure
+              {}
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -10,6 +10,7 @@ module GenesisRuby
           class Authorize < Requests::Base::Financials::CreditCard
 
             include Mixins::Requests::AddressInfoAttributes
+            include Mixins::Requests::DigitalAssetTypeAttributes
             include Mixins::Requests::DocumentAttributes
             include Mixins::Requests::Financial::Business::BusinessAttributes
             include Mixins::Requests::Financial::Cards::FxRateAttributes
@@ -22,6 +23,7 @@ module GenesisRuby
             include Mixins::Requests::Financial::FundingAttributes
             include Mixins::Requests::Financial::GamingAttributes
             include Mixins::Requests::Financial::MotoAttributes
+            include Mixins::Requests::Financial::PreauthorizationAttributes
             include Mixins::Requests::Financial::ReferenceAttributes
             include Mixins::Requests::Financial::RiskAttributes
             include Mixins::Requests::Financial::ScaAttributes
@@ -53,6 +55,7 @@ module GenesisRuby
               super.merge(
                 gaming:                     gaming,
                 moto:                       moto,
+                preauthorization:           preauthorization,
                 crypto:                     crypto,
                 customer_email:             customer_email,
                 customer_phone:             customer_phone,
@@ -71,7 +74,8 @@ module GenesisRuby
                 travel:                     travel_data_attributes_structure,
                 funding:                    funding_attributes_structure,
                 installment_plan_id:        installment_plan_id,
-                installment_plan_reference: installment_plan_reference
+                installment_plan_reference: installment_plan_reference,
+                digital_asset_type:         digital_asset_type
               )
             end
 

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

@@ -10,6 +10,7 @@ module GenesisRuby
           class Authorize3d < Requests::Base::Financials::CreditCard
 
             include Mixins::Requests::AddressInfoAttributes
+            include Mixins::Requests::DigitalAssetTypeAttributes
             include Mixins::Requests::DocumentAttributes
             include Mixins::Requests::Financial::AsyncAttributes
             include Mixins::Requests::Financial::Business::BusinessAttributes
@@ -25,6 +26,7 @@ module GenesisRuby
             include Mixins::Requests::Financial::GamingAttributes
             include Mixins::Requests::Financial::MotoAttributes
             include Mixins::Requests::Financial::NotificationAttributes
+            include Mixins::Requests::Financial::PreauthorizationAttributes
             include Mixins::Requests::Financial::RiskAttributes
             include Mixins::Requests::Financial::ScaAttributes
             include Mixins::Requests::Financial::Threeds::Version2::CommonAttributes
@@ -67,6 +69,7 @@ module GenesisRuby
                 return_failure_url:         return_failure_url,
                 gaming:                     gaming,
                 moto:                       moto,
+                preauthorization:           preauthorization,
                 crypto:                     crypto,
                 customer_email:             customer_email,
                 customer_phone:             customer_phone,
@@ -86,7 +89,8 @@ module GenesisRuby
                 travel:                     travel_data_attributes_structure,
                 funding:                    funding_attributes_structure,
                 installment_plan_id:        installment_plan_id,
-                installment_plan_reference: installment_plan_reference
+                installment_plan_reference: installment_plan_reference,
+                digital_asset_type:         digital_asset_type
               )
             end
 

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

@@ -0,0 +1,39 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module Cards
+          # Credits (also known as Credit Fund Transfer a.k.a. CFT) can be done with an initial reference transaction.
+          class Credit < Requests::Base::Reference
+
+            include Mixins::Requests::Financial::Cards::AccountOwnerAttributes
+            include Mixins::Requests::Financial::CustomerIdentificationAttributes
+            include Mixins::Requests::Financial::PurposeOfPaymentAttributes
+            include Mixins::Requests::Financial::SourceOfFundsAttributes
+            include Mixins::Requests::Financial::CryptoAttributes
+            include Mixins::Requests::DigitalAssetTypeAttributes
+
+            protected
+
+            # Credit transaction type
+            def transaction_type
+              Api::Constants::Transactions::CREDIT
+            end
+
+            # Reference transaction structure
+            def reference_transaction_structure
+              {
+                'crypto'                  => crypto,
+                'digital_asset_type'      => digital_asset_type,
+                'customer_identification' => customer_identification_attributes_structure,
+                'account_owner'           => account_owner_attributes_structure,
+                'purpose_of_payment'      => purpose_of_payment
+              }.merge source_of_funds_attributes_structure
+            end
+
+          end
+        end
+      end
+    end
+  end
+end