genesis_ruby 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 02dff613f2499bed46dee4d66d10fb64ea987d663d14e1097bb6ab36a444336a
-  data.tar.gz: bc89246c16d0b2e5b70dbd11c2b35421874ec749e0e6dd2926135850bf37faa7
+  metadata.gz: 3bae58236ea63ffb79254010e7dd8651252a8f128eb3c9e245eaf6cc4588c426
+  data.tar.gz: e9bc31285e5acceefe5df452d274445f6b88e3039115d313ea1361b9990cc149
 SHA512:
-  metadata.gz: 8eacfb3b669fee18642bbeadb3d291ee4e8fd18e45fd45486c954646f3dc7f1cc146321b64cfef6d8bdce9a91c58e13d6e3a4c4a44eb71154a366d54a58a5e6c
-  data.tar.gz: 7d8eff36538c46f41671c90d71af6af9d8d432c52ddb2238a5b64699956be0a9eabf68fd19c52a03e2310738ce9eb6f918d1c4b1d12dd23c06265cb2c0d7cb2b
+  metadata.gz: 235e870d4dc316eface0f780352fe0129293740742ab45b6638d839cf51cbd9296e193be9a9cf533da6f1c089e39885e47fbf4220523a715a1db8c3c821a3b6c
+  data.tar.gz: 346de3c0848acea9c8394323b8377fc1fb86eab52fa125f30586dcb71bf0f2422d7f128fe3152547284274ca5eddde44a1a1d96206d9391bcf65525669f46529

data/CHANGELOG.md

@@ -1,3 +1,26 @@
+0.1.6
+-----
+**Features**:
+
+* Added Web Payment Form `lifetime` validations with a maximum allowed value of 3 months in minutes (131487)
+* Added Web Payment Form `lifetime` default value of 30 minutes
+* Added Web Payment Form Reminders support
+* Added Pay Later parameter support to the Web Payment Form
+  * Reminders will be sent to the Gateway only when `pay_later=true`
+* Added Reminder Language parameter support to the Web Payment Form. It accepts only available WPF locales.
+* Added validation for Web Payment Form `locale` attribute. It accepts only available WPF locales.
+
+0.1.5
+-----
+**Features**:
+
+* Added Smart Routing support
+* Added Required field validations to the existing transaction requests
+
+**Fixes**:
+
+* Fixed JSON parser loading in the Response handling logic
+
 0.1.4
 -----
 **Features**:

data/Gemfile.lock

@@ -1,24 +1,26 @@
 PATH
   remote: .
   specs:
-    genesis_ruby (0.1.4)
+    genesis_ruby (0.1.6)
       net-http (~> 0.3.2)
       nokogiri (~> 1.14)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.5)
+    addressable (2.8.6)
       public_suffix (>= 2.0.2, < 6.0)
     ast (2.4.2)
     base64 (0.2.0)
-    concurrent-ruby (1.2.2)
-    crack (0.4.5)
+    bigdecimal (3.1.7)
+    concurrent-ruby (1.2.3)
+    crack (1.0.0)
+      bigdecimal
       rexml
-    diff-lcs (1.5.0)
+    diff-lcs (1.5.1)
     faker (2.23.0)
       i18n (>= 1.8.11, < 2)
-    faraday (2.7.12)
+    faraday (2.8.1)
       base64
       faraday-net_http (>= 2.0, < 3.1)
       ruby2_keywords (>= 0.0.4)
@@ -28,13 +30,13 @@ GEM
     gitlab (4.19.0)
       httparty (~> 0.20)
       terminal-table (>= 1.5.1)
-    hashdiff (1.0.1)
+    hashdiff (1.1.0)
     httparty (0.21.0)
       mini_mime (>= 1.0.0)
       multi_xml (>= 0.5.2)
-    i18n (1.14.1)
+    i18n (1.14.4)
       concurrent-ruby (~> 1.0)
-    json (2.6.3)
+    json (2.7.1)
     language_server-protocol (3.17.0.3)
     mini_mime (1.1.5)
     mini_portile2 (2.8.5)
@@ -43,14 +45,14 @@ GEM
       ruby2_keywords (~> 0.0.1)
     net-http (0.3.2)
       uri
-    nokogiri (1.15.5)
+    nokogiri (1.15.6)
       mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
     octokit (7.2.0)
       faraday (>= 1, < 3)
       sawyer (~> 0.9)
-    parallel (1.23.0)
-    parser (3.2.2.4)
+    parallel (1.24.0)
+    parser (3.3.0.5)
       ast (~> 2.4.1)
       racc
     pronto (0.11.2)
@@ -66,70 +68,71 @@ GEM
       rubocop (>= 0.63.1, < 2.0)
     public_suffix (5.0.4)
     racc (1.7.3)
-    rack (2.2.8)
-    rack-protection (3.1.0)
+    rack (2.2.9)
+    rack-protection (3.2.0)
+      base64 (>= 0.1.0)
       rack (~> 2.2, >= 2.2.4)
     rainbow (3.1.1)
     rake (13.1.0)
-    regexp_parser (2.8.2)
+    regexp_parser (2.9.0)
     rexml (3.2.6)
-    rspec (3.12.0)
-      rspec-core (~> 3.12.0)
-      rspec-expectations (~> 3.12.0)
-      rspec-mocks (~> 3.12.0)
-    rspec-core (3.12.2)
-      rspec-support (~> 3.12.0)
-    rspec-expectations (3.12.3)
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.0)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-mocks (3.12.6)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-support (3.12.1)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.1)
     rspec_junit_formatter (0.6.0)
       rspec-core (>= 2, < 4, != 2.12.0)
-    rubocop (1.57.2)
+    rubocop (1.62.1)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
-      parser (>= 3.2.2.4)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.28.1, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.30.0)
-      parser (>= 3.2.1.0)
-    rubocop-capybara (2.19.0)
+    rubocop-ast (1.31.2)
+      parser (>= 3.3.0.4)
+    rubocop-capybara (2.20.0)
+      rubocop (~> 1.41)
+    rubocop-factory_bot (2.25.1)
       rubocop (~> 1.41)
-    rubocop-factory_bot (2.24.0)
-      rubocop (~> 1.33)
     rubocop-faker (1.1.0)
       faker (>= 2.12.0)
       rubocop (>= 0.82.0)
-    rubocop-rspec (2.25.0)
+    rubocop-rspec (2.27.1)
       rubocop (~> 1.40)
       rubocop-capybara (~> 2.17)
       rubocop-factory_bot (~> 2.22)
     ruby-progressbar (1.13.0)
     ruby2_keywords (0.0.5)
-    rugged (1.7.1)
+    rugged (1.7.2)
     sawyer (0.9.2)
       addressable (>= 2.3.5)
       faraday (>= 0.17.3, < 3)
-    sinatra (3.1.0)
+    sinatra (3.2.0)
       mustermann (~> 3.0)
       rack (~> 2.2, >= 2.2.4)
-      rack-protection (= 3.1.0)
+      rack-protection (= 3.2.0)
       tilt (~> 2.0)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
-    thor (1.3.0)
+    thor (1.3.1)
     tilt (2.3.0)
     unicode-display_width (2.5.0)
     uri (0.13.0)
-    webmock (3.19.1)
+    webmock (3.23.0)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)

data/README.md

@@ -98,6 +98,11 @@ begin
     # Other
     request.lifetime            = 30
     request.web_payment_form_id = '987654321'
+
+    # Reminders
+    request.pay_later           = true
+    request.add_reminder channel: 'email', after: 10
+    request.add_reminder channel: 'sms', after: 30
   end.execute
   
   puts genesis.response.response_object
@@ -148,6 +153,24 @@ rescue GenesisRuby::Error => error
 end
 ```
 
+### Smart Router
+
+The Smart Routing API is a higher-level abstraction that allows for simpler and more efficient gateway Processing API integration.
+It does not require the terminal token (`configuration.token`). This by itself minimizes the need for complex customer-level manual routing to terminals set up on the gateway platform configuration layer.
+
+By default the Smart Router is disabled. Contact your account manager to use the functionality.
+
+Smart Router global definition for all requests
+* GenesisRuby::Configuration
+  ```ruby
+  configuration.force_smart_routing = true
+  ```
+
+* Smart Router definition per request
+  ```ruby
+  request.use_smart_router = true
+  ```
+
 ### Example 3DSv2 Request
 
 Sample request including all the conditionally required/optional params for initiating a 3DS transaction with the 3DSv2-Method authentication protocol.

data/VERSION

@@ -1 +1 @@
-0.1.4
+0.1.6

data/lib/genesis_ruby/api/constants/i18n.rb

@@ -0,0 +1,90 @@
+module GenesisRuby
+  module Api
+    module Constants
+      # WPF localization constants
+      class I18n
+
+        extend Mixins::Constants::Common
+
+        # Arabic
+        AR = 'ar'.freeze
+
+        # Bulgarian
+        BG = 'bg'.freeze
+
+        # German
+        DE = 'de'.freeze
+
+        # English
+        EN = 'en'.freeze
+
+        # Spanish
+        ES = 'es'.freeze
+
+        # French
+        FR = 'fr'.freeze
+
+        # Hindu
+        HI = 'hi'.freeze
+
+        # Japanese
+        JA = 'ja'.freeze
+
+        # Icelandic
+        IS = 'is'.freeze
+
+        # Italian
+        IT = 'it'.freeze
+
+        # Dutch
+        NL = 'nl'.freeze
+
+        # Portuguese
+        PT = 'pt'.freeze
+
+        # Polish
+        PL = 'pl'.freeze
+
+        # Russian
+        RU = 'ru'.freeze
+
+        # Turkish
+        TR = 'tr'.freeze
+
+        # Mandarin Chinese
+        ZH = 'zh'.freeze
+
+        # Indonesian
+        ID = 'id'.freeze
+
+        # Malay
+        MS = 'ms'.freeze
+
+        # Thai
+        TH = 'th'.freeze
+
+        # Czech
+        CS = 'cs'.freeze
+
+        # Croatian
+        HR = 'hr'.freeze
+
+        # Slovenian
+        SL = 'sl'.freeze
+
+        # Finnish
+        FI = 'fi'.freeze
+
+        # Norwegian
+        NO = 'no'.freeze
+
+        # Danish
+        DA = 'da'.freeze
+
+        # Swedish
+        SV = 'sv'.freeze
+
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/managed_recurring/amount_types.rb

@@ -13,7 +13,7 @@ module GenesisRuby
               FIXED = 'fixed'.freeze
 
               # Amount Type MAX
-              MAX   = 'MAX'.freeze
+              MAX   = 'max'.freeze
 
             end
           end

data/lib/genesis_ruby/api/constants/transactions/parameters/wpf/reminder_channels.rb

@@ -0,0 +1,24 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Wpf
+            # Channel for sending WPF reminder. Valid values are ’email’ and ’sms’
+            class ReminderChannels
+
+              extend Mixins::Constants::Common
+
+              # Channel email
+              EMAIL = 'email'.freeze
+
+              # Channel sms
+              SMS   = 'sms'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/attribute_validation.rb

@@ -0,0 +1,54 @@
+require 'genesis_ruby/errors/request_error'
+
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        # Request Class attribute validations
+        # Reads the pre-set `validation_<attribute>` and perform validation on the fields
+        module AttributeValidation
+
+          protected
+
+          # Perform validation
+          def validate
+            validate_required_fields
+          end
+
+          # Required Fields Accessor
+          def required_fields
+            @required_fields ||= []
+          end
+
+          # Required Fields Accessor
+          def required_fields=(value)
+            raise RequestError, 'Invalid value given for Required Fields! Allowed type Array.' unless value.is_a? Array
+
+            @required_fields = value
+          end
+
+          private
+
+          # Validated Required fields
+          def validate_required_fields
+            required_fields.each do |field_name|
+              if null_or_empty_field?(field_name)
+                raise ParameterError, "Empty (nil) for required parameter: #{field_name}"
+              end
+            end
+          end
+
+          # Validate if the given field_name is null or empty
+          def null_or_empty_field?(field_name)
+            field_value = __send__ field_name.to_sym
+
+            return false if [Integer, Float, TrueClass, FalseClass, DateTime].any? { |type| field_value.is_a? type }
+
+            field_value.nil? || field_value.empty?
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/financial/cards/recurring/recurring_type_attributes.rb

@@ -21,6 +21,13 @@ module GenesisRuby
                                   allow_empty: true
                 end
 
+                protected
+
+                # Minimum required fields with recurring_type subsequent request
+                def recurring_type_subsequent_required_request_attributes
+                  %i[transaction_id amount]
+                end
+
               end
             end
           end

data/lib/genesis_ruby/api/mixins/requests/wpf_reminders_attributes.rb

@@ -0,0 +1,59 @@
+require 'genesis_ruby/utils/options/reminder'
+
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        # Settings for reminders sending when using the ’Pay Later’ feature
+        module WpfRemindersAttributes
+
+          attr_reader :reminder_language
+          attr_writer :reminders
+
+          # It must be a valid language abbreviation
+          def reminder_language=(value)
+            allowed_options attribute: __method__,
+                            allowed: Api::Constants::I18n.all,
+                            value: value.to_s.downcase,
+                            allow_empty: true
+          end
+
+          # Settings for a single reminder. Upto three reminders are allowed
+          def add_reminder(channel:, after:)
+            raise InvalidArgumentError, 'Reminders exceed the allowed count of 3.' if reminders.count >= 3
+
+            reminders << init_reminder(channel: channel, after: after)
+          end
+
+          protected
+
+          # Reminders structure
+          def reminders_structure
+            return reminders if reminders.empty?
+
+            reminders.map &:object_structure
+          end
+
+          private :reminders=
+
+          # Reminder Data Object
+          def init_reminder(channel:, after:)
+            reminder = Utils::Options::Reminder.new
+
+            reminder.channel = channel
+            reminder.after   = after.to_i
+
+            reminder
+          end
+
+          # The number of the sent reminders would be exactly as sent or configured and delivery failures could be
+          # handled on demand. Also there will be no reminders sent if the WPF is already completed
+          def reminders
+            @reminders ||= []
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/request.rb

@@ -9,6 +9,9 @@ module GenesisRuby
     # Base Request Class
     class Request
 
+      include Mixins::Requests::RestrictedSetter
+      include Mixins::Requests::AttributeValidation
+
       PROTOCOL_HTTPS = 'https'.freeze
       PORT_HTTPS     = 443
 
@@ -46,12 +49,12 @@ module GenesisRuby
       attr_reader :configuration, :builder_interface, :builder_context
       attr_accessor :tree_structure
 
-      # Request Configuration
-      def init_configuration; end
-
       # Required fields for the request
       def init_required_fields; end
 
+      # Request Configuration
+      def init_configuration; end
+
       # Pre-defined XML Request Configuration
       def init_xml_configuration
         @api_config.load_xml_config
@@ -121,7 +124,7 @@ module GenesisRuby
 
       # Perform validation over the defined parameters
       def check_requirements
-        # TODO: perform validation over the defined parameters
+        validate
       end
 
       # Build the Genesis API endpoint

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

@@ -7,6 +7,20 @@ module GenesisRuby
 
           include Mixins::Requests::Financial::BaseAttributes
 
+          # Use Smart Router endpoint for the current request
+          def use_smart_router
+            @use_smart_router ||= false
+          end
+
+          # Use Smart Router endpoint for the current request
+          def use_smart_router=(value)
+            unless [true, false].include? value
+              raise InvalidArgumentError, 'Given invalid Use Smart Routing value! Allowed: true, false'
+            end
+
+            @use_smart_router = value
+          end
+
           protected
 
           # Returns the Request transaction type
@@ -24,6 +38,14 @@ module GenesisRuby
             super
             init_xml_configuration
             init_api_gateway_configuration
+            init_api_smart_router_configuration if @configuration.force_smart_routing
+          end
+
+          # Process the request
+          def process_request_parameters
+            init_api_smart_router_configuration if use_smart_router
+
+            super
           end
 
           def populate_structure
@@ -37,6 +59,11 @@ module GenesisRuby
             }
           end
 
+          # Initialize Smart Router endpoint
+          def init_api_smart_router_configuration
+            api_config.url = build_request_url({ subdomain: 'smart_router', path: 'transactions' })
+          end
+
         end
       end
     end

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

@@ -11,6 +11,10 @@ module GenesisRuby
             include Mixins::Requests::Financial::Cards::TokenizationAttributes
             include Mixins::Requests::Financial::PaymentAttributes
 
+            def init_required_fields
+              self.required_fields = %i[transaction_id amount currency]
+            end
+
             protected
 
             # Credit Card attributes

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

@@ -10,6 +10,10 @@ module GenesisRuby
 
           protected
 
+          def init_required_fields
+            self.required_fields = %i[transaction_id reference_id amount currency]
+          end
+
           # Reference transaction request structure
           def reference_transaction_structure
             raise NotImplementedError, 'Reference transaction structure must be implemented.'

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

@@ -6,7 +6,6 @@ module GenesisRuby
         class Capture < Requests::Base::Reference
 
           include Mixins::Requests::Financial::Business::BusinessAttributes
-          include Mixins::Requests::RestrictedSetter
 
           protected
 

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

@@ -23,7 +23,6 @@ module GenesisRuby
             include Mixins::Requests::Financial::ReferenceAttributes
             include Mixins::Requests::Financial::RiskAttributes
             include Mixins::Requests::Financial::ScaAttributes
-            include Mixins::Requests::RestrictedSetter
 
             protected
 
@@ -32,6 +31,12 @@ module GenesisRuby
               GenesisRuby::Api::Constants::Transactions::AUTHORIZE
             end
 
+            def init_required_fields
+              return super unless recurring_type == Constants::Transactions::Parameters::Recurring::Types::SUBSEQUENT
+
+              self.required_fields = recurring_type_subsequent_required_request_attributes
+            end
+
             def payment_transaction_structure # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
               super.merge(
                 gaming:                    gaming,

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

@@ -26,7 +26,6 @@ module GenesisRuby
             include Mixins::Requests::Financial::RiskAttributes
             include Mixins::Requests::Financial::ScaAttributes
             include Mixins::Requests::Financial::Threeds::Version2::CommonAttributes
-            include Mixins::Requests::RestrictedSetter
 
             # Specifies the recurring type of transaction
             def recurring_type=(value)

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

@@ -22,7 +22,6 @@ module GenesisRuby
             include Mixins::Requests::Financial::ReferenceAttributes
             include Mixins::Requests::Financial::RiskAttributes
             include Mixins::Requests::Financial::ScaAttributes
-            include Mixins::Requests::RestrictedSetter
 
             protected
 
@@ -31,6 +30,12 @@ module GenesisRuby
               GenesisRuby::Api::Constants::Transactions::SALE
             end
 
+            def init_required_fields
+              return super unless recurring_type == Constants::Transactions::Parameters::Recurring::Types::SUBSEQUENT
+
+              self.required_fields = recurring_type_subsequent_required_request_attributes
+            end
+
             def payment_transaction_structure # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
               super.merge(
                 gaming:                    gaming,

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

@@ -25,7 +25,6 @@ module GenesisRuby
             include Mixins::Requests::Financial::RiskAttributes
             include Mixins::Requests::Financial::ScaAttributes
             include Mixins::Requests::Financial::Threeds::Version2::CommonAttributes
-            include Mixins::Requests::RestrictedSetter
 
             # Specifies the recurring type of transaction
             def recurring_type=(value)

data/lib/genesis_ruby/api/requests/financial/cards/threeds/v2/method_continue.rb

@@ -11,7 +11,6 @@ module GenesisRuby
               class MethodContinue < Request
 
                 include Mixins::Requests::Financial::PaymentAttributes
-                include Mixins::Requests::RestrictedSetter
 
                 attr_writer :url, :transaction_unique_id, :signature
 
@@ -105,6 +104,10 @@ module GenesisRuby
                   init_api_gateway_configuration request_path: 'threeds/threeds_method/:unique_id', include_token: false
                 end
 
+                def init_required_fields
+                  self.required_fields = %i[amount transaction_timestamp]
+                end
+
                 # Build correct endpoint url during runtime
                 def process_request_parameters
                   @api_config.url = url

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

@@ -7,8 +7,6 @@ module GenesisRuby
         # Refund reference transaction request
         class Refund < Requests::Base::Reference
 
-          include Mixins::Requests::RestrictedSetter
-
           attr_accessor :beneficiary_bank_code, :beneficiary_name, :beneficiary_account_number, :bank, :bank_branch,
                         :bank_account
           attr_reader :bank_account_type

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

@@ -14,6 +14,10 @@ module GenesisRuby
             Api::Constants::Transactions::VOID
           end
 
+          def init_required_fields
+            self.required_fields = %i[transaction_id reference_id]
+          end
+
           # Void transaction request structure
           def payment_transaction_structure
             {

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

@@ -8,8 +8,6 @@ module GenesisRuby
           # The response is paginated, each request will return 100 entries max.
           class DateRange < Api::Request
 
-            include Mixins::Requests::RestrictedSetter
-
             attr_reader :page
 
             # Start of the requested date range (time is optional)
@@ -62,6 +60,10 @@ module GenesisRuby
               @api_config.parser_skip_root_node = false
             end
 
+            def init_required_fields
+              self.required_fields = %i[start_date]
+            end
+
             # API Request structure
             def populate_structure
               @tree_structure = {

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

@@ -1,14 +1,15 @@
 require 'genesis_ruby/utils/transactions/wpf_types'
 require 'genesis_ruby/api/constants/transactions/parameters/sca_exemptions'
+require 'genesis_ruby/api/constants/i18n'
+require 'genesis_ruby/api/mixins/requests/wpf_reminders_attributes'
 
 module GenesisRuby
   module Api
     module Requests
       module Wpf
         # Web-Payment Form Request
-        class Create < Request
+        class Create < Request # rubocop:disable Metrics/ClassLength
 
-          include Mixins::Requests::RestrictedSetter
           include Mixins::Requests::Financial::PaymentAttributes
           include Mixins::Requests::AddressInfoAttributes
           include Mixins::Requests::Financial::AsyncAttributes
@@ -20,10 +21,17 @@ module GenesisRuby
           include Mixins::Requests::Financial::DynamicDescriptorAttributes
           include Mixins::Requests::Financial::RiskAttributes
           include Mixins::Requests::Financial::Business::BusinessAttributes
+          include Mixins::Requests::WpfRemindersAttributes
 
           attr_reader   :locale, :sca_preference, :sca_exemption
           attr_accessor :transaction_id, :usage, :description, :consumer_id, :return_cancel_url, :remember_card,
-                        :lifetime, :web_payment_form_id
+                        :web_payment_form_id
+
+          MAX_LIFETIME     = 131_487
+          DEFAULT_LIFETIME = 30
+
+          private_constant :MAX_LIFETIME
+          private_constant :DEFAULT_LIFETIME
 
           # The transaction types that the merchant is willing to accept payments for
           def add_transaction_type(name, custom_attributes = {})
@@ -38,7 +46,12 @@ module GenesisRuby
 
           # Define ISO 639-1 language code to the URL
           def locale=(value)
-            init_api_wpf_configuration(language: value.to_s.downcase)
+            allowed_options attribute: __method__,
+                            allowed: Constants::I18n.all,
+                            value: value.to_s.downcase,
+                            allow_empty: true
+
+            init_api_wpf_configuration(language: locale)
           end
 
           # Signifies whether to perform SCA on the transaction. At least one 3DS transaction type has to be submitted.
@@ -60,6 +73,41 @@ module GenesisRuby
                             allow_empty: true
           end
 
+          # Signifies whether the ’Pay Later’ feature would be enabled on the WPF
+          def pay_later
+            @pay_later ||= false
+
+            return nil unless @pay_later
+
+            @pay_later
+          end
+
+          # Signifies whether the ’Pay Later’ feature would be enabled on the WPF
+          def pay_later=(value)
+            allowed_options attribute: __method__,
+                            allowed: [true, false],
+                            value: value,
+                            allow_empty: true,
+                            error_message: 'Accepts only boolean values'
+          end
+
+          # A number of minutes determining how long the WPF will be valid. Will be set to 30 minutes by default.
+          def lifetime
+            @lifetime ||= DEFAULT_LIFETIME
+          end
+
+          # A number of minutes determining how long the WPF will be valid. Will be set to 30 minutes by default.
+          def lifetime=(value)
+            lifetime = value.to_i
+
+            if lifetime < 1 || lifetime > MAX_LIFETIME
+              raise InvalidArgumentError,
+                    "Valid value ranges between 1 minute and 3 months (#{MAX_LIFETIME} minutes) given in minutes"
+            end
+
+            @lifetime = lifetime
+          end
+
           protected
 
           # Load base configuration
@@ -68,12 +116,27 @@ 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
+            ]
+          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
+
             super
           end
 
@@ -109,7 +172,9 @@ module GenesisRuby
                 recurring_category:        recurring_category,
                 dynamic_descriptor_params: dynamic_descriptor_structure,
                 risk_params:               risk_parameters_structure,
-                account_owner:             account_owner_attributes_structure
+                account_owner:             account_owner_attributes_structure,
+                pay_later:                 pay_later,
+                reminders:                 pay_later ? reminders_structure : []
               }
             }
           end
@@ -125,6 +190,20 @@ module GenesisRuby
             @transaction_types.push(value)
           end
 
+          # Validate Reminders against the lifetime
+          def validate_reminders
+            return if lifetime.nil?
+
+            reminders.each do |reminder|
+              next unless reminder.after >= lifetime
+
+              raise(
+                ParameterError,
+                "Reminder (#{reminder.after} min) could not be greater than or equal to lifetime (#{lifetime} min)."
+              )
+            end
+          end
+
         end
       end
     end

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

@@ -17,6 +17,10 @@ module GenesisRuby
             @api_config.url = build_request_url subdomain: 'wpf', path: 'wpf/reconcile'
           end
 
+          def init_required_fields
+            self.required_fields = %i[unique_id]
+          end
+
           # WPF Reconcile request structure
           def populate_structure
             @tree_structure = {

data/lib/genesis_ruby/api/response.rb

@@ -54,7 +54,7 @@ module GenesisRuby
 
       # Load the corresponding parser based on the Network header
       def load_parser(network)
-        @parser = GenesisRuby::Parsers.new(GenesisRuby::Parser::JSON) if network.json?
+        @parser = GenesisRuby::Parser.new(GenesisRuby::Parser::JSON) if network.json?
         @parser = GenesisRuby::Parser.new(GenesisRuby::Parser::XML) if network.xml?
 
         raise NetworkError, network.server_message if @parser.nil? || @response_raw.empty?

data/lib/genesis_ruby/configuration.rb

@@ -59,6 +59,11 @@ module GenesisRuby
       @timeout ||= DEFAULT_TIMEOUT
     end
 
+    # Enable Smart Routing for Financial transaction requests
+    def force_smart_routing
+      @force_smart_routing ||= false
+    end
+
     # Genesis Request Timeout
     def timeout=(value)
       timeout = value.to_i
@@ -120,6 +125,15 @@ module GenesisRuby
       @sanitize_response
     end
 
+    # Enable Smart Routing for Financial transaction requests
+    def force_smart_routing=(value)
+      unless [true, false].include? value
+        raise InvalidArgumentError, 'Given invalid Force Smart Routing value! Allowed: true, false'
+      end
+
+      @force_smart_routing = value
+    end
+
     private
 
     # Various definitions for environment
@@ -160,15 +174,19 @@ module GenesisRuby
     # rubocop:enable Metrics/MethodLength
 
     # Available Genesis subdomains
-    def available_sub_domains
+    def available_sub_domains # rubocop:disable Metrics/MethodLength
       {
-        gateway: {
+        gateway:      {
           GenesisRuby::Api::Constants::Environments::PRODUCTION => 'gate.',
           GenesisRuby::Api::Constants::Environments::STAGING    => 'staging.gate.'
         },
-        wpf:     {
+        wpf:          {
           GenesisRuby::Api::Constants::Environments::PRODUCTION => 'wpf.',
           GenesisRuby::Api::Constants::Environments::STAGING    => 'staging.wpf.'
+        },
+        smart_router: {
+          GenesisRuby::Api::Constants::Environments::PRODUCTION => 'prod.api.',
+          GenesisRuby::Api::Constants::Environments::STAGING    => 'staging.api.'
         }
       }
     end

data/lib/genesis_ruby/dependencies.rb

@@ -1,9 +1,10 @@
 # =================================
 # Transaction Request Requirements
 # =================================
+require 'genesis_ruby/api/mixins/requests/attribute_validation'
+require 'genesis_ruby/api/mixins/requests/restricted_setter'
 require 'genesis_ruby/api/request'
 require 'genesis_ruby/api/mixins/constants/common'
-require 'genesis_ruby/api/mixins/requests/restricted_setter'
 
 # =================================
 # Transaction Requests Definitions

data/lib/genesis_ruby/errors/request_error.rb

@@ -0,0 +1,14 @@
+require 'genesis_ruby/errors/error'
+
+module GenesisRuby
+  # Response Custom Error
+  class RequestError < Error
+
+    def custom_message
+      return 'Invalid argument given! ' unless @message
+
+      @message
+    end
+
+  end
+end

data/lib/genesis_ruby/utils/options/reminder.rb

@@ -0,0 +1,60 @@
+require 'genesis_ruby/utils/options/base'
+require 'genesis_ruby/api/constants/transactions/parameters/wpf/reminder_channels'
+
+module GenesisRuby
+  module Utils
+    module Options
+      # Single reminder data object
+      class Reminder < Base
+
+        # Min After minutes
+        MIN_AFTER = 1
+        # Max After minutes
+        MAX_AFTER = 31 * 24 * 60
+
+        def []=(key, value)
+          unless available_keys.include? key.to_s
+            raise InvalidArgumentError, "Invalid Reminder Key given! Allowed: #{available_keys.join(", ")}"
+          end
+
+          __send__ "validate_#{key}", value
+
+          super(key.to_sym, value)
+        end
+
+        # Single Reinder structure
+        def object_structure
+          { reminder: self }
+        end
+
+        private
+
+        # Available Reminder Data keys
+        def available_keys
+          %w(channel after)
+        end
+
+        # Validate Channel value
+        def validate_channel(value)
+          return if Api::Constants::Transactions::Parameters::Wpf::ReminderChannels.all.include? value
+
+          raise InvalidArgumentError,
+                "Invalid Reminder Channel given. Allowed values: #{
+                  Api::Constants::Transactions::Parameters::Wpf::ReminderChannels.all.join(", ")
+                }"
+        end
+
+        # Number of minutes after WPF creation when the reminder should be sent.
+        # Valid value ranges between 1 minute and 31 days given in minutes
+        def validate_after(value)
+          value_int = value.to_i
+
+          return if value_int >= MIN_AFTER && value_int <= MAX_AFTER
+
+          raise InvalidArgumentError, 'Invalid After value given. Allowed integer between 1 and 31'
+        end
+
+      end
+    end
+  end
+end

data/lib/genesis_ruby/version.rb

@@ -1,5 +1,5 @@
 module GenesisRuby
 
-  VERSION = '0.1.4'.freeze
+  VERSION = '0.1.6'.freeze
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: genesis_ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.6
 platform: ruby
 authors:
 - emerchantpay Ltd.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-01-19 00:00:00.000000000 Z
+date: 2024-03-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http
@@ -240,6 +240,7 @@ files:
 - lib/genesis_ruby/api/constants/date_time_formats.rb
 - 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/states.rb
 - lib/genesis_ruby/api/constants/states/state.rb
 - lib/genesis_ruby/api/constants/transactions.rb
@@ -270,8 +271,10 @@ files:
 - lib/genesis_ruby/api/constants/transactions/parameters/threeds/version2/purchase/categories.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/threeds/version2/sdk/interfaces.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/threeds/version2/sdk/ui_types.rb
+- lib/genesis_ruby/api/constants/transactions/parameters/wpf/reminder_channels.rb
 - 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/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
@@ -316,6 +319,7 @@ files:
 - lib/genesis_ruby/api/mixins/requests/financial/threeds/version2/sdk.rb
 - lib/genesis_ruby/api/mixins/requests/financial/threeds/version2/wpf_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/restricted_setter.rb
+- lib/genesis_ruby/api/mixins/requests/wpf_reminders_attributes.rb
 - lib/genesis_ruby/api/notification.rb
 - lib/genesis_ruby/api/request.rb
 - lib/genesis_ruby/api/requests/base/financial.rb
@@ -349,6 +353,7 @@ files:
 - lib/genesis_ruby/errors/object_formatter_error.rb
 - lib/genesis_ruby/errors/parameter_error.rb
 - lib/genesis_ruby/errors/parser_error.rb
+- lib/genesis_ruby/errors/request_error.rb
 - lib/genesis_ruby/errors/response_error.rb
 - lib/genesis_ruby/network/adapter/base_adapter.rb
 - lib/genesis_ruby/network/adapter/net_http_adapter.rb
@@ -372,6 +377,7 @@ files:
 - lib/genesis_ruby/utils/options/api_config.rb
 - lib/genesis_ruby/utils/options/base.rb
 - lib/genesis_ruby/utils/options/network_adapter_config.rb
+- lib/genesis_ruby/utils/options/reminder.rb
 - lib/genesis_ruby/utils/threeds/v2.rb
 - lib/genesis_ruby/utils/transactions/financial_types.rb
 - lib/genesis_ruby/utils/transactions/references/capturable_types.rb