genesis_ruby 0.2.5 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 23c3f5ca68fa323f565fdd6c719727c8766e5c48c8c0493565b1ddb94548bbc7
-  data.tar.gz: c0c05e008139fb2b329d85a35abfa6208687291e8774e2be883f146cdb5fa8f4
+  metadata.gz: 71e80020085f54f73f761fc4edf086d35cd4036def2240f164bf43297bb26655
+  data.tar.gz: df18d10bfd5256ea4b1c8b795de95d96b81dc94b92d5bfb79fb97cf03dfd723a
 SHA512:
-  metadata.gz: a4dae27aed3ece2f4dd94a591bc4f6c3835bc778545f288df1cccf933f6ada91548c13a1792e728ff7d56fdb2a122d9c8caa90ad77406a526a49aeb0b335b531
-  data.tar.gz: 0141ea62ea869aa01ab8cc12d44937d3f6264c4d6e1e360c213d251a3b33a360e5e3e4f4142acbbf071cf4e858cd865eadfae0f46ee65db4c4643c3fe58567d9
+  metadata.gz: 88e6ed6cca766a04e74c18e304357e6badca5ca2313aa481705ead6228c740c1df0b8aaacb47f362d5cb4d3dc327823454b919271b50c54c6bd5a672cdf24de2
+  data.tar.gz: 7138775c1ca35e2704383b2b764f7c6460566472f4c9e5e3b67a286ea7ca6631e69903b0812d2f85cd2b1b838cab6325e97cbb7df3650165a449d48c0c48ec67

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+0.2.6
+-----
+**Features**:
+
+* Added Partial Reversal transaction request support
+* Added KYC Remote Identity Verification API request support
+* Added KYC Update Consumer Registration API request support
+
 0.2.5
 -----
 **Features**:

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    genesis_ruby (0.2.5)
+    genesis_ruby (0.2.6)
       net-http (~> 0.3.2)
       nokogiri (~> 1.14)
 
@@ -42,7 +42,7 @@ GEM
     language_server-protocol (3.17.0.4)
     lint_roller (1.1.0)
     mini_mime (1.1.5)
-    mini_portile2 (2.8.8)
+    mini_portile2 (2.8.9)
     multi_xml (0.6.0)
     mustermann (3.0.3)
       ruby2_keywords (~> 0.0.1)

data/README.md

@@ -1009,6 +1009,7 @@ GenesisRuby::Api::Requests::Financial::Cards::TarjetaShopping
 
 ## Preauthorizations
 GenesisRuby::Api::Requests::Financial::Preauthorizations::IncrementalAuthorize
+GenesisRuby::Api::Requests::Financial::Preauthorizations::PartialReversal
 
 ## Mobile
 GenesisRuby::Api::Requests::Financial::Mobile::ApplePay
@@ -1135,6 +1136,8 @@ GenesisRuby::Api::Requests::NonFinancial::Tokenization::GetCard
 
 ## KYC Know Your Customer API
 GenesisRuby::Api::Requests::NonFinancial::Kyc::ConsumerRegistration::Create
+GenesisRuby::Api::Requests::NonFinancial::Kyc::ConsumerRegistration::Update
+GenesisRuby::Api::Requests::NonFinancial::Kyc::Verifications::RemoteIdentity
 
 ## Chargeback API
 GenesisRuby::Api::Requests::NonFinancial::Fraud::Chargeback::Transaction

data/VERSION

@@ -1 +1 @@
-0.2.5
+0.2.6

data/lib/genesis_ruby/api/constants/non_financial/kyc/document_supported_types.rb

@@ -0,0 +1,28 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module NonFinancial
+        module Kyc
+          # This class provides a mapping of supported document types for KYC procedures.
+          class DocumentSupportedTypes
+
+            extend Mixins::Constants::Common
+
+            # Passport document type
+            PASSPORT             = 'passport'.freeze
+
+            # ID card document type
+            ID_CARD              = 'id_card'.freeze
+
+            # Driving license document type
+            DRIVING_LICENSE      = 'driving_license'.freeze
+
+            # Credit or Debit card document type
+            CREDIT_OR_DEBIT_CARD = 'credit_or_debit_card'.freeze
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/non_financial/kyc/profile_current_statuses.rb

@@ -0,0 +1,25 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module NonFinancial
+        module Kyc
+          # Profile current statuses
+          class ProfileCurrentStatuses
+
+            extend Mixins::Constants::Common
+
+            # Undefined
+            UNDEFINED = 0
+            # Review
+            REVIEW    = 1
+            # Denied
+            DENIED    = 2
+            # Approved
+            APPROVED  = 3
+
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,60 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module NonFinancial
+          module Kyc
+            # Document Attributes mixin
+            module DocumentAttributes
+
+              attr_accessor :proof, :full_address
+              attr_reader   :first_name, :middle_name, :last_name
+
+              # Gets date of birth for the document attributes
+              def date_of_birth
+                @date_of_birth&.strftime(
+                  GenesisRuby::Api::Constants::DateTimeFormats::YYYY_MM_DD_ISO_8601
+                )
+              end
+
+              # Sets date of birth for the document attributes
+              def date_of_birth=(value)
+                parse_date attribute: __method__, value: value, allow_empty: true
+              end
+
+              # Sets the first name for the document attributes
+              def first_name=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 32
+              end
+
+              # Sets the middle name for the document attributes
+              def middle_name=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 32
+              end
+
+              # Sets the last name for the document attributes
+              def last_name=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 32
+              end
+
+              protected
+
+              # Defines the structure of the document attributes
+              def document_attributes_structure
+                {
+                  proof:         proof,
+                  date_of_birth: date_of_birth,
+                  first_name:    first_name,
+                  middle_name:   middle_name,
+                  last_name:     last_name,
+                  full_address:  full_address
+                }
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/preauthorizations/partial_reversal.rb

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

data/lib/genesis_ruby/api/requests/non_financial/kyc/consumer_registration/create.rb

@@ -51,7 +51,6 @@ module GenesisRuby
                 super
 
                 required_fields.push *%i[
-                  customer_information_structure
                   customer_unique_id
                   customer_registration_date
                   customer_registration_ip_address
@@ -59,7 +58,8 @@ module GenesisRuby
 
                 field_values.merge! device_fingerprint_type: [1, 2, 3],
                                     profile_action_type:     [1, 2],
-                                    profile_current_status:  [0, 1, 2, 3],
+                                    profile_current_status:
+                                      GenesisRuby::Api::Constants::NonFinancial::Kyc::ProfileCurrentStatuses.all,
                                     industry_type:           [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
                 field_values.merge! customer_information_required_field_values
               end

data/lib/genesis_ruby/api/requests/non_financial/kyc/consumer_registration/update.rb

@@ -0,0 +1,50 @@
+require 'genesis_ruby/api/constants/non_financial/kyc/profile_current_statuses'
+
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Kyc
+          module ConsumerRegistration
+            # Update Consumer Registration Request class for KYC Non-Financial API services
+            class Update < Api::Requests::Base::NonFinancial::Kyc::Base
+
+              attr_accessor :reference_id, :profile_current_status, :status_reason
+
+              def initialize(configuration, _builder_interface = nil)
+                super configuration
+
+                self.request_path = 'update_consumer'
+              end
+
+              protected
+
+              # Sets the request field validations
+              def init_field_validations
+                super
+
+                required_fields.push *%i[
+                  reference_id
+                  profile_current_status
+                ]
+
+                field_values.merge! profile_current_status:
+                  GenesisRuby::Api::Constants::NonFinancial::Kyc::ProfileCurrentStatuses.all
+              end
+
+              # Defines the request structure
+              def request_structure
+                {
+                  reference_id:           reference_id,
+                  profile_current_status: profile_current_status,
+                  status_reason:          status_reason
+                }
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/non_financial/kyc/verifications/remote_identity.rb

@@ -0,0 +1,91 @@
+require 'genesis_ruby/api/constants/non_financial/kyc/document_supported_types'
+
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Kyc
+          module Verifications
+            # Remote Identity Verification Request class for KYC Non-Financial API services
+            class RemoteIdentity < Api::Requests::Base::NonFinancial::Kyc::Base
+
+              include Api::Mixins::Requests::NonFinancial::Kyc::DocumentAttributes
+
+              # Initializes the Remote Identity Verification Request
+              def initialize(configuration, _builder_interface = nil)
+                super configuration
+
+                self.request_path = 'verifications'
+              end
+
+              attr_accessor :reference_id, :country, :backside_proof_required
+              attr_reader   :email
+
+              # Sets the email address for the Remote Identity verification
+              def email=(value)
+                raise InvalidArgumentError unless value =~ /\A.+@.+\..+\Z/
+
+                @email = value
+              end
+
+              # Gets the expiry date for the Remote Identity verification
+              def expiry_date
+                @expiry_date&.strftime(
+                  Api::Constants::DateTimeFormats::YYYY_MM_DD_ISO_8601
+                )
+              end
+
+              # Sets the expiry date for the Remote Identity verification
+              def expiry_date=(value)
+                parse_date attribute: __method__, value: value, allow_empty: true
+              end
+
+              # Sets the document supported types for the Remote Identity verification
+              def document_supported_types=(value)
+                parse_array_of_strings attribute: __method__,
+                                       value: value,
+                                       allowed: Api::Constants::NonFinancial::Kyc::DocumentSupportedTypes.all
+              end
+
+              # Returns the document supported types for the Remote Identity verification
+              def document_supported_types
+                @document_supported_types || []
+              end
+
+              # Initializes field validations for the Remote Identity verification request
+              def init_field_validations
+                super
+
+                field_values.merge! country: GenesisRuby::Utils::Country::COUNTRIES.keys.map(&:upcase),
+                                    backside_proof_required: [true, false]
+              end
+
+              protected
+
+              # Performs validation checks for the Remote Identity verification request
+              def check_requirements
+                raise ParameterError, 'Either email or reference_id field has to be set.' if email.nil? && reference_id.nil? # rubocop:disable Layout/LineLength
+
+                super
+              end
+
+              # Returns request structure for the Remote Identity verification
+              def request_structure
+                {
+                  email:                    email,
+                  reference_id:             reference_id,
+                  country:                  country,
+                  backside_proof_required:  backside_proof_required,
+                  expiry_date:              expiry_date,
+                  document_supported_types: document_supported_types,
+                  document:                 document_attributes_structure
+                }
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/version.rb

@@ -1,5 +1,5 @@
 module GenesisRuby
 
-  VERSION = '0.2.5'.freeze
+  VERSION = '0.2.6'.freeze
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: genesis_ruby
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.2.6
 platform: ruby
 authors:
 - emerchantpay Ltd.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-05-13 00:00:00.000000000 Z
+date: 2025-05-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http
@@ -241,8 +241,10 @@ files:
 - lib/genesis_ruby/api/constants/endpoints.rb
 - lib/genesis_ruby/api/constants/environments.rb
 - lib/genesis_ruby/api/constants/i18n.rb
+- lib/genesis_ruby/api/constants/non_financial/kyc/document_supported_types.rb
 - lib/genesis_ruby/api/constants/non_financial/kyc/document_types.rb
 - lib/genesis_ruby/api/constants/non_financial/kyc/genders.rb
+- lib/genesis_ruby/api/constants/non_financial/kyc/profile_current_statuses.rb
 - lib/genesis_ruby/api/constants/states.rb
 - lib/genesis_ruby/api/constants/states/state.rb
 - lib/genesis_ruby/api/constants/transactions.rb
@@ -387,6 +389,7 @@ files:
 - lib/genesis_ruby/api/mixins/requests/non_financial/fx/id_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/non_financial/fx/tier_id_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/non_financial/kyc/customer_information_attributes.rb
+- lib/genesis_ruby/api/mixins/requests/non_financial/kyc/document_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/non_financial/mode_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/non_financial/paging_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/non_financial/tokenization/card_data_attributes.rb
@@ -404,7 +407,6 @@ files:
 - lib/genesis_ruby/api/requests/base/non_financial/kyc/base.rb
 - lib/genesis_ruby/api/requests/base/reference.rb
 - lib/genesis_ruby/api/requests/base/versioned.rb
-- lib/genesis_ruby/api/requests/financial/Preauthorizations/incremental_authorize.rb
 - lib/genesis_ruby/api/requests/financial/capture.rb
 - lib/genesis_ruby/api/requests/financial/cards/argencard.rb
 - lib/genesis_ruby/api/requests/financial/cards/aura.rb
@@ -466,6 +468,8 @@ files:
 - lib/genesis_ruby/api/requests/financial/online_banking_payments/upi.rb
 - lib/genesis_ruby/api/requests/financial/online_banking_payments/webpay.rb
 - lib/genesis_ruby/api/requests/financial/online_banking_payments/wechat.rb
+- lib/genesis_ruby/api/requests/financial/preauthorizations/incremental_authorize.rb
+- lib/genesis_ruby/api/requests/financial/preauthorizations/partial_reversal.rb
 - lib/genesis_ruby/api/requests/financial/refund.rb
 - lib/genesis_ruby/api/requests/financial/sdd/recurring/init_recurring_sale.rb
 - lib/genesis_ruby/api/requests/financial/sdd/recurring/recurring_sale.rb
@@ -496,6 +500,8 @@ files:
 - lib/genesis_ruby/api/requests/non_financial/installments/fetch.rb
 - lib/genesis_ruby/api/requests/non_financial/installments/show.rb
 - lib/genesis_ruby/api/requests/non_financial/kyc/consumer_registration/create.rb
+- lib/genesis_ruby/api/requests/non_financial/kyc/consumer_registration/update.rb
+- lib/genesis_ruby/api/requests/non_financial/kyc/verifications/remote_identity.rb
 - lib/genesis_ruby/api/requests/non_financial/processed_transactions/date_range.rb
 - lib/genesis_ruby/api/requests/non_financial/processed_transactions/post_date_range.rb
 - lib/genesis_ruby/api/requests/non_financial/processed_transactions/transaction.rb