genesis_ruby 0.1.7 → 0.1.8

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

@@ -0,0 +1,91 @@
+require 'genesis_ruby/api/constants/transactions/parameters/mobile/apple_pay/payment_subtypes'
+
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module Mobile
+          # Apple Pay transaction request
+          class ApplePay < Requests::Base::Financial
+
+            include Mixins::Requests::AddressInfoAttributes
+            include Mixins::Requests::BirthDateAttributes
+            include Mixins::Requests::DocumentAttributes
+            include Mixins::Requests::Financial::Business::BusinessAttributes
+            include Mixins::Requests::Financial::CryptoAttributes
+            include Mixins::Requests::Financial::DynamicDescriptorAttributes
+            include Mixins::Requests::Financial::Mobile::ApplePayTokenAttributes
+            include Mixins::Requests::Financial::PaymentAttributes
+
+            attr_accessor :payment_subtype
+
+            # Define Payment Token from a JSON string
+            def json_token=(value)
+              json_object = Utils::Common.parse_json_string value
+
+              map_apple_pay_token_attributes json_object
+            end
+
+            protected
+
+            # Apple Pay transaction request type
+            def transaction_type
+              Api::Constants::Transactions::APPLE_PAY
+            end
+
+            def init_field_validations
+              required_fields.push *%i[transaction_id payment_subtype token_version token_data token_signature
+                token_ephemeral_public_key token_public_key_hash token_transaction_id token_display_name token_network
+                token_type token_transaction_identifier amount currency]
+
+              field_values.merge! currency:        Api::Constants::Currencies::Iso4217.all.map(&:upcase),
+                                  payment_subtype: Api::Constants::Transactions::Parameters::Mobile::ApplePay::
+                                      PaymentSubtypes.all
+            end
+
+            # Apple Pay payment transaction structure
+            def payment_transaction_structure # rubocop:disable Metrics/MethodLength
+              payment_attributes_structure.merge(
+                {
+                  payment_subtype:           payment_subtype,
+                  payment_token:             payment_token_structure,
+                  customer_email:            customer_email,
+                  customer_phone:            customer_phone,
+                  birth_date:                birth_date,
+                  billing_address:           billing_address_parameters_structure,
+                  shipping_address:          shipping_address_parameters_structure,
+                  document_id:               document_id,
+                  crypto:                    crypto,
+                  business_attributes:       business_attributes_structure,
+                  dynamic_descriptor_params: dynamic_descriptor_structure
+                }
+              )
+            end
+
+            private
+
+            # Map the Apple Pay Token attributes from the given Hash object
+            def map_apple_pay_token_attributes(json_object)
+              return nil unless json_object.is_a? Hash
+
+              json_object.each do |token_key, token_value|
+                if token_value.is_a? Hash
+                  map_apple_pay_token_attributes token_value
+
+                  next
+                end
+
+                token_method = "token_#{GenesisRuby::Utils::Common.camel_to_snake_case(token_key)}="
+
+                __send__ token_method, token_value if respond_to? token_method
+              end
+
+              nil
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,108 @@
+require 'genesis_ruby/api/constants/transactions/parameters/mobile/google_pay/payment_subtypes'
+
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module Mobile
+          # Google Pay transaction request
+          class GooglePay < Requests::Base::Financial
+
+            attr_accessor :payment_subtype
+
+            include Mixins::Requests::AddressInfoAttributes
+            include Mixins::Requests::BirthDateAttributes
+            include Mixins::Requests::DocumentAttributes
+            include Mixins::Requests::Financial::AsyncAttributes
+            include Mixins::Requests::Financial::Business::BusinessAttributes
+            include Mixins::Requests::Financial::DynamicDescriptorAttributes
+            include Mixins::Requests::Financial::Mobile::GooglePayTokenAttributes
+            include Mixins::Requests::Financial::NotificationAttributes
+            include Mixins::Requests::Financial::PaymentAttributes
+            include Mixins::Requests::Financial::Threeds::Version2::CommonAttributes
+
+            # Define a payment token from a JSON string
+            def json_token=(value)
+              json_object = Utils::Common.parse_json_string value
+
+              map_google_pay_token_attributes json_object
+            end
+
+            protected
+
+            # Google Pay transaction request type
+            def transaction_type
+              Constants::Transactions::GOOGLE_PAY
+            end
+
+            # Google Pay Required fields
+            def init_field_validations
+              super
+
+              required_fields.push *%i[transaction_id payment_subtype amount currency token_signature token_signed_key
+                token_signatures token_protocol_version token_signed_message]
+
+              field_values.merge! currency:        Constants::Currencies::Iso4217.all.map(&:upcase),
+                                  payment_subtype: Constants::Transactions::Parameters::Mobile::GooglePay::
+                                      PaymentSubtypes.all
+              field_values.merge! threeds_field_validations
+
+              field_value_dependencies.merge! threeds_field_conditional_validations
+            end
+
+            # Special validations upon document building
+            def check_requirements
+              validate_threeds_card_holder_dates
+
+              super
+            end
+
+            # Google Pay Payment Transaction Structure
+            def payment_transaction_structure # rubocop:disable Metrics/MethodLength
+              payment_attributes_structure.merge(
+                {
+                  payment_subtype:           payment_subtype,
+                  payment_token:             google_pay_token_structure,
+                  customer_email:            customer_email,
+                  customer_phone:            customer_phone,
+                  birth_date:                birth_date,
+                  notification_url:          notification_url,
+                  return_success_url:        return_success_url,
+                  return_failure_url:        return_failure_url,
+                  billing_address:           billing_address_parameters_structure,
+                  shipping_address:          shipping_address_parameters_structure,
+                  business_attributes:       business_attributes_structure,
+                  dynamic_descriptor_params: dynamic_descriptor_structure,
+                  document_id:               document_id,
+                  threeds_v2_params:         threeds_v2_common_attributes_structure
+                }
+              )
+            end
+
+            private
+
+            # Map the Google Pay Token attributes from the given Hash object
+            def map_google_pay_token_attributes(json_object)
+              return nil unless json_object.is_a? Hash
+
+              json_object.each do |token_key, token_value|
+                if token_value.is_a? Hash
+                  map_google_pay_token_attributes token_value
+
+                  next
+                end
+
+                token_method = "token_#{GenesisRuby::Utils::Common.camel_to_snake_case(token_key)}="
+
+                __send__ token_method, token_value if respond_to? token_method
+              end
+
+              nil
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,157 @@
+require 'genesis_ruby/api/constants/transactions/parameters/online_banking/payment_types'
+require 'genesis_ruby/api/constants/transactions/parameters/online_banking/bank_code_currencies'
+
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module OnlineBankingPayments
+          module OnlineBanking
+            # Online Banking PayIn transaction class
+            class PayIn < Base::Financial # rubocop:disable Metrics/ClassLength
+
+              include Api::Mixins::Requests::AddressInfoAttributes
+              include Api::Mixins::Requests::DocumentAttributes
+              include Api::Mixins::Requests::Financial::AsyncAttributes
+              include Api::Mixins::Requests::Financial::OnlineBankingPayments::VirtualPaymentAddressAttributes
+              include Api::Mixins::Requests::Financial::PaymentAttributes
+
+              attr_accessor :user_category, :payment_type, :bank_code, :consumer_reference, :auth_code
+
+              protected
+
+              # Online Banking PayIn transaction type
+              def transaction_type
+                Api::Constants::Transactions::ONLINE_BANKING_PAYIN
+              end
+
+              # Online Banking PayIn field validations
+              def init_field_validations # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+                required_fields.push *%i[transaction_id return_success_url return_failure_url amount currency bank_code]
+
+                field_values.merge! payment_type: Api::Constants::Transactions::Parameters::OnlineBanking::
+                                        PaymentTypes.all,
+                                    currency:     Api::Constants::Transactions::Parameters::OnlineBanking::
+                                        BankCodeCurrencies.all.map(&:upcase),
+                                    bank_code:    Api::Constants::Transactions::Parameters::OnlineBanking::BankCodes.all
+
+                field_value_dependencies.merge!(
+                  {
+                    currency: {
+                      AUD: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('AUD')
+                      },
+                      BRL: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('BRL')
+                      },
+                      CAD: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('CAD')
+                      },
+                      CHF: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('CHF')
+                      },
+                      CNY: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('CNY')
+                      },
+                      CLP: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('CLP')
+                      },
+                      EUR: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('EUR')
+                      },
+                      THB: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('THB')
+                      },
+                      USD: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('USD')
+                      },
+                      MYR: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('MYR')
+                      },
+                      PEN: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('PEN')
+                      },
+                      PYG: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('PYG')
+                      },
+                      IDR: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('IDR')
+                      },
+                      INR: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('INR')
+                      },
+                      MXN: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('MXN')
+                      },
+                      PHP: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('PHP')
+                      },
+                      SGD: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('SGD')
+                      },
+                      UYU: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('UYU')
+                      },
+                      VND: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('VND')
+                      },
+                      PLN: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('PLN')
+                      },
+                      GBP: {
+                        bank_code: Api::Constants::Transactions::Parameters::OnlineBanking::BankCodeCurrencies
+                                     .bank_codes_per_currency('GBP')
+                      }
+                    }
+                  }
+                )
+              end
+
+              # Online Banking PayIn parameters 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,
+                    billing_address:         billing_address_parameters_structure,
+                    shipping_address:        shipping_address_parameters_structure,
+                    customer_email:          customer_email,
+                    customer_phone:          customer_phone,
+                    payment_type:            payment_type,
+                    bank_code:               bank_code,
+                    document_id:             document_id,
+                    user_category:           user_category,
+                    virtual_payment_address: virtual_payment_address,
+                    consumer_reference:      consumer_reference,
+                    auth_code:               auth_code
+                  }
+                )
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -14,8 +14,8 @@ module GenesisRuby
             Api::Constants::Transactions::VOID
           end
 
-          def init_required_fields
-            self.required_fields = %i[transaction_id reference_id]
+          def init_field_validations
+            required_fields.push *%i[transaction_id reference_id]
           end
 
           # Void transaction request structure

data/lib/genesis_ruby/api/requests/non_financial/reconcile/date_range.rb

@@ -60,8 +60,8 @@ module GenesisRuby
               @api_config.parser_skip_root_node = false
             end
 
-            def init_required_fields
-              self.required_fields = %i[start_date]
+            def init_field_validations
+              required_fields.push *%i[start_date]
             end
 
             # API Request structure

data/lib/genesis_ruby/api/requests/wpf/create.rb

@@ -116,26 +116,20 @@ module GenesisRuby
             init_api_wpf_configuration
           end
 
-          def init_required_fields
-            self.required_fields = %i[
-              transaction_id
-              amount
-              currency
-              notification_url
-              return_success_url
-              return_failure_url
-              return_cancel_url
-              transaction_types
-            ]
+          def init_field_validations
+            required_fields.push *%i[transaction_id amount currency notification_url return_success_url
+              return_failure_url return_cancel_url transaction_types]
+
+            field_values.merge!(
+              { currency: Api::Constants::Currencies::Iso4217.all.map(&:upcase) },
+              threeds_field_validations
+            )
           end
 
           # Perform validation over the defined parameters upon request execution
           def check_requirements
-            unless GenesisRuby::Api::Constants::Currencies::Iso4217.valid?(currency)
-              raise ParameterError, "Invalid Currency given with value #{currency}"
-            end
-
             validate_reminders
+            validate_threeds_card_holder_dates
 
             super
           end
@@ -185,6 +179,8 @@ module GenesisRuby
 
           # Add every transaction type to the transaction types structure
           def transaction_types=(value)
+            @transaction_types = [] if value.nil?
+
             @transaction_types ||= []
 
             @transaction_types.push(value)

data/lib/genesis_ruby/api/requests/wpf/reconcile.rb

@@ -17,8 +17,8 @@ module GenesisRuby
             @api_config.url = build_request_url subdomain: 'wpf', path: 'wpf/reconcile'
           end
 
-          def init_required_fields
-            self.required_fields = %i[unique_id]
+          def init_field_validations
+            required_fields.push *%i[unique_id]
           end
 
           # WPF Reconcile request structure

data/lib/genesis_ruby/utils/common.rb

@@ -1,5 +1,6 @@
 require 'uri'
 require 'date'
+require 'json'
 
 module GenesisRuby
   module Utils
@@ -108,6 +109,31 @@ module GenesisRuby
           false
         end
 
+        # Parse JSON string
+        def parse_json_string(value)
+          JSON.parse value
+        rescue StandardError => e
+          raise InvalidArgumentError, "Given JSON string is invalid: #{e.message}"
+        end
+
+        # String conversion from CamelCase to snake_case
+        def camel_to_snake_case(camel_cased_word)
+          camel_cased_word.to_s.gsub(/::/, '/')
+                          .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+                          .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+                          .tr('-', '_')
+                          .downcase
+        end
+
+        # String conversion from snake_case to CamelCase
+        def snake_to_camel_case(snake_case_word, lower: true)
+          string = snake_case_word.to_s.split(/_/).map(&:capitalize).join
+
+          string.sub!(/^[[:alpha:]]/, &:downcase) if lower
+
+          string
+        end
+
       end
 
     end

data/lib/genesis_ruby/version.rb

@@ -1,5 +1,5 @@
 module GenesisRuby
 
-  VERSION = '0.1.7'.freeze
+  VERSION = '0.1.8'.freeze
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: genesis_ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.8
 platform: ruby
 authors:
 - emerchantpay Ltd.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-07-29 00:00:00.000000000 Z
+date: 2024-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http
@@ -250,8 +250,13 @@ files:
 - lib/genesis_ruby/api/constants/transactions/parameters/managed_recurring/intervals.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/managed_recurring/modes.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/managed_recurring/payment_types.rb
+- lib/genesis_ruby/api/constants/transactions/parameters/mobile/apple_pay/payment_subtypes.rb
+- 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_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/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
@@ -277,6 +282,7 @@ files:
 - lib/genesis_ruby/api/mixins/constants/common.rb
 - lib/genesis_ruby/api/mixins/requests/address_info_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/attribute_validation.rb
+- lib/genesis_ruby/api/mixins/requests/birth_date_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/customer_address/billing_info_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/customer_address/customer_info_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/customer_address/shipping_info_attributes.rb
@@ -303,8 +309,11 @@ files:
 - lib/genesis_ruby/api/mixins/requests/financial/crypto_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/dynamic_descriptor_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/gaming_attributes.rb
+- lib/genesis_ruby/api/mixins/requests/financial/mobile/apple_pay_token_attributes.rb
+- 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/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
 - lib/genesis_ruby/api/mixins/requests/financial/reference_attributes.rb
@@ -338,6 +347,9 @@ files:
 - lib/genesis_ruby/api/requests/financial/cards/sale.rb
 - lib/genesis_ruby/api/requests/financial/cards/sale3d.rb
 - lib/genesis_ruby/api/requests/financial/cards/threeds/v2/method_continue.rb
+- lib/genesis_ruby/api/requests/financial/mobile/apple_pay.rb
+- lib/genesis_ruby/api/requests/financial/mobile/google_pay.rb
+- lib/genesis_ruby/api/requests/financial/online_banking_payments/online_banking/pay_in.rb
 - lib/genesis_ruby/api/requests/financial/refund.rb
 - lib/genesis_ruby/api/requests/financial/void.rb
 - lib/genesis_ruby/api/requests/non_financial/reconcile/date_range.rb
@@ -418,7 +430,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.1.2
 signing_key:
 specification_version: 4
 summary: Ruby Client for Genesis Payment Processing Gateway