genesis_ruby 0.1.5 → 0.1.7

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

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

data/lib/genesis_ruby/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/options/reminder.rb

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

data/lib/genesis_ruby/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.5'.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.5
+  version: 0.1.7
 platform: ruby
 authors:
 - emerchantpay Ltd.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-03-01 00:00:00.000000000 Z
+date: 2024-07-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http
@@ -240,6 +240,7 @@ files:
 - lib/genesis_ruby/api/constants/date_time_formats.rb
 - lib/genesis_ruby/api/constants/endpoints.rb
 - lib/genesis_ruby/api/constants/environments.rb
+- lib/genesis_ruby/api/constants/i18n.rb
 - lib/genesis_ruby/api/constants/states.rb
 - lib/genesis_ruby/api/constants/states/state.rb
 - lib/genesis_ruby/api/constants/transactions.rb
@@ -249,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
@@ -270,6 +272,8 @@ 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
 - lib/genesis_ruby/api/mixins/requests/attribute_validation.rb
@@ -316,7 +320,13 @@ 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
 - lib/genesis_ruby/api/request.rb
 - lib/genesis_ruby/api/requests/base/financial.rb
@@ -374,11 +384,15 @@ files:
 - lib/genesis_ruby/utils/options/api_config.rb
 - lib/genesis_ruby/utils/options/base.rb
 - lib/genesis_ruby/utils/options/network_adapter_config.rb
+- lib/genesis_ruby/utils/options/reminder.rb
 - lib/genesis_ruby/utils/threeds/v2.rb
 - lib/genesis_ruby/utils/transactions/financial_types.rb
 - lib/genesis_ruby/utils/transactions/references/capturable_types.rb
 - 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
@@ -404,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