genesis_ruby 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3bae58236ea63ffb79254010e7dd8651252a8f128eb3c9e245eaf6cc4588c426
-  data.tar.gz: e9bc31285e5acceefe5df452d274445f6b88e3039115d313ea1361b9990cc149
+  metadata.gz: 5629a8aa5e0635fa0106507b7ca62e605065007441fff2479c1ec390237d8382
+  data.tar.gz: c618d130f46775abfeda2cc340050c6cdb5492fcd97ba64a2bc0bafac5db086b
 SHA512:
-  metadata.gz: 235e870d4dc316eface0f780352fe0129293740742ab45b6638d839cf51cbd9296e193be9a9cf533da6f1c089e39885e47fbf4220523a715a1db8c3c821a3b6c
-  data.tar.gz: 346de3c0848acea9c8394323b8377fc1fb86eab52fa125f30586dcb71bf0f2422d7f128fe3152547284274ca5eddde44a1a1d96206d9391bcf65525669f46529
+  metadata.gz: 592d0e476d4e7a0bb1920eef3c807ff420adb6c35e3bd32a6ad1bef6e7582ddc90d4b1b4d7d1998d9873865af22ded0c7bcacc2950331234705f1658a61a71f9
+  data.tar.gz: c3d712b3f128740ce84d32bad8302e030fc2826cb0f0b06cfaec1e26e2e96efe0ef2f271e6afe869b72b9db823f0724644dab4b3b30a1e6240008cc740617a8a

data/CHANGELOG.md

@@ -1,3 +1,19 @@
+0.1.7
+-----
+**Features**:
+
+* Removed GiroPay transaction type support through the Web Payment Form
+* Added Protocol Sub Version parameter support part of the MPI attributes
+* Added Level 3 Travel Data attributes support to the following transaction requests:
+  * Sale
+  * Sale 3D
+  * Authorize
+  * Authorize 3D
+  * Init Recurring Sale
+  * Init Recurring Sale 3D
+  * RecurringSale
+  * Capture
+
 0.1.6
 -----
 **Features**:

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    genesis_ruby (0.1.6)
+    genesis_ruby (0.1.7)
       net-http (~> 0.3.2)
       nokogiri (~> 1.14)
 
@@ -39,14 +39,12 @@ GEM
     json (2.7.1)
     language_server-protocol (3.17.0.3)
     mini_mime (1.1.5)
-    mini_portile2 (2.8.5)
     multi_xml (0.6.0)
     mustermann (3.0.0)
       ruby2_keywords (~> 0.0.1)
     net-http (0.3.2)
       uri
-    nokogiri (1.15.6)
-      mini_portile2 (~> 2.8.2)
+    nokogiri (1.16.6-x86_64-darwin)
       racc (~> 1.4)
     octokit (7.2.0)
       faraday (>= 1, < 3)

data/README.md

@@ -1,11 +1,13 @@
 
-# Genesis Ruby
-
+Genesis Ruby
+========
+[![Gem Version](https://badge.fury.io/rb/genesis_ruby.svg)](https://badge.fury.io/rb/genesis_ruby)
 [![Software License](https://img.shields.io/badge/license-MIT-green.svg?style=flat)](LICENSE)
 
 Ruby Client for Genesis Payment Processing Gateway
 
-## Overview
+Overview
+--------
 
 Client Library for processing payments through Genesis Payment Processing Gateway. Its highly recommended to checkout "Genesis Payment Gateway API Documentation" first, in order to get an overview of Genesis's Payment Gateway API and functionality.
 
@@ -485,6 +487,89 @@ request.recurring_type = GenesisRuby::Api::Constants::Transactions::Parameters::
   ```
   </details>
 
+#### Level 3 Travel Data
+Level 3 travel data is supplied as optional data to the standard API request. If the supplied is valid travel data then the transaction will be processed as a travel transaction and will qualify for the travel Incentive rates. Otherwise the transaction will be processed normally as a regular transaction. Note that the travel data will be stored as part of the transaction in all cases.
+
+<details>
+<summary>Example Leg Data</summary>
+
+```ruby
+GenesisRuby::Utils::Transactions::TravelData::AirlineItinerary::Leg.new departure_date:         '2034-12-31',
+                                                                        arrival_date:           '2034-12-31',
+                                                                        carrier_code:           12,
+                                                                        service_class:          1,
+                                                                        origin_city:            'VAR',
+                                                                        destination_city:       'FRA',
+                                                                        stopover_code:          0,
+                                                                        fare_basis_code:        1,
+                                                                        flight_number:          'W1234',
+                                                                        departure_time:         '11:37',
+                                                                        departure_time_segment: 'P'
+```
+
+</details>
+
+<details>
+<summary>Example Tax Data</summary>
+
+```ruby
+GenesisRuby::Utils::Transactions::TravelData::AirlineItinerary::Tax.new fee_type: 'type', 
+                                                                        fee_amount: 0.99 # will converted automatically to minor format based on the currency
+```
+
+</details>
+
+<details>
+<summary>Example Level 3 Travel Data</summary>
+
+```ruby
+# Ticket attributes
+request.travel_aid_ticket_number               = '123456789012345'
+request.travel_aid_passenger_name              = 'Test Example'
+request.travel_aid_customer_code               = 1
+request.travel_aid_issuing_carrier             = 'AAAA'
+request.travel_aid_total_fare                  = '0.99' # will converted automatically to minor format based on the currency
+request.travel_aid_agency_name                 = 'Agency'
+request.travel_aid_agency_code                 = 'AG001'
+request.travel_aid_date_of_issue               = '2018-02-01'
+request.travel_aid_restricted_ticket_indicator = 1
+request.travel_aid_confirmation_information    = 'Confirmation'
+
+request.add_travel_aid_leg leg
+request.add_travel_aid_tax tax
+
+# Car rental
+request.travel_car_rental_purchase_identifier       = '12478'
+request.travel_car_rental_class_id                  = 3
+request.travel_car_rental_pickup_date               = '2034-12-31'
+request.travel_car_rental_renter_name               = 'John Smith'
+request.travel_car_rental_return_city               = 'Varna'
+request.travel_car_rental_return_state              = 'VAR'
+request.travel_car_rental_return_country            = 'BGR'
+request.travel_car_rental_return_date               = '2034-12-31'
+request.travel_car_rental_renter_return_location_id = '12478'
+request.travel_car_rental_customer_code             = 1
+request.travel_car_rental_extra_charges             = 2
+request.travel_car_rental_no_show_indicator         = 1
+
+# Hotel Rental attributes
+request.travel_hotel_rental_purchase_identifier = '12478'
+request.travel_hotel_rental_arrival_date        = '2034-12-31'
+request.travel_hotel_rental_departure_date      = '2034-12-31'
+request.travel_hotel_rental_customer_code       = '12478'
+request.travel_hotel_rental_no_show_indicator   = 1
+
+# Reference Ticket Attributes
+request.travel_ac_ticket_reference_id       = '8b7e3575e5605ea7e1895707a3e92837'
+request.travel_ac_ticket_document_number    = '1111'
+request.travel_ac_issued_with_ticket_number = '12321'
+
+# Ancillary Charges
+request.travel_ac_type     = 'BF'
+request.travel_ac_sub_type = 'BG'
+```
+
+</details>
 
 ## Response
 

data/VERSION

@@ -1 +1 @@
-0.1.6
+0.1.7

data/lib/genesis_ruby/api/constants/transactions/parameters/mpi_protocol_sub_versions.rb

@@ -0,0 +1,43 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          # Mpi Protocol Versions allowed values
+          class MpiProtocolSubVersions
+
+            extend Mixins::Constants::Common
+
+            # Sub-protocol Version 1
+            PROTOCOL_SUB_VERSION_1 = 1
+
+            # Sub-protocol Version 2
+            PROTOCOL_SUB_VERSION_2 = 2
+
+            # Sub-protocol Version 3
+            PROTOCOL_SUB_VERSION_3 = 3
+
+            # Sub-protocol Version 4
+            PROTOCOL_SUB_VERSION_4 = 4
+
+            # Sub-protocol Version 5
+            PROTOCOL_SUB_VERSION_5 = 5
+
+            # Sub-protocol Version 6
+            PROTOCOL_SUB_VERSION_6 = 6
+
+            # Sub-protocol Version 7
+            PROTOCOL_SUB_VERSION_7 = 7
+
+            # Sub-protocol Version 8
+            PROTOCOL_SUB_VERSION_8 = 8
+
+            # Sub-protocol Version 9
+            PROTOCOL_SUB_VERSION_9 = 9
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/travel_data/ancillary_charges_types.rb

@@ -0,0 +1,43 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module TravelData
+            # Ancillary Charges Types
+            # Identify the Service Category Code for the primary type of service that has been provided
+            class AncillaryChargesTypes
+
+              extend Mixins::Constants::Common
+
+              BF = 'BF'.freeze
+              BG = 'BG'.freeze
+              CF = 'CF'.freeze
+              CG = 'CG'.freeze
+              CO = 'CO'.freeze
+              FF = 'FF'.freeze
+              GF = 'GF'.freeze
+              GT = 'GT'.freeze
+              IE = 'IE'.freeze
+              LG = 'LG'.freeze
+              MD = 'MD'.freeze
+              ML = 'ML'.freeze
+              OT = 'OT'.freeze
+              PA = 'PA'.freeze
+              PT = 'PT'.freeze
+              SA = 'SA'.freeze
+              SB = 'SB'.freeze
+              SF = 'SF'.freeze
+              ST = 'ST'.freeze
+              TS = 'TS'.freeze
+              UN = 'UN'.freeze
+              UP = 'UP'.freeze
+              WI = 'WI'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -115,10 +115,6 @@ module GenesisRuby
         # They can also be refunded.
         FASHIONCHEQUE = 'fashioncheque'.freeze
 
-        # GiroPay
-        # Direct PPRO transaction
-        GIROPAY = 'giropay'.freeze
-
         # Google Pay allows shoppers to purchase with credit and debit cards linked to their Google account.
         GOOGLE_PAY = 'google_pay'.freeze
 
@@ -260,7 +256,7 @@ module GenesisRuby
         # PostFinance is an online banking provider in Switzerland
         POST_FINANCE = 'post_finance'.freeze
 
-        # Supports payments via EPS, SafetyPay, TrustPay, ELV, Przelewy24, and GiroPay
+        # Supports payments via EPS, SafetyPay, TrustPay, ELV, Przelewy24
         PPRO = 'ppro'.freeze
 
         # PSE (Pagos Seguros en Linea) is the preferred alternative payment solution in Colombia.

data/lib/genesis_ruby/api/mixins/requests/financial/cards/mpi_attributes.rb

@@ -1,4 +1,5 @@
 require 'genesis_ruby/api/constants/transactions/parameters/mpi_protocol_versions'
+require 'genesis_ruby/api/constants/transactions/parameters/mpi_protocol_sub_versions'
 
 module GenesisRuby
   module Api
@@ -9,9 +10,8 @@ module GenesisRuby
             # Mixin Mpi Attributes
             module MpiAttributes
 
-              attr_reader :mpi_threeds_challenge_indicator, :mpi_protocol_version
-              attr_accessor :mpi_cavv, :mpi_eci, :mpi_xid, :mpi_directory_server_id,
-                            :mpi_asc_transaction_id
+              attr_reader :mpi_threeds_challenge_indicator, :mpi_protocol_version, :mpi_protocol_sub_version
+              attr_accessor :mpi_cavv, :mpi_eci, :mpi_xid, :mpi_directory_server_id, :mpi_asc_transaction_id
 
               # The used 3DS protocol version. Default is 1 if not supplied.
               def mpi_protocol_version=(value)
@@ -31,6 +31,15 @@ module GenesisRuby
                 allowed_options attribute: __method__, allowed: allowed_indicators, value: value, allow_empty: true
               end
 
+              # The used 3DSv2 authentication protocol.
+              def mpi_protocol_sub_version=(value)
+                allowed_options attribute:   __method__,
+                                allowed:     GenesisRuby::Api::Constants::Transactions::Parameters::
+                                    MpiProtocolSubVersions.all,
+                                value:       value.to_i,
+                                allow_empty: true
+              end
+
               protected
 
               # Mpi Attributes Structure
@@ -41,7 +50,8 @@ module GenesisRuby
                   protocol_version:            mpi_protocol_version,
                   directory_server_id:         mpi_directory_server_id,
                   acs_transaction_id:          mpi_asc_transaction_id,
-                  threeds_challenge_indicator: mpi_threeds_challenge_indicator
+                  threeds_challenge_indicator: mpi_threeds_challenge_indicator,
+                  protocol_sub_version:        mpi_protocol_sub_version
                 }
               end
 

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

@@ -1,3 +1,5 @@
+require 'genesis_ruby/api/constants/transactions/parameters/managed_recurring/modes'
+require 'genesis_ruby/api/constants/transactions/parameters/managed_recurring/intervals'
 require 'genesis_ruby/api/mixins/requests/financial/cards/recurring/managed_recurring_indian_card_attributes'
 
 module GenesisRuby

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

@@ -1,3 +1,7 @@
+require 'genesis_ruby/api/constants/transactions/parameters/managed_recurring/payment_types'
+require 'genesis_ruby/api/constants/transactions/parameters/managed_recurring/amount_types'
+require 'genesis_ruby/api/constants/transactions/parameters/managed_recurring/frequencies'
+
 module GenesisRuby
   module Api
     module Mixins

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

@@ -0,0 +1,166 @@
+require 'genesis_ruby/utils/transactions/travel_data/airline_itinerary/leg'
+require 'genesis_ruby/utils/transactions/travel_data/airline_itinerary/tax'
+
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          module TravelData
+            # Level 3 Data Airline Itinerary Attributes
+            module AirlineItineraryAttributes
+
+              attr_reader :travel_aid_restricted_ticket_indicator, :travel_aid_ticket_number,
+                          :travel_aid_passenger_name, :travel_aid_customer_code, :travel_aid_issuing_carrier,
+                          :travel_aid_agency_name, :travel_aid_agency_code
+              attr_accessor :travel_aid_total_fare, :travel_aid_confirmation_information
+
+              # Date Of Issue
+              def travel_aid_date_of_issue
+                @travel_aid_date_of_issue&.strftime GenesisRuby::Api::Constants::DateTimeFormats::DD_MM_YYYY_L_HYPHENS
+              end
+
+              # Date Of Issue
+              def travel_aid_date_of_issue=(value)
+                parse_date attribute: __method__, value: value, allow_empty: true
+              end
+
+              # Restricted Ticket Indicator
+              def travel_aid_restricted_ticket_indicator=(value)
+                allowed_options attribute: __method__, value: value.to_i, allow_empty: true, allowed: [0, 1]
+              end
+
+              # Ticket Number
+              def travel_aid_ticket_number=(value)
+                limited_string attribute: __method__, value: value, max: 15
+              end
+
+              # Passenger name
+              def travel_aid_passenger_name=(value)
+                limited_string attribute: __method__, value: value, max: 29
+              end
+
+              # Customer code
+              def travel_aid_customer_code=(value)
+                limited_string attribute: __method__, value: value, max: 17
+              end
+
+              # Issuing carrier
+              def travel_aid_issuing_carrier=(value)
+                limited_string attribute: __method__, value: value, max: 4
+              end
+
+              # Agency name
+              def travel_aid_agency_name=(value)
+                limited_string attribute: __method__, value: value, max: 30
+              end
+
+              # Agency code
+              def travel_aid_agency_code=(value)
+                limited_string attribute: __method__, value: value, max: 8
+              end
+
+              # AirlineItinerary Legs data. Max legs 10
+              def travel_aid_legs
+                @travel_aid_legs || []
+              end
+
+              # AirlineItinerary Taxes data. Max taxes 10
+              def travel_aid_taxes
+                @travel_aid_taxes || []
+              end
+
+              # Add a single AirlineItinerary Leg data
+              def add_travel_aid_leg(leg)
+                @travel_aid_legs ||= travel_aid_legs
+                leg_obj      = GenesisRuby::Utils::Transactions::TravelData::AirlineItinerary::Leg
+
+                raise InvalidArgumentError, "Leg must be instance of #{leg_obj.name}" unless leg.instance_of? leg_obj
+
+                if travel_aid_legs.count == ALLOWED_ITEMS_COUNT
+                  raise InvalidArgumentError, "Allowed Legs count exceeded. Allowed #{ALLOWED_ITEMS_COUNT}."
+                end
+
+                @travel_aid_legs.push leg
+              end
+
+              # Add a single AirlineItinerary Tax data
+              def add_travel_aid_tax(tax)
+                @travel_aid_taxes ||= travel_aid_taxes
+                tax_obj       = GenesisRuby::Utils::Transactions::TravelData::AirlineItinerary::Tax
+
+                raise InvalidArgumentError, "Tax must be instance of #{tax_obj.name}" unless tax.instance_of? tax_obj
+
+                if travel_aid_taxes.count == ALLOWED_ITEMS_COUNT
+                  raise InvalidArgumentError, "Allowed Legs count exceeded. Allowed #{ALLOWED_ITEMS_COUNT}."
+                end
+
+                @travel_aid_taxes.push tax
+              end
+
+              # Reset Legs data
+              def clear_travel_aid_legs
+                @travel_aid_legs = []
+              end
+
+              # Reset Taxes
+              def clear_travel_aid_taxes
+                @travel_aid_taxes = []
+              end
+
+              protected
+
+              ALLOWED_ITEMS_COUNT = 10
+
+              # Legs structure
+              def legs_structure
+                parse_items 'leg', travel_aid_legs
+              end
+
+              # Taxes structure
+              def taxes_structure
+                parse_items 'tax', travel_aid_taxes
+              end
+
+              # Prepare structure
+              def parse_items(node_name, items)
+                data = []
+
+                items.each do |item|
+                  item.currency = currency if item.respond_to?(:currency) && respond_to?(:currency)
+                  data.push item.attributes_structure
+                end
+
+                Hash[node_name.to_sym, data]
+              end
+
+              # Attributes Structure
+              def airline_attributes_structure # rubocop:disable RSpec/MethodLength
+                {
+                  ticket_number:               travel_aid_ticket_number,
+                  passenger_name:              travel_aid_passenger_name,
+                  customer_code:               travel_aid_customer_code,
+                  restricted_ticket_indicator: travel_aid_restricted_ticket_indicator,
+                  issuing_carrier:             travel_aid_issuing_carrier,
+                  total_fare:                  parse_total_fare,
+                  agency_name:                 travel_aid_agency_name,
+                  agency_code:                 travel_aid_agency_code,
+                  confirmation_information:    travel_aid_confirmation_information,
+                  date_of_issue:               travel_aid_date_of_issue
+                }
+              end
+
+              # Parse Total Fare amount
+              def parse_total_fare
+                return travel_aid_total_fare if currency.nil? || travel_aid_total_fare.nil?
+
+                transform_amount travel_aid_total_fare, currency
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

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/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
 
@@ -55,7 +56,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,6 +26,7 @@ module GenesisRuby
             include Mixins::Requests::Financial::RiskAttributes
             include Mixins::Requests::Financial::ScaAttributes
             include Mixins::Requests::Financial::Threeds::Version2::CommonAttributes
+            include Mixins::Requests::Financial::TravelData::TravelAttributes
 
             # Specifies the recurring type of transaction
             def recurring_type=(value)
@@ -67,7 +68,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
 
@@ -54,7 +55,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,6 +25,7 @@ module GenesisRuby
             include Mixins::Requests::Financial::RiskAttributes
             include Mixins::Requests::Financial::ScaAttributes
             include Mixins::Requests::Financial::Threeds::Version2::CommonAttributes
+            include Mixins::Requests::Financial::TravelData::TravelAttributes
 
             # Specifies the recurring type of transaction
             def recurring_type=(value)
@@ -66,7 +67,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/builders/xml.rb

@@ -86,6 +86,12 @@ module GenesisRuby
       # Build XMl Document part from Array
       def build_array(element_name, element_value)
         element_value.each do |tag_value|
+          if tag_value.is_a? Hash
+            add_node element_name, tag_value
+
+            next
+          end
+
           add_element element_name, tag_value
         end
       end

data/lib/genesis_ruby/utils/transactions/financial_types.rb

@@ -19,7 +19,7 @@ module GenesisRuby
               EFECTY, ELO, EPS,
               EZEECARD_PAYOUT, EZEEWALLET,
               FASHIONCHEQUE,
-              GIROPAY, GOOGLE_PAY,
+              GOOGLE_PAY,
               IDEAL, IDEBIT_PAYIN, IDEBIT_PAYOUT, INCREMENTAL_AUTHORIZE, INSTA_DEBIT_PAYIN, INSTA_DEBIT_PAYOUT,
               INTERSOLVE, ITAU,
               MULTIBANCO, MY_BANK,

data/lib/genesis_ruby/utils/transactions/references/refundable_types.rb

@@ -17,7 +17,7 @@ module GenesisRuby
                 CAPTURE, CASHU,
                 DAVIVIENDA,
                 EFECTY, EPS, FASHIONCHEQUE,
-                GIROPAY, GOOGLE_PAY,
+                GOOGLE_PAY,
                 IDEAL, IDEBIT_PAYIN, INIT_RECURRING_SALE, INIT_RECURRING_SALE_3D, INVOICE_CAPTURE, ITAU,
                 MY_BANK,
                 NEOSURF,

data/lib/genesis_ruby/utils/transactions/travel_data/airline_itinerary/base.rb

@@ -0,0 +1,33 @@
+module GenesisRuby
+  module Utils
+    module Transactions
+      module TravelData
+        module AirlineItinerary
+          # Airline Itinerary Data base class
+          class Base
+
+            include Api::Mixins::Requests::RestrictedSetter
+
+            # Constructor
+            def initialize(params = {}) # rubocop:disable Style/OptionHash
+              parse_attributes params if params.is_a? Hash
+
+              super()
+            end
+
+            # Item attribute structure
+            def attributes_structure; end
+
+            protected
+
+            # Initialize attributes
+            def parse_attributes(params)
+              params.each { |key, value| __send__ "#{key}=", value }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/utils/transactions/travel_data/airline_itinerary/leg.rb

@@ -0,0 +1,97 @@
+require 'genesis_ruby/utils/transactions/travel_data/airline_itinerary/base'
+
+module GenesisRuby
+  module Utils
+    module Transactions
+      module TravelData
+        module AirlineItinerary
+          # Signify a single AirlineItinerary Leg data
+          class Leg < Base
+
+            attr_reader :carrier_code, :service_class, :origin_city, :destination_city, :fare_basis_code,
+                        :flight_number, :departure_time_segment, :stopover_code
+            attr_accessor :departure_time
+
+            # Departure date
+            def departure_date
+              @departure_date&.strftime GenesisRuby::Api::Constants::DateTimeFormats::DD_MM_YYYY_L_HYPHENS
+            end
+
+            # Departure date
+            def departure_date=(value)
+              parse_date attribute: __method__, value: value, allow_empty: true
+            end
+
+            # Arrival date
+            def arrival_date
+              @arrival_date&.strftime GenesisRuby::Api::Constants::DateTimeFormats::DD_MM_YYYY_L_HYPHENS
+            end
+
+            # Arrival date
+            def arrival_date=(value)
+              parse_date attribute: __method__, value: value, allow_empty: true
+            end
+
+            # Carrier Code
+            def carrier_code=(value)
+              limited_string attribute: __method__, value: value.to_s, max: 2
+            end
+
+            # Service Class
+            def service_class=(value)
+              limited_string attribute: __method__, value: value.to_s, max: 1
+            end
+
+            # Origin City
+            def origin_city=(value)
+              limited_string attribute: __method__, value: value.to_s, max: 3
+            end
+
+            # Destination City
+            def destination_city=(value)
+              limited_string attribute: __method__, value: value.to_s, max: 3
+            end
+
+            # Fare basis code
+            def fare_basis_code=(value)
+              limited_string attribute: __method__, value: value.to_s, max: 6
+            end
+
+            # Flight number
+            def flight_number=(value)
+              limited_string attribute: __method__, value: value.to_s, max: 5
+            end
+
+            # Departure time segment
+            def departure_time_segment=(value)
+              allowed_options attribute: __method__, value: value.to_s, allowed: %w(A P), allow_empty: true
+            end
+
+            # Stopover code
+            def stopover_code=(value)
+              allowed_options attribute: __method__, value: value, allowed: [0, 1], allow_empty: true
+            end
+
+            # Get Single Leg structure
+            def attributes_structure # rubocop:disable Metrics/MethodLength
+              {
+                departure_date:         departure_date,
+                arrival_date:           arrival_date,
+                carrier_code:           carrier_code,
+                service_class:          service_class,
+                origin_city:            origin_city,
+                destination_city:       destination_city,
+                stopover_code:          stopover_code,
+                fare_basis_code:        fare_basis_code,
+                flight_number:          flight_number,
+                departure_time:         departure_time,
+                departure_time_segment: departure_time_segment
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/utils/transactions/travel_data/airline_itinerary/tax.rb

@@ -0,0 +1,42 @@
+require 'genesis_ruby/utils/transactions/travel_data/airline_itinerary/base'
+require 'genesis_ruby/utils/money_format'
+
+module GenesisRuby
+  module Utils
+    module Transactions
+      module TravelData
+        module AirlineItinerary
+          # Signify a single AirlineItinerary Tax data
+          class Tax < Base
+
+            attr_reader :fee_type
+            attr_accessor :fee_amount, :currency
+
+            # Fee type
+            def fee_type=(value)
+              limited_string attribute: __method__, value: value, max: 8
+            end
+
+            # Get Single Tax structure
+            def attributes_structure
+              {
+                fee_amount: parse_fee_amount,
+                fee_type:   fee_type
+              }
+            end
+
+            protected
+
+            # Minor currency conversion if currency is set
+            def parse_fee_amount
+              return fee_amount if currency.nil? || fee_amount.nil?
+
+              MoneyFormat.amount_to_exponent fee_amount, currency
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/utils/transactions/wpf_types.rb

@@ -16,7 +16,7 @@ module GenesisRuby
               BRADESCO,
               CABAL, CASHU, CENCOSUD, DAVIVIENDA,
               EFECTY, ELO, EPS, EZEEWALLET, FASHIONCHEQUE,
-              GIROPAY, GOOGLE_PAY,
+              GOOGLE_PAY,
               IDEAL, IDEBIT_PAYIN, INSTA_DEBIT_PAYIN, INTERSOLVE, ITAU,
               MULTIBANCO, MY_BANK,
               NARANJA, NATIVA, NEOSURF, NETELLER,

data/lib/genesis_ruby/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: genesis_ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.7
 platform: ruby
 authors:
 - emerchantpay Ltd.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-03-25 00:00:00.000000000 Z
+date: 2024-07-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http
@@ -250,6 +250,7 @@ files:
 - lib/genesis_ruby/api/constants/transactions/parameters/managed_recurring/intervals.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/managed_recurring/modes.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/managed_recurring/payment_types.rb
+- lib/genesis_ruby/api/constants/transactions/parameters/mpi_protocol_sub_versions.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/mpi_protocol_versions.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/recurring/categories.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/recurring/types.rb
@@ -271,6 +272,7 @@ 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/travel_data/ancillary_charges_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
@@ -318,6 +320,11 @@ files:
 - lib/genesis_ruby/api/mixins/requests/financial/threeds/version2/recurring.rb
 - 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/financial/travel_data/airline_itinerary_attributes.rb
+- lib/genesis_ruby/api/mixins/requests/financial/travel_data/car_rental_attributes.rb
+- lib/genesis_ruby/api/mixins/requests/financial/travel_data/hotel_rental_attributes.rb
+- lib/genesis_ruby/api/mixins/requests/financial/travel_data/reference_ticket_attributes.rb
+- lib/genesis_ruby/api/mixins/requests/financial/travel_data/travel_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
@@ -383,6 +390,9 @@ files:
 - lib/genesis_ruby/utils/transactions/references/capturable_types.rb
 - lib/genesis_ruby/utils/transactions/references/refundable_types.rb
 - lib/genesis_ruby/utils/transactions/references/voidable_types.rb
+- lib/genesis_ruby/utils/transactions/travel_data/airline_itinerary/base.rb
+- lib/genesis_ruby/utils/transactions/travel_data/airline_itinerary/leg.rb
+- lib/genesis_ruby/utils/transactions/travel_data/airline_itinerary/tax.rb
 - lib/genesis_ruby/utils/transactions/wpf_types.rb
 - lib/genesis_ruby/version.rb
 homepage: https://github.com/GenesisGateway/genesis_ruby
@@ -408,7 +418,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: Ruby Client for Genesis Payment Processing Gateway