genesis_ruby 0.2.3 → 0.2.5

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/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/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/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

@@ -10,8 +10,8 @@ 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
-            include Mixins::Requests::Financial::PaymentAttributes
 
             attr_reader :scheme_tokenized
 
@@ -29,23 +29,23 @@ 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,
+            def payment_transaction_structure # rubocop:disable Metrics/MethodLength
+              credit_card_attributes_structure.merge(
+                tokenization_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
+                  scheme_tokenized:                          scheme_tokenized,
+                  tokenization_params:                       tokenization_params_attributes_structure
                 }
               )
             end

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/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,14 +5,14 @@ module GenesisRuby
         # Base class used in the Reference transaction requests
         class Reference < Financial
 
-          include Mixins::Requests::Financial::PaymentAttributes
           include Mixins::Requests::Financial::ReferenceAttributes
 
           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
@@ -24,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/bancontact.rb

@@ -10,7 +10,6 @@ module GenesisRuby
             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
 
@@ -21,6 +20,8 @@ module GenesisRuby
 
             # Bancontact field validations
             def init_field_validations
+              super
+
               required_fields.push *%i[transaction_id amount currency return_success_url return_failure_url
                 billing_country]
               field_values.merge! currency:        'EUR',
@@ -29,14 +30,12 @@ module GenesisRuby
 
             # 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
-                }
-              )
+              {
+                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

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