genesis_ruby 0.1.6 → 0.1.8

data/lib/genesis_ruby/api/mixins/requests/financial/travel_data/car_rental_attributes.rb

@@ -0,0 +1,119 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          module TravelData
+            # Car Rental attributes
+            module CarRentalAttributes
+
+              attr_reader :travel_car_rental_purchase_identifier, :travel_car_rental_class_id,
+                          :travel_car_rental_renter_name, :travel_car_rental_return_city,
+                          :travel_car_rental_return_state, :travel_car_rental_return_country,
+                          :travel_car_rental_renter_return_location_id, :travel_car_rental_customer_code,
+                          :travel_car_rental_extra_charges, :travel_car_rental_no_show_indicator
+
+              # Travel Data Purchase Identifier
+              def travel_car_rental_purchase_identifier=(value)
+                limited_string attribute: __method__, value: value, max: 9
+              end
+
+              # Travel Data Class id
+              def travel_car_rental_class_id=(value)
+                allowed_options attribute: __method__,
+                                value: value.to_i,
+                                allow_empty: true,
+                                allowed: [*1..30].push(9999)
+              end
+
+              # Travel Data PickUp Date
+              def travel_car_rental_pickup_date
+                @travel_car_rental_pickup_date&.strftime GenesisRuby::Api::Constants::DateTimeFormats::
+                    DD_MM_YYYY_L_HYPHENS
+              end
+
+              # Travel Data PickUp Date
+              def travel_car_rental_pickup_date=(value)
+                parse_date attribute: __method__, value: value, allow_empty: true
+              end
+
+              # Travel Data Renter Name
+              def travel_car_rental_renter_name=(value)
+                limited_string attribute: __method__, value: value, max: 20
+              end
+
+              # Travel Data Return City
+              def travel_car_rental_return_city=(value)
+                limited_string attribute: __method__, value: value, max: 18
+              end
+
+              # Travel Data Return State
+              def travel_car_rental_return_state=(value)
+                limited_string attribute: __method__, value: value, max: 3
+              end
+
+              # Travel Data Return Country
+              def travel_car_rental_return_country=(value)
+                limited_string attribute: __method__, value: value, max: 3
+              end
+
+              # Travel Data Return Date
+              def travel_car_rental_return_date
+                @travel_car_rental_return_date&.strftime GenesisRuby::Api::Constants::DateTimeFormats::
+                    DD_MM_YYYY_L_HYPHENS
+              end
+
+              # Travel Data Return Date
+              def travel_car_rental_return_date=(value)
+                parse_date attribute: __method__, value: value, allow_empty: true
+              end
+
+              # Travel Data Renter Return Location id
+              def travel_car_rental_renter_return_location_id=(value)
+                limited_string attribute: __method__, value: value, max: 10
+              end
+
+              # Travel Data Customer Code
+              def travel_car_rental_customer_code=(value)
+                limited_string attribute: __method__, value: value, max: 17
+              end
+
+              # Travel Data Extra Charges
+              def travel_car_rental_extra_charges=(value)
+                allowed_options attribute: __method__, value: value.to_i, allow_empty: true, allowed: [*1..5]
+              end
+
+              # Travel Data No Show Indicator
+              def travel_car_rental_no_show_indicator=(value)
+                allowed_options attribute: __method__, value: value.to_i, allow_empty: true, allowed: [0, 1]
+              end
+
+              protected
+
+              # Travel Data Car Rental Attributes Structure
+              def car_rental_attributes_structure # rubocop:disable Metrics/MethodLength
+                {
+                  car_rental: {
+                    purchase_identifier:       travel_car_rental_purchase_identifier,
+                    class_id:                  travel_car_rental_class_id,
+                    pickup_date:               travel_car_rental_pickup_date,
+                    renter_name:               travel_car_rental_renter_name,
+                    return_city:               travel_car_rental_return_city,
+                    return_state:              travel_car_rental_return_state,
+                    return_country:            travel_car_rental_return_country,
+                    return_date:               travel_car_rental_return_date,
+                    renter_return_location_id: travel_car_rental_renter_return_location_id,
+                    customer_code:             travel_car_rental_customer_code,
+                    extra_charges:             travel_car_rental_extra_charges,
+                    no_show_indicator:         travel_car_rental_no_show_indicator
+                  }
+                }
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/financial/travel_data/hotel_rental_attributes.rb

@@ -0,0 +1,77 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          module TravelData
+            # Hotel Rental Attributes
+            module HotelRentalAttributes
+
+              attr_reader :travel_hotel_rental_purchase_identifier, :travel_hotel_rental_customer_code,
+                          :travel_hotel_rental_extra_charges, :travel_hotel_rental_no_show_indicator
+
+              # Hotel Rental Purchase Identifier
+              def travel_hotel_rental_purchase_identifier=(value)
+                limited_string attribute: __method__, value: value, max: 10
+              end
+
+              # Travel Data Arrival date
+              def travel_hotel_rental_arrival_date
+                @travel_hotel_rental_arrival_date&.strftime GenesisRuby::Api::Constants::DateTimeFormats::
+                    DD_MM_YYYY_L_HYPHENS
+              end
+
+              # Travel Data Arrival Date
+              def travel_hotel_rental_arrival_date=(value)
+                parse_date attribute: __method__, value: value, allow_empty: true
+              end
+
+              # Travel Data Departure date
+              def travel_hotel_rental_departure_date
+                @travel_hotel_rental_departure_date&.strftime GenesisRuby::Api::Constants::DateTimeFormats::
+                    DD_MM_YYYY_L_HYPHENS
+              end
+
+              # Travel Data Departure Date
+              def travel_hotel_rental_departure_date=(value)
+                parse_date attribute: __method__, value: value, allow_empty: true
+              end
+
+              # Travel Data Customer Code
+              def travel_hotel_rental_customer_code=(value)
+                limited_string attribute: __method__, value: value, max: 17
+              end
+
+              # Travel Data Extra Charges
+              def travel_hotel_rental_extra_charges=(value)
+                allowed_options attribute: __method__, value: value, allow_empty: true, allowed: [*2..7]
+              end
+
+              # Travel Data No Show Indicator
+              def travel_hotel_rental_no_show_indicator=(value)
+                allowed_options attribute: __method__, value: value, allow_empty: true, allowed: [0, 1]
+              end
+
+              protected
+
+              # Hotel Rental attributes structure
+              def hotel_rental_attributes_structure
+                {
+                  hotel_rental: {
+                    purchase_identifier: travel_hotel_rental_purchase_identifier,
+                    arrival_date:        travel_hotel_rental_arrival_date,
+                    departure_date:      travel_hotel_rental_departure_date,
+                    customer_code:       travel_hotel_rental_customer_code,
+                    extra_charges:       travel_hotel_rental_extra_charges,
+                    no_show_indicator:   travel_hotel_rental_no_show_indicator
+                  }
+                }
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/financial/travel_data/reference_ticket_attributes.rb

@@ -0,0 +1,75 @@
+require 'genesis_ruby/api/constants/transactions/parameters/travel_data/ancillary_charges_types'
+
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          module TravelData
+            # Ancillary Charges
+            module ReferenceTicketAttributes
+
+              attr_reader :travel_ac_ticket_reference_id, :travel_ac_type, :travel_ac_ticket_document_number,
+                          :travel_ac_issued_with_ticket_number, :travel_ac_sub_type
+
+              # Ancillary Charges ticker reference id
+              def travel_ac_ticket_reference_id=(value)
+                limited_string attribute: __method__, value: value, max: 32
+              end
+
+              # Ancillary Charges Type
+              def travel_ac_type=(value)
+                allowed_options attribute:   __method__,
+                                value:       value.to_s.upcase,
+                                allowed:     GenesisRuby::Api::Constants::Transactions::Parameters::TravelData::
+                                    AncillaryChargesTypes.all,
+                                allow_empty: true
+              end
+
+              # Ancillary Charges Ticket document number
+              def travel_ac_ticket_document_number=(value)
+                limited_string attribute: __method__, value: value, max: 15
+              end
+
+              # Ancillary Charges issued with ticket number
+              def travel_ac_issued_with_ticket_number=(value)
+                limited_string attribute: __method__, value: value, max: 15
+              end
+
+              # Ancillary Charges Sub Type
+              def travel_ac_sub_type=(value)
+                allowed_options attribute:   __method__,
+                                value:       value.to_s.upcase,
+                                allowed:     GenesisRuby::Api::Constants::Transactions::Parameters::TravelData::
+                                    AncillaryChargesTypes.all,
+                                allow_empty: true
+              end
+
+              protected
+
+              # Reference Ticket attributes structure
+              def reference_ticket_attributes_structure
+                {
+                  ticket_reference_id:       travel_ac_ticket_reference_id,
+                  ticket_document_number:    travel_ac_ticket_document_number,
+                  issued_with_ticket_number: travel_ac_issued_with_ticket_number
+                }
+              end
+
+              # Ancillary Charges attributes structure
+              def charges_attributes_structure
+                {
+                  charge: {
+                    type:     travel_ac_type,
+                    sub_type: travel_ac_sub_type
+                  }
+                }
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/financial/travel_data/travel_attributes.rb

@@ -0,0 +1,34 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          module TravelData
+            # Travel Data Attributes
+            module TravelAttributes
+
+              include TravelData::AirlineItineraryAttributes
+              include TravelData::CarRentalAttributes
+              include TravelData::HotelRentalAttributes
+              include TravelData::ReferenceTicketAttributes
+
+              protected
+
+              # Travel Data attributes structure
+              def travel_data_attributes_structure
+                {
+                  ticket:  airline_attributes_structure.merge(reference_ticket_attributes_structure),
+                  legs:    legs_structure,
+                  taxes:   taxes_structure,
+                  rentals: car_rental_attributes_structure.merge(hotel_rental_attributes_structure),
+                  charges: charges_attributes_structure
+                }
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

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/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/capture.rb

@@ -6,6 +6,7 @@ module GenesisRuby
         class Capture < Requests::Base::Reference
 
           include Mixins::Requests::Financial::Business::BusinessAttributes
+          include Mixins::Requests::Financial::TravelData::TravelAttributes
 
           protected
 
@@ -18,7 +19,8 @@ module GenesisRuby
           def reference_transaction_structure
             {
               reference_id:        reference_id,
-              business_attributes: business_attributes_structure
+              business_attributes: business_attributes_structure,
+              travel:              travel_data_attributes_structure
             }
           end
 

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

@@ -23,6 +23,7 @@ module GenesisRuby
             include Mixins::Requests::Financial::ReferenceAttributes
             include Mixins::Requests::Financial::RiskAttributes
             include Mixins::Requests::Financial::ScaAttributes
+            include Mixins::Requests::Financial::TravelData::TravelAttributes
 
             protected
 
@@ -31,8 +32,16 @@ module GenesisRuby
               GenesisRuby::Api::Constants::Transactions::AUTHORIZE
             end
 
-            def init_required_fields
-              return super unless recurring_type == Constants::Transactions::Parameters::Recurring::Types::SUBSEQUENT
+            # Request Field validations
+            def init_field_validations
+              super
+
+              field_values.merge! managed_recurring_field_values, recurring_type_field_values_validation_structure
+
+              field_value_dependencies.merge! required_tokenization_fields_conditional, required_cc_fields_conditional,
+                                              required_recurring_managed_type_field_conditional
+
+              return unless recurring_type == Constants::Transactions::Parameters::Recurring::Types::SUBSEQUENT
 
               self.required_fields = recurring_type_subsequent_required_request_attributes
             end
@@ -55,7 +64,8 @@ module GenesisRuby
                 recurring_type:            recurring_type,
                 recurring_category:        recurring_category,
                 sca_params:                sca_attributes_structure,
-                managed_recurring:         managed_recurring_attributes_structure
+                managed_recurring:         managed_recurring_attributes_structure,
+                travel:                    travel_data_attributes_structure
               )
             end
 

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

@@ -26,16 +26,7 @@ module GenesisRuby
             include Mixins::Requests::Financial::RiskAttributes
             include Mixins::Requests::Financial::ScaAttributes
             include Mixins::Requests::Financial::Threeds::Version2::CommonAttributes
-
-            # Specifies the recurring type of transaction
-            def recurring_type=(value)
-              allowed_values = [
-                GenesisRuby::Api::Constants::Transactions::Parameters::Recurring::Types::INITIAL,
-                GenesisRuby::Api::Constants::Transactions::Parameters::Recurring::Types::MANAGED
-              ]
-
-              allowed_options attribute: __method__, allowed: allowed_values, value: value, allow_empty: true
-            end
+            include Mixins::Requests::Financial::TravelData::TravelAttributes
 
             protected
 
@@ -44,6 +35,25 @@ module GenesisRuby
               GenesisRuby::Api::Constants::Transactions::AUTHORIZE_3D
             end
 
+            # Request Field validations
+            def init_field_validations
+              super
+
+              field_values.merge! managed_recurring_field_values,
+                                  recurring_type_initial_field_values_validation_structure, threeds_field_validations
+
+              field_value_dependencies.merge! required_tokenization_fields_conditional, required_cc_fields_conditional,
+                                              required_recurring_managed_type_field_conditional,
+                                              threeds_field_conditional_validations
+            end
+
+            # Special validations upon document building
+            def check_requirements
+              validate_threeds_card_holder_dates
+
+              super
+            end
+
             # Authorize 3D transaction request parameters
             def payment_transaction_structure # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
               super.merge(
@@ -67,7 +77,8 @@ module GenesisRuby
                 recurring_category:        recurring_category,
                 sca_params:                sca_attributes_structure,
                 threeds_v2_params:         threeds_v2_common_attributes_structure,
-                managed_recurring:         managed_recurring_attributes_structure
+                managed_recurring:         managed_recurring_attributes_structure,
+                travel:                    travel_data_attributes_structure
               )
             end
 

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

@@ -22,6 +22,7 @@ module GenesisRuby
             include Mixins::Requests::Financial::ReferenceAttributes
             include Mixins::Requests::Financial::RiskAttributes
             include Mixins::Requests::Financial::ScaAttributes
+            include Mixins::Requests::Financial::TravelData::TravelAttributes
 
             protected
 
@@ -30,8 +31,16 @@ module GenesisRuby
               GenesisRuby::Api::Constants::Transactions::SALE
             end
 
-            def init_required_fields
-              return super unless recurring_type == Constants::Transactions::Parameters::Recurring::Types::SUBSEQUENT
+            # Request Field validations
+            def init_field_validations
+              super
+
+              field_values.merge! managed_recurring_field_values, recurring_type_field_values_validation_structure
+
+              field_value_dependencies.merge! required_tokenization_fields_conditional, required_cc_fields_conditional,
+                                              required_recurring_managed_type_field_conditional
+
+              return unless recurring_type == Constants::Transactions::Parameters::Recurring::Types::SUBSEQUENT
 
               self.required_fields = recurring_type_subsequent_required_request_attributes
             end
@@ -54,7 +63,8 @@ module GenesisRuby
                 recurring_type:            recurring_type,
                 recurring_category:        recurring_category,
                 sca_params:                sca_attributes_structure,
-                managed_recurring:         managed_recurring_attributes_structure
+                managed_recurring:         managed_recurring_attributes_structure,
+                travel:                    travel_data_attributes_structure
               )
             end
 

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

@@ -25,16 +25,7 @@ module GenesisRuby
             include Mixins::Requests::Financial::RiskAttributes
             include Mixins::Requests::Financial::ScaAttributes
             include Mixins::Requests::Financial::Threeds::Version2::CommonAttributes
-
-            # Specifies the recurring type of transaction
-            def recurring_type=(value)
-              allowed_values = [
-                GenesisRuby::Api::Constants::Transactions::Parameters::Recurring::Types::INITIAL,
-                GenesisRuby::Api::Constants::Transactions::Parameters::Recurring::Types::MANAGED
-              ]
-
-              allowed_options attribute: __method__, allowed: allowed_values, value: value, allow_empty: true
-            end
+            include Mixins::Requests::Financial::TravelData::TravelAttributes
 
             protected
 
@@ -43,6 +34,25 @@ module GenesisRuby
               GenesisRuby::Api::Constants::Transactions::SALE_3D
             end
 
+            # Request Field validations
+            def init_field_validations
+              super
+
+              field_values.merge! managed_recurring_field_values,
+                                  recurring_type_initial_field_values_validation_structure, threeds_field_validations
+
+              field_value_dependencies.merge! required_tokenization_fields_conditional, required_cc_fields_conditional,
+                                              required_recurring_managed_type_field_conditional,
+                                              threeds_field_conditional_validations
+            end
+
+            # Special validations upon document building
+            def check_requirements
+              validate_threeds_card_holder_dates
+
+              super
+            end
+
             # Sale 3D transaction request parameters
             def payment_transaction_structure # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
               super.merge(
@@ -66,7 +76,8 @@ module GenesisRuby
                 recurring_category:        recurring_category,
                 sca_params:                sca_attributes_structure,
                 threeds_v2_params:         threeds_v2_common_attributes_structure,
-                managed_recurring:         managed_recurring_attributes_structure
+                managed_recurring:         managed_recurring_attributes_structure,
+                travel:                    travel_data_attributes_structure
               )
             end
 

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

@@ -104,8 +104,8 @@ 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]
+                def init_field_validations
+                  required_fields.push *%i[amount transaction_timestamp]
                 end
 
                 # Build correct endpoint url during runtime

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