genesis_ruby 0.1.7 → 0.1.9

data/lib/genesis_ruby/api/mixins/requests/financial/threeds/version2/browser.rb

@@ -11,10 +11,10 @@ module GenesisRuby
               # Mixin ThreedsV2 Browser Attributes
               module Browser
 
-                attr_reader :threeds_v2_browser_accept_header, :threeds_v2_browser_java_enabled,
-                            :threeds_v2_browser_language, :threeds_v2_browser_color_depth,
+                attr_reader :threeds_v2_browser_accept_header, :threeds_v2_browser_language,
                             :threeds_v2_browser_screen_height, :threeds_v2_browser_screen_width,
                             :threeds_v2_browser_time_zone_offset, :threeds_v2_browser_user_agent
+                attr_accessor :threeds_v2_browser_color_depth, :threeds_v2_browser_java_enabled
 
                 # Exact content of the HTTP accept headers as sent to the 3DS Requester from the Cardholder browser
                 def threeds_v2_browser_accept_header=(value)
@@ -26,17 +26,6 @@ module GenesisRuby
                   limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 8
                 end
 
-                # Value representing the bit depth of the colour palette for displaying images, in bits per pixel
-                def threeds_v2_browser_color_depth=(value)
-                  allowed_depths = GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::
-                      Browser::ColorDepths.all
-
-                  allowed_options attribute:   __method__,
-                                  allowed:     allowed_depths,
-                                  value:       value.to_s.empty? ? nil : value.to_i,
-                                  allow_empty: true
-                end
-
                 # Total height of the Cardholder's screen in pixels
                 def threeds_v2_browser_screen_height=(value)
                   parse_int attribute: __method__, value: value, allow_empty: true
@@ -47,15 +36,6 @@ module GenesisRuby
                   parse_int attribute: __method__, value: value, allow_empty: true
                 end
 
-                # Boolean that represents the ability of the cardholder browser to execute Java
-                def threeds_v2_browser_java_enabled=(value)
-                  allowed_options attribute:     __method__,
-                                  allowed:       [true, false],
-                                  value:         value,
-                                  allow_empty:   true,
-                                  error_message: 'Accepts only boolean values'
-                end
-
                 # Time difference between UTC time and the Cardholder browser local time, in minutes
                 def threeds_v2_browser_time_zone_offset=(value)
                   limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 5
@@ -68,6 +48,15 @@ module GenesisRuby
 
                 protected
 
+                # Browser filed validations structure
+                def threeds_browser_field_validations
+                  {
+                    threeds_v2_browser_color_depth:  Api::Constants::Transactions::Parameters::Threeds::Version2::
+                        Browser::ColorDepths.all,
+                    threeds_v2_browser_java_enabled: [true, false]
+                  }
+                end
+
                 # Request Browser Attributes structure
                 def browser_attributes
                   {

data/lib/genesis_ruby/api/mixins/requests/financial/threeds/version2/card_holder_account.rb

@@ -17,15 +17,15 @@ module GenesisRuby
               # Mixin ThreedsV2 Card holder Account
               module CardHolderAccount # rubocop:disable Metrics/ModuleLength
 
-                attr_reader :threeds_v2_card_holder_account_update_indicator,
-                            :threeds_v2_card_holder_account_password_change_indicator,
-                            :threeds_v2_card_holder_account_shipping_address_usage_indicator,
-                            :threeds_v2_card_holder_account_transactions_activity_last24_hours,
+                attr_reader :threeds_v2_card_holder_account_transactions_activity_last24_hours,
                             :threeds_v2_card_holder_account_transactions_activity_previous_year,
                             :threeds_v2_card_holder_account_provision_attempts_last24_hours,
-                            :threeds_v2_card_holder_account_purchases_count_last6_months,
-                            :threeds_v2_card_holder_account_suspicious_activity_indicator,
-                            :threeds_v2_card_holder_account_registration_indicator
+                            :threeds_v2_card_holder_account_purchases_count_last6_months
+                attr_accessor :threeds_v2_card_holder_account_update_indicator,
+                              :threeds_v2_card_holder_account_password_change_indicator,
+                              :threeds_v2_card_holder_account_shipping_address_usage_indicator,
+                              :threeds_v2_card_holder_account_suspicious_activity_indicator,
+                              :threeds_v2_card_holder_account_registration_indicator
 
                 # Date that the cardholder opened the account with the 3DS Requester.
                 def threeds_v2_card_holder_account_creation_date
@@ -39,14 +39,6 @@ module GenesisRuby
                   parse_date attribute: __method__, value: value, allow_empty: true
                 end
 
-                # Length of time since the cardholder’s account information with the 3DS Requester was last changed
-                def threeds_v2_card_holder_account_update_indicator=(value)
-                  allowed_indicators = GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::
-                      CardHolderAccount::UpdateIndicators.all
-
-                  allowed_options attribute: __method__, allowed: allowed_indicators, value: value, allow_empty: true
-                end
-
                 # Date that the cardholder’s account with the 3DS Requester was last changed
                 def threeds_v2_card_holder_account_last_change_date
                   @threeds_v2_card_holder_account_last_change_date&.strftime(
@@ -59,15 +51,6 @@ module GenesisRuby
                   parse_date attribute: __method__, value: value, allow_empty: true
                 end
 
-                # Length of time since the cardholder account with the 3DS Requester had a password change or
-                # account reset
-                def threeds_v2_card_holder_account_password_change_indicator=(value)
-                  allowed_indicators = GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::
-                      CardHolderAccount::PasswordChangeIndicators.all
-
-                  allowed_options attribute: __method__, allowed: allowed_indicators, value: value, allow_empty: true
-                end
-
                 # Date that cardholder’s account with the 3DS Requester had a password change or account reset
                 def threeds_v2_card_holder_account_password_change_date
                   @threeds_v2_card_holder_account_password_change_date&.strftime(
@@ -80,14 +63,6 @@ module GenesisRuby
                   parse_date attribute: __method__, value: value, allow_empty: true
                 end
 
-                # Indicates when the shipping address used for this transaction was first used with the 3DS Requester
-                def threeds_v2_card_holder_account_shipping_address_usage_indicator=(value)
-                  allowed_indicators = GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::
-                      CardHolderAccount::ShippingAddressUsageIndicators.all
-
-                  allowed_options attribute: __method__, allowed: allowed_indicators, value: value, allow_empty: true
-                end
-
                 # Date when the shipping address used for this transaction was first used with the 3DS Requester
                 def threeds_v2_card_holder_account_shipping_address_date_first_used
                   @threeds_v2_card_holder_account_shipping_address_date_first_used&.strftime(
@@ -120,23 +95,6 @@ module GenesisRuby
                   parse_int attribute: __method__, value: value, allow_empty: true
                 end
 
-                # Indicates whether the 3DS Requester has experienced suspicious activity (including previous fraud)
-                def threeds_v2_card_holder_account_suspicious_activity_indicator=(value)
-                  allowed_indicators = GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::
-                      CardHolderAccount::SuspiciousActivityIndicators.all
-
-                  allowed_options attribute: __method__, allowed: allowed_indicators, value: value, allow_empty: true
-                end
-
-                # Indicates the length of time that the payment account was enrolled in the
-                # cardholder’s account with the 3DS Requester
-                def threeds_v2_card_holder_account_registration_indicator=(value)
-                  allowed_indicators = GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::
-                      CardHolderAccount::RegistrationIndicators.all
-
-                  allowed_options attribute: __method__, allowed: allowed_indicators, value: value, allow_empty: true
-                end
-
                 # Date that the cardholder opened the account with the 3DS Requester.
                 def threeds_v2_card_holder_account_registration_date
                   @threeds_v2_card_holder_account_registration_date&.strftime(
@@ -151,6 +109,33 @@ module GenesisRuby
 
                 protected
 
+                # Card Holder field validations structure
+                def threeds_card_holder_field_validations # rubocop:disable Metrics/MethodLength
+                  {
+                    threeds_v2_card_holder_account_update_indicator:                 Api::Constants::Transactions::
+                        Parameters::Threeds::Version2::CardHolderAccount::UpdateIndicators.all,
+                    threeds_v2_card_holder_account_password_change_indicator:        Api::Constants::Transactions::
+                        Parameters::Threeds::Version2::CardHolderAccount::PasswordChangeIndicators.all,
+                    threeds_v2_card_holder_account_shipping_address_usage_indicator: Api::Constants::Transactions::
+                        Parameters::Threeds::Version2::CardHolderAccount::ShippingAddressUsageIndicators.all,
+                    threeds_v2_card_holder_account_suspicious_activity_indicator:    Api::Constants::Transactions::
+                        Parameters::Threeds::Version2::CardHolderAccount::SuspiciousActivityIndicators.all,
+                    threeds_v2_card_holder_account_registration_indicator:           Api::Constants::Transactions::
+                        Parameters::Threeds::Version2::CardHolderAccount::RegistrationIndicators.all
+                  }
+                end
+
+                def validate_threeds_card_holder_dates
+                  today   = DateTime.now
+                  message = 'must be a valid date in the past.'
+
+                  validate_creation_date today, message
+                  validate_last_change_date today, message
+                  validate_password_change_date today, message
+                  validate_shipping_address_date_first_used today, message
+                  validate_registration_date today, message
+                end
+
                 # Request CardHolder Account Attributes structure
                 # rubocop:disable Layout/LineLength, Metrics/MethodLength
                 def card_holder_account_attributes
@@ -173,6 +158,53 @@ module GenesisRuby
                 end
                 # rubocop:enable Layout/LineLength, Metrics/MethodLength
 
+                private
+
+                # Creation Date Validation
+                def validate_creation_date(less_than, message)
+                  return unless @threeds_v2_card_holder_account_creation_date.is_a? DateTime
+
+                  return if @threeds_v2_card_holder_account_creation_date < less_than
+
+                  raise ParameterError, "Card Holder Account Creation Date #{message}"
+                end
+
+                # Last Change Date validation
+                def validate_last_change_date(less_than, message)
+                  return unless @threeds_v2_card_holder_account_last_change_date.is_a? DateTime
+
+                  return if @threeds_v2_card_holder_account_last_change_date < less_than
+
+                  raise ParameterError, "Card Holder Account Last Change Date #{message}"
+                end
+
+                # Password Change Date validation
+                def validate_password_change_date(less_than, message)
+                  return unless @threeds_v2_card_holder_account_password_change_date.is_a? DateTime
+
+                  return if @threeds_v2_card_holder_account_password_change_date < less_than
+
+                  raise ParameterError, "Card Holder Account Password Change Date #{message}"
+                end
+
+                # Shipping Address Date First Used validation
+                def validate_shipping_address_date_first_used(less_than, message)
+                  return unless @threeds_v2_card_holder_account_shipping_address_date_first_used.is_a? DateTime
+
+                  return if @threeds_v2_card_holder_account_shipping_address_date_first_used < less_than
+
+                  raise ParameterError, "Card Holder Account Shipping Address Date First Used #{message}"
+                end
+
+                # Registration Date validations
+                def validate_registration_date(less_than, message)
+                  return unless @threeds_v2_card_holder_account_registration_date.is_a? DateTime
+
+                  return if @threeds_v2_card_holder_account_registration_date < less_than
+
+                  raise ParameterError, "Card Holder Account Registration Date #{message}"
+                end
+
               end
             end
           end

data/lib/genesis_ruby/api/mixins/requests/financial/threeds/version2/common_attributes.rb

@@ -28,6 +28,29 @@ module GenesisRuby
 
                 protected
 
+                # Threeds Common Attribute Field Validation
+                def threeds_field_validations
+                  {}.merge threeds_control_field_validations, threeds_purchase_field_validations,
+                           threeds_merchant_risk_field_validations, threeds_card_holder_field_validations,
+                           threeds_browser_field_validations, threeds_sdk_field_validations
+                end
+
+                def threeds_field_conditional_validations # rubocop:disable Metrics/MethodLength
+                  {
+                    threeds_v2_control_device_type: Hash[
+                      Api::Constants::Transactions::Parameters::Threeds::Version2::Control::DeviceTypes::BROWSER,
+                      %i[threeds_v2_browser_accept_header threeds_v2_browser_java_enabled threeds_v2_browser_language
+                        threeds_v2_browser_color_depth threeds_v2_browser_screen_height
+                        threeds_v2_browser_screen_width threeds_v2_browser_time_zone_offset
+                        threeds_v2_browser_user_agent],
+                      Api::Constants::Transactions::Parameters::Threeds::Version2::Control::DeviceTypes::APPLICATION,
+                      %i[threeds_v2_sdk_interface threeds_v2_sdk_ui_types threeds_v2_sdk_application_id
+                        threeds_v2_sdk_encrypted_data threeds_v2_sdk_ephemeral_public_key_pair
+                        threeds_v2_sdk_max_timeout threeds_v2_sdk_reference_number]
+                    ]
+                  }
+                end
+
                 # Threeds V2 Web Payment Form Attributes
                 def threeds_v2_common_attributes_structure
                   {

data/lib/genesis_ruby/api/mixins/requests/financial/threeds/version2/control.rb

@@ -12,36 +12,23 @@ module GenesisRuby
               # Mixin ThreedsV2 Control
               module Control
 
-                attr_reader :threeds_v2_control_device_type, :threeds_v2_control_challenge_window_size,
-                            :threeds_v2_control_challenge_indicator
+                attr_accessor :threeds_v2_control_device_type, :threeds_v2_control_challenge_window_size,
+                              :threeds_v2_control_challenge_indicator
 
-                # Identifies the device channel of the consumer
-                def threeds_v2_control_device_type=(value)
-                  allowed_types = GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::Control::
-                      DeviceTypes.all
-
-                  allowed_options attribute: __method__, allowed: allowed_types, value: value, allow_empty: true
-                end
-
-                # Identifies the size of the challenge window for the consumer
-                def threeds_v2_control_challenge_window_size=(value)
-                  allowed_sizes = GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::Control::
-                      ChallengeWindowSizes.all
-
-                  allowed_options attribute: __method__, allowed: allowed_sizes, value: value, allow_empty: true
-                end
-
-                # The value has weight and might impact the decision whether a challenge will be required for the
-                # transaction or not
-                def threeds_v2_control_challenge_indicator=(value)
-                  allowed_indicators = GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::
-                      Control::ChallengeIndicators.all
+                protected
 
-                  allowed_options attribute: __method__, allowed: allowed_indicators, value: value, allow_empty: true
+                # Control field validations structure
+                def threeds_control_field_validations
+                  {
+                    threeds_v2_control_device_type:           Api::Constants::Transactions::Parameters::Threeds::
+                        Version2::Control::DeviceTypes.all,
+                    threeds_v2_control_challenge_window_size: Api::Constants::Transactions::Parameters::Threeds::
+                        Version2::Control::ChallengeWindowSizes.all,
+                    threeds_v2_control_challenge_indicator:   Api::Constants::Transactions::Parameters::Threeds::
+                        Version2::Control::ChallengeIndicators.all
+                  }
                 end
 
-                protected
-
                 # Request Control Attributes structure
                 def control_attributes
                   {

data/lib/genesis_ruby/api/mixins/requests/financial/threeds/version2/merchant_risk.rb

@@ -13,55 +13,12 @@ module GenesisRuby
               # Mixin ThreedsV2 MerchantRisk
               module MerchantRisk
 
-                attr_reader :threeds_v2_merchant_risk_shipping_indicator, :threeds_v2_merchant_risk_delivery_timeframe,
-                            :threeds_v2_merchant_risk_reorder_items_indicator,
-                            :threeds_v2_merchant_risk_pre_order_purchase_indicator, :threeds_v2_merchant_risk_gift_card,
-                            :threeds_v2_merchant_risk_gift_card_count
-
-                # Indicator code that most accurately describes the shipping method
-                def threeds_v2_merchant_risk_shipping_indicator=(value)
-                  allowed_indicators = GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::
-                      MerchantRisk::ShippingIndicators.all
-
-                  allowed_options attribute:   __method__,
-                                  allowed:     allowed_indicators,
-                                  value:       value.to_s,
-                                  allow_empty: true
-                end
-
-                # Indicates the merchandise delivery timeframe
-                def threeds_v2_merchant_risk_delivery_timeframe=(value)
-                  allowed_timeframes = GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::
-                      MerchantRisk::DeliveryTimeframes.all
-
-                  allowed_options attribute:   __method__,
-                                  allowed:     allowed_timeframes,
-                                  value:       value.to_s,
-                                  allow_empty: true
-                end
-
-                # Indicates whether the cardholder is reordering previously purchased merchandise
-                def threeds_v2_merchant_risk_reorder_items_indicator=(value)
-                  allowed_indicators = GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::
-                      MerchantRisk::ReorderItemIndicators.all
-
-                  allowed_options attribute:   __method__,
-                                  allowed:     allowed_indicators,
-                                  value:       value.to_s,
-                                  allow_empty: true
-                end
-
-                # Indicates whether cardholder is placing an order for merchandise with a future-availability
-                # or release date
-                def threeds_v2_merchant_risk_pre_order_purchase_indicator=(value)
-                  allowed_indicators = GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::
-                      MerchantRisk::PreOrderPurchaseIndicators.all
-
-                  allowed_options attribute:   __method__,
-                                  allowed:     allowed_indicators,
-                                  value:       value.to_s,
-                                  allow_empty: true
-                end
+                attr_reader :threeds_v2_merchant_risk_gift_card_count
+                attr_accessor :threeds_v2_merchant_risk_shipping_indicator,
+                              :threeds_v2_merchant_risk_delivery_timeframe,
+                              :threeds_v2_merchant_risk_reorder_items_indicator,
+                              :threeds_v2_merchant_risk_pre_order_purchase_indicator,
+                              :threeds_v2_merchant_risk_gift_card
 
                 # For a pre-ordered purchase, the expected date that the merchandise will be available
                 def threeds_v2_merchant_risk_pre_order_date
@@ -75,15 +32,6 @@ module GenesisRuby
                   parse_date attribute: __method__, value: value, allow_empty: true
                 end
 
-                # Prepaid or gift card purchase
-                def threeds_v2_merchant_risk_gift_card=(value)
-                  allowed_options attribute:     __method__,
-                                  allowed:       [true, false],
-                                  value:         value,
-                                  allow_empty:   true,
-                                  error_message: 'Accepts only boolean values'
-                end
-
                 # For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased
                 def threeds_v2_merchant_risk_gift_card_count=(value)
                   parse_int attribute: __method__, value: value, allow_empty: true
@@ -91,6 +39,21 @@ module GenesisRuby
 
                 protected
 
+                # Merchant Risk field validations structure
+                def threeds_merchant_risk_field_validations # rubocop:disable Metrics/MethodLength
+                  {
+                    threeds_v2_merchant_risk_shipping_indicator:           Api::Constants::Transactions::Parameters::
+                        Threeds::Version2::MerchantRisk::ShippingIndicators.all,
+                    threeds_v2_merchant_risk_delivery_timeframe:           Api::Constants::Transactions::Parameters::
+                        Threeds::Version2::MerchantRisk::DeliveryTimeframes.all,
+                    threeds_v2_merchant_risk_reorder_items_indicator:      Api::Constants::Transactions::Parameters::
+                        Threeds::Version2::MerchantRisk::ReorderItemIndicators.all,
+                    threeds_v2_merchant_risk_pre_order_purchase_indicator: Api::Constants::Transactions::Parameters::
+                        Threeds::Version2::MerchantRisk::PreOrderPurchaseIndicators.all,
+                    threeds_v2_merchant_risk_gift_card:                    [true, false]
+                  }
+                end
+
                 # Request Merchant Risk Attributes structure
                 def merchant_risk_attributes
                   {

data/lib/genesis_ruby/api/mixins/requests/financial/threeds/version2/purchase.rb

@@ -10,21 +10,18 @@ module GenesisRuby
               # Mixin ThreedsV2 Purchase
               module Purchase
 
-                attr_reader :threeds_v2_purchase_category
+                attr_accessor :threeds_v2_purchase_category
 
-                # Identifies the type of transaction being authenticated
-                def threeds_v2_purchase_category=(value)
-                  allowed_indicators = GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::
-                      Purchase::Categories.all
+                protected
 
-                  allowed_options attribute:   __method__,
-                                  allowed:     allowed_indicators,
-                                  value:       value.to_s,
-                                  allow_empty: true
+                # Purchase field validations structure
+                def threeds_purchase_field_validations
+                  {
+                    threeds_v2_purchase_category: Api::Constants::Transactions::Parameters::Threeds::Version2::
+                        Purchase::Categories.all
+                  }
                 end
 
-                protected
-
                 # Request Purchase Attributes structure
                 def purchase_attributes
                   {

data/lib/genesis_ruby/api/mixins/requests/financial/threeds/version2/sdk.rb

@@ -12,18 +12,10 @@ module GenesisRuby
               # Mixin ThreedsV2 SDK
               module Sdk
 
-                attr_reader :threeds_v2_sdk_interface, :threeds_v2_sdk_application_id, :threeds_v2_sdk_encrypted_data,
+                attr_reader :threeds_v2_sdk_application_id, :threeds_v2_sdk_encrypted_data,
                             :threeds_v2_sdk_ephemeral_public_key_pair, :threeds_v2_sdk_max_timeout,
                             :threeds_v2_sdk_reference_number
-
-                # SDK Interface types that the device of the consumer supports for displaying specific challenge
-                # interfaces within the SDK
-                def threeds_v2_sdk_interface=(value)
-                  allowed_interfaces = GenesisRuby::Api::Constants::Transactions::Parameters::Threeds::Version2::Sdk::
-                      Interfaces.all
-
-                  allowed_options attribute: __method__, allowed: allowed_interfaces, value: value, allow_empty: true
-                end
+                attr_accessor :threeds_v2_sdk_interface
 
                 # UI type that the device of the consumer supports for displaying specific challenge interface
                 def threeds_v2_sdk_ui_types
@@ -84,6 +76,14 @@ module GenesisRuby
 
                 protected
 
+                # SDK field validations
+                def threeds_sdk_field_validations
+                  {
+                    threeds_v2_sdk_interface: Api::Constants::Transactions::Parameters::Threeds::Version2::Sdk::
+                        Interfaces.all
+                  }
+                end
+
                 # Request SDK Attributes structure
                 def sdk_attributes
                   {

data/lib/genesis_ruby/api/mixins/requests/financial/threeds/version2/wpf_attributes.rb

@@ -32,6 +32,15 @@ module GenesisRuby
 
                 protected
 
+                # Threeds Common Attribute Field Validation
+                def threeds_field_validations
+                  control_validations = threeds_control_field_validations
+                  control_validations.delete(:threeds_v2_control_device_type)
+
+                  {}.merge control_validations, threeds_purchase_field_validations,
+                           threeds_merchant_risk_field_validations, threeds_card_holder_field_validations
+                end
+
                 # Request Control Attributes structure available for the Web Payment Form
                 def control_attributes
                   {

data/lib/genesis_ruby/api/request.rb

@@ -27,7 +27,7 @@ module GenesisRuby
         @api_config        = GenesisRuby::Utils::Options::ApiConfig.new
 
         init_configuration
-        init_required_fields
+        init_field_validations
       end
 
       # Generate the Request Document based on the builder_interface
@@ -50,7 +50,7 @@ module GenesisRuby
       attr_accessor :tree_structure
 
       # Required fields for the request
-      def init_required_fields; end
+      def init_field_validations; end
 
       # Request Configuration
       def init_configuration; end
@@ -146,6 +146,8 @@ module GenesisRuby
 
       # Transform amount to minor currency format
       def transform_amount(amount, currency)
+        return amount if amount.nil? || !GenesisRuby::Api::Constants::Currencies::Iso4217.valid?(currency)
+
         GenesisRuby::Utils::MoneyFormat.amount_to_exponent amount, currency
       end
 

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

@@ -11,12 +11,14 @@ 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
 
+            # Request Field validations
+            def init_field_validations
+              required_fields.push *%i[transaction_id amount currency]
+              field_values.merge! currency: Api::Constants::Currencies::Iso4217.all.map(&:upcase)
+            end
+
             # Credit Card attributes
             def payment_transaction_structure
               payment_attributes_structure.merge(

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

@@ -0,0 +1,59 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Base
+        module Financials
+          # South American Payments base class
+          class SouthAmericanPayments < Base::Financial
+
+            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
+            def billing_country
+              return nil unless @billing_country
+
+              @billing_country.to_s.upcase
+            end
+
+            protected
+
+            # Defines allowed billing countries
+            def allowed_billing_countries
+              raise NoMethodError, 'South American Payment requests require definition of allowed billing countries'
+            end
+
+            def init_field_validations
+              super
+
+              required_fields.push *%i[transaction_id return_success_url return_failure_url amount currency
+                consumer_reference national_id customer_email billing_country]
+
+              field_values.merge! billing_country: allowed_billing_countries
+            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
+                }
+              )
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -10,8 +10,9 @@ module GenesisRuby
 
           protected
 
-          def init_required_fields
-            self.required_fields = %i[transaction_id reference_id amount currency]
+          def init_field_validations
+            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

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

@@ -0,0 +1,26 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module Cards
+          # Argencard is a debit or credit card used in Argentina.
+          class Argencard < Base::Financials::SouthAmericanPayments
+
+            protected
+
+            # Argencard transaction type
+            def transaction_type
+              Api::Constants::Transactions::ARGENCARD
+            end
+
+            # Argencard allowed billing countries
+            def allowed_billing_countries
+              %w(AR)
+            end
+
+          end
+        end
+      end
+    end
+  end
+end