genesis_ruby 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f29c5f143d903c4fb42a353861744b184de9a7d48dd8788e7ed53baedc11849a
-  data.tar.gz: 824210216d4e2f029faf1e8f1896d8c03ad28c4b79f8d7bdd647e73f169175a3
+  metadata.gz: b8bb23a143ba4c359861d35f9e03cfde80130d4e7566cd95a899e27e5f77b8d2
+  data.tar.gz: 72496117a1a8a3ec4dcca3b39f41ac080b9696b1d16e2844c3f3488b11b15104
 SHA512:
-  metadata.gz: a403425c5236e42412d7e103272a1a4895211e3ea5594f27396fdb330d1cef7d538807da4f08fcd9872f3edfd98fa836b30199d3c45080cce12579062c7d00b2
-  data.tar.gz: 8ea6cf3090a5346a6bdbf760d3ed91908e2b7bb609b050e66a5904b6f965b21defe9b0878cb4bea92772cb70447e5b80003547dcc8b1d9a8556eabc5ac3f8d79
+  metadata.gz: 54bfbce4e0a95961f64aafdc168e8509f810c070d9a24ff1430648da7f12611f87e418dea7483e97e655065b24a83bf80d61a9fe870ac6656e9bfd55704e2474
+  data.tar.gz: 9a10b7cd257d4dacb18b420d454cc564c265f0e636221454b00b6ed86ca95002a8cc8dfc9212ad599002fd6101da571a63063d14f1c71fe1675430a38443a47b

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+0.2.2
+-----
+**Features**:
+
+* Added Installments API services support
+* Added Installments attributes support to the following transaction requests:
+  * Authorize
+  * Authorize 3D
+  * Capture
+  * Sale
+  * Sale 3D
+  * Refund
+* Added Level 3 Travel Data attributes support to Refund transaction request
+
 0.2.1
 -----
 **Features**:

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    genesis_ruby (0.2.1)
+    genesis_ruby (0.2.2)
       net-http (~> 0.3.2)
       nokogiri (~> 1.14)
 

data/README.md

@@ -1053,6 +1053,10 @@ GenesisRuby::Api::Requests::Financial::Refund
 ## Reconcile
 GenesisRuby::Api::Requests::NonFinancial::Reconcile::Transaction
 GenesisRuby::Api::Requests::NonFinancial::Reconcile::DateRange
+
+## Installments
+GenesisRuby::Api::Requests::NonFinancial::Installments::Fetch
+
 ```
 
 ### Manual initialization

data/VERSION

@@ -1 +1 @@
-0.2.1
+0.2.2

data/lib/genesis_ruby/api/constants/transactions/parameters/refund/credit_reason_indicators.rb

@@ -0,0 +1,30 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Refund
+            # Credit Reason Indicator allowed values
+            class CreditReasonIndicators
+
+              extend Api::Mixins::Constants::Common
+
+              # Passenger Transport Ancillary Cancellation
+              INDICATOR_A = 'A'.freeze
+
+              # Travel Ticket and Passenger Transport
+              INDICATOR_B = 'B'.freeze
+
+              # Partial Refund of Travel Ticket
+              INDICATOR_P = 'P'.freeze
+
+              # Other
+              INDICATOR_O = 'O'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/constants/transactions/parameters/refund/ticket_change_indicators.rb

@@ -0,0 +1,24 @@
+module GenesisRuby
+  module Api
+    module Constants
+      module Transactions
+        module Parameters
+          module Refund
+            # Ticket Change Indicator allowed values
+            class TicketChangeIndicators
+
+              extend Api::Mixins::Constants::Common
+
+              # Change to existing Ticket
+              INDICATOR_C = 'C'.freeze
+
+              # New ticket
+              INDICATOR_N = 'N'.freeze
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,18 @@
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          module Cards
+            # Installment shared attributes mixin
+            module InstallmentAttributes
+
+              attr_accessor :installment_plan_id, :installment_plan_reference
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/request.rb

@@ -7,7 +7,7 @@ require 'genesis_ruby/utils/money_format'
 module GenesisRuby
   module Api
     # Base Request Class
-    class Request
+    class Request # rubocop:disable Metrics/ClassLength
 
       include Mixins::Requests::RestrictedSetter
       include Mixins::Requests::AttributeValidation
@@ -70,6 +70,11 @@ module GenesisRuby
         @api_config.load_form_config
       end
 
+      # Pre-defined GET Request Configuration
+      def init_get_configuration
+        @api_config.load_get_config
+      end
+
       # Initializes Api EndPoint Url with request path & terminal token
       def init_api_gateway_configuration(options = { request_path: 'process', include_token: true })
         request_path  = options.fetch :request_path, 'process'

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

@@ -0,0 +1,88 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Base
+        # Base Versioned Request class used for Non Financial JSON API services
+        class Versioned < Request
+
+          DEFAULT_VERSION = 'v1'.freeze
+          private_constant :DEFAULT_VERSION
+
+          attr_reader :version, :allowed_versions
+
+          # Base Versioned Request constructor
+          def initialize(configuration, builder_interface = Builder::JSON)
+            super configuration, builder_interface
+
+            self.allowed_versions = [DEFAULT_VERSION]
+            self.version          = DEFAULT_VERSION
+            self.request_path     = ''
+          end
+
+          # Defines the version for the request
+          def version=(value)
+            allowed_options(
+              attribute:     __method__,
+              value:         value,
+              allowed:       allowed_versions,
+              allow_empty:   false,
+              error_message: 'Invalid API version! '
+            )
+
+            init_configuration
+          end
+
+          protected
+
+          attr_reader :request_path
+
+          # Every Specific request defines available versions
+          def allowed_versions=(value)
+            raise InvalidArgumentError, 'Allowed versions accepts only Array values' unless value.is_a? Array
+
+            @allowed_versions = value
+          end
+
+          # Defines the endpoint of the request
+          def request_path=(value)
+            @request_path = value.to_s
+
+            init_configuration
+
+            @request_path
+          rescue BuilderError
+            @request_path = ''
+
+            raise InvalidArgumentError, 'The Request can not be configured!'
+          end
+
+          # Initialize Request configuration
+          def init_configuration
+            super
+
+            case @builder_interface
+            when Builder::XML then init_xml_configuration
+            when Builder::JSON then init_json_configuration
+            else raise BuilderError, "Invalid Builder Interface specified for #{self.class.name}"
+            end
+
+            init_api_gateway_configuration request_path: "#{version}/#{request_path}", include_token: false
+          end
+
+          # Request structure. Overridden for common structure parameters
+          def populate_structure
+            super
+
+            @tree_structure = request_structure
+          end
+
+          # Request structure
+          def request_structure
+            raise NoMethodError, 'Request structure must be defined!'
+          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::Cards::InstallmentAttributes
           include Mixins::Requests::Financial::TravelData::TravelAttributes
 
           protected
@@ -18,9 +19,11 @@ module GenesisRuby
           # Capture Transaction Request Structure
           def reference_transaction_structure
             {
-              reference_id:        reference_id,
-              business_attributes: business_attributes_structure,
-              travel:              travel_data_attributes_structure
+              reference_id:               reference_id,
+              business_attributes:        business_attributes_structure,
+              travel:                     travel_data_attributes_structure,
+              installment_plan_id:        installment_plan_id,
+              installment_plan_reference: installment_plan_reference
             }
           end
 

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

@@ -13,6 +13,7 @@ module GenesisRuby
             include Mixins::Requests::DocumentAttributes
             include Mixins::Requests::Financial::Business::BusinessAttributes
             include Mixins::Requests::Financial::Cards::FxRateAttributes
+            include Mixins::Requests::Financial::Cards::InstallmentAttributes
             include Mixins::Requests::Financial::Cards::Recurring::ManagedRecurringAttributes
             include Mixins::Requests::Financial::Cards::Recurring::RecurringCategoryAttributes
             include Mixins::Requests::Financial::Cards::Recurring::RecurringTypeAttributes
@@ -50,25 +51,27 @@ module GenesisRuby
 
             def payment_transaction_structure # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
               super.merge(
-                gaming:                    gaming,
-                moto:                      moto,
-                crypto:                    crypto,
-                customer_email:            customer_email,
-                customer_phone:            customer_phone,
-                reference_id:              reference_id,
-                document_id:               document_id,
-                fx_rate_id:                fx_rate_id,
-                billing_address:           billing_address_parameters_structure,
-                shipping_address:          shipping_address_parameters_structure,
-                risk_params:               risk_parameters_structure,
-                dynamic_descriptor_params: dynamic_descriptor_structure,
-                business_attributes:       business_attributes_structure,
-                recurring_type:            recurring_type,
-                recurring_category:        recurring_category,
-                sca_params:                sca_attributes_structure,
-                managed_recurring:         managed_recurring_attributes_structure,
-                travel:                    travel_data_attributes_structure,
-                funding:                   funding_attributes_structure
+                gaming:                     gaming,
+                moto:                       moto,
+                crypto:                     crypto,
+                customer_email:             customer_email,
+                customer_phone:             customer_phone,
+                reference_id:               reference_id,
+                document_id:                document_id,
+                fx_rate_id:                 fx_rate_id,
+                billing_address:            billing_address_parameters_structure,
+                shipping_address:           shipping_address_parameters_structure,
+                risk_params:                risk_parameters_structure,
+                dynamic_descriptor_params:  dynamic_descriptor_structure,
+                business_attributes:        business_attributes_structure,
+                recurring_type:             recurring_type,
+                recurring_category:         recurring_category,
+                sca_params:                 sca_attributes_structure,
+                managed_recurring:          managed_recurring_attributes_structure,
+                travel:                     travel_data_attributes_structure,
+                funding:                    funding_attributes_structure,
+                installment_plan_id:        installment_plan_id,
+                installment_plan_reference: installment_plan_reference
               )
             end
 

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

@@ -14,6 +14,7 @@ module GenesisRuby
             include Mixins::Requests::Financial::AsyncAttributes
             include Mixins::Requests::Financial::Business::BusinessAttributes
             include Mixins::Requests::Financial::Cards::FxRateAttributes
+            include Mixins::Requests::Financial::Cards::InstallmentAttributes
             include Mixins::Requests::Financial::Cards::MpiAttributes
             include Mixins::Requests::Financial::Cards::Recurring::ManagedRecurringAttributes
             include Mixins::Requests::Financial::Cards::Recurring::RecurringCategoryAttributes
@@ -61,29 +62,31 @@ module GenesisRuby
             # Authorize 3D transaction request parameters
             def payment_transaction_structure # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
               super.merge(
-                notification_url:          notification_url,
-                return_success_url:        return_success_url,
-                return_failure_url:        return_failure_url,
-                gaming:                    gaming,
-                moto:                      moto,
-                crypto:                    crypto,
-                customer_email:            customer_email,
-                customer_phone:            customer_phone,
-                document_id:               document_id,
-                fx_rate_id:                fx_rate_id,
-                billing_address:           billing_address_parameters_structure,
-                shipping_address:          shipping_address_parameters_structure,
-                mpi_params:                mpi_attributes_structure,
-                risk_params:               risk_parameters_structure,
-                dynamic_descriptor_params: dynamic_descriptor_structure,
-                business_attributes:       business_attributes_structure,
-                recurring_type:            recurring_type,
-                recurring_category:        recurring_category,
-                sca_params:                sca_attributes_structure,
-                threeds_v2_params:         threeds_v2_common_attributes_structure,
-                managed_recurring:         managed_recurring_attributes_structure,
-                travel:                    travel_data_attributes_structure,
-                funding:                   funding_attributes_structure
+                notification_url:           notification_url,
+                return_success_url:         return_success_url,
+                return_failure_url:         return_failure_url,
+                gaming:                     gaming,
+                moto:                       moto,
+                crypto:                     crypto,
+                customer_email:             customer_email,
+                customer_phone:             customer_phone,
+                document_id:                document_id,
+                fx_rate_id:                 fx_rate_id,
+                billing_address:            billing_address_parameters_structure,
+                shipping_address:           shipping_address_parameters_structure,
+                mpi_params:                 mpi_attributes_structure,
+                risk_params:                risk_parameters_structure,
+                dynamic_descriptor_params:  dynamic_descriptor_structure,
+                business_attributes:        business_attributes_structure,
+                recurring_type:             recurring_type,
+                recurring_category:         recurring_category,
+                sca_params:                 sca_attributes_structure,
+                threeds_v2_params:          threeds_v2_common_attributes_structure,
+                managed_recurring:          managed_recurring_attributes_structure,
+                travel:                     travel_data_attributes_structure,
+                funding:                    funding_attributes_structure,
+                installment_plan_id:        installment_plan_id,
+                installment_plan_reference: installment_plan_reference
               )
             end
 

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

@@ -12,6 +12,7 @@ module GenesisRuby
             include Mixins::Requests::DocumentAttributes
             include Mixins::Requests::Financial::Business::BusinessAttributes
             include Mixins::Requests::Financial::Cards::FxRateAttributes
+            include Mixins::Requests::Financial::Cards::InstallmentAttributes
             include Mixins::Requests::Financial::Cards::Recurring::ManagedRecurringAttributes
             include Mixins::Requests::Financial::Cards::Recurring::RecurringCategoryAttributes
             include Mixins::Requests::Financial::Cards::Recurring::RecurringTypeAttributes
@@ -49,25 +50,27 @@ module GenesisRuby
 
             def payment_transaction_structure # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
               super.merge(
-                gaming:                    gaming,
-                moto:                      moto,
-                crypto:                    crypto,
-                customer_email:            customer_email,
-                customer_phone:            customer_phone,
-                reference_id:              reference_id,
-                document_id:               document_id,
-                fx_rate_id:                fx_rate_id,
-                billing_address:           billing_address_parameters_structure,
-                shipping_address:          shipping_address_parameters_structure,
-                risk_params:               risk_parameters_structure,
-                dynamic_descriptor_params: dynamic_descriptor_structure,
-                business_attributes:       business_attributes_structure,
-                recurring_type:            recurring_type,
-                recurring_category:        recurring_category,
-                sca_params:                sca_attributes_structure,
-                managed_recurring:         managed_recurring_attributes_structure,
-                travel:                    travel_data_attributes_structure,
-                funding:                   funding_attributes_structure
+                gaming:                     gaming,
+                moto:                       moto,
+                crypto:                     crypto,
+                customer_email:             customer_email,
+                customer_phone:             customer_phone,
+                reference_id:               reference_id,
+                document_id:                document_id,
+                fx_rate_id:                 fx_rate_id,
+                billing_address:            billing_address_parameters_structure,
+                shipping_address:           shipping_address_parameters_structure,
+                risk_params:                risk_parameters_structure,
+                dynamic_descriptor_params:  dynamic_descriptor_structure,
+                business_attributes:        business_attributes_structure,
+                recurring_type:             recurring_type,
+                recurring_category:         recurring_category,
+                sca_params:                 sca_attributes_structure,
+                managed_recurring:          managed_recurring_attributes_structure,
+                travel:                     travel_data_attributes_structure,
+                funding:                    funding_attributes_structure,
+                installment_plan_id:        installment_plan_id,
+                installment_plan_reference: installment_plan_reference
               )
             end
 

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

@@ -13,6 +13,7 @@ module GenesisRuby
             include Mixins::Requests::Financial::AsyncAttributes
             include Mixins::Requests::Financial::Business::BusinessAttributes
             include Mixins::Requests::Financial::Cards::FxRateAttributes
+            include Mixins::Requests::Financial::Cards::InstallmentAttributes
             include Mixins::Requests::Financial::Cards::MpiAttributes
             include Mixins::Requests::Financial::Cards::Recurring::ManagedRecurringAttributes
             include Mixins::Requests::Financial::Cards::Recurring::RecurringCategoryAttributes
@@ -60,29 +61,31 @@ module GenesisRuby
             # Sale 3D transaction request parameters
             def payment_transaction_structure # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
               super.merge(
-                notification_url:          notification_url,
-                return_success_url:        return_success_url,
-                return_failure_url:        return_failure_url,
-                gaming:                    gaming,
-                moto:                      moto,
-                crypto:                    crypto,
-                customer_email:            customer_email,
-                customer_phone:            customer_phone,
-                document_id:               document_id,
-                fx_rate_id:                fx_rate_id,
-                billing_address:           billing_address_parameters_structure,
-                shipping_address:          shipping_address_parameters_structure,
-                mpi_params:                mpi_attributes_structure,
-                risk_params:               risk_parameters_structure,
-                dynamic_descriptor_params: dynamic_descriptor_structure,
-                business_attributes:       business_attributes_structure,
-                recurring_type:            recurring_type,
-                recurring_category:        recurring_category,
-                sca_params:                sca_attributes_structure,
-                threeds_v2_params:         threeds_v2_common_attributes_structure,
-                managed_recurring:         managed_recurring_attributes_structure,
-                travel:                    travel_data_attributes_structure,
-                funding:                   funding_attributes_structure
+                notification_url:           notification_url,
+                return_success_url:         return_success_url,
+                return_failure_url:         return_failure_url,
+                gaming:                     gaming,
+                moto:                       moto,
+                crypto:                     crypto,
+                customer_email:             customer_email,
+                customer_phone:             customer_phone,
+                document_id:                document_id,
+                fx_rate_id:                 fx_rate_id,
+                billing_address:            billing_address_parameters_structure,
+                shipping_address:           shipping_address_parameters_structure,
+                mpi_params:                 mpi_attributes_structure,
+                risk_params:                risk_parameters_structure,
+                dynamic_descriptor_params:  dynamic_descriptor_structure,
+                business_attributes:        business_attributes_structure,
+                recurring_type:             recurring_type,
+                recurring_category:         recurring_category,
+                sca_params:                 sca_attributes_structure,
+                threeds_v2_params:          threeds_v2_common_attributes_structure,
+                managed_recurring:          managed_recurring_attributes_structure,
+                travel:                     travel_data_attributes_structure,
+                funding:                    funding_attributes_structure,
+                installment_plan_id:        installment_plan_id,
+                installment_plan_reference: installment_plan_reference
               )
             end
 

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

@@ -1,5 +1,8 @@
 require 'genesis_ruby/api/constants/transactions/parameters/refund/bank_account_types'
+require 'genesis_ruby/api/constants/transactions/parameters/refund/credit_reason_indicators'
+require 'genesis_ruby/api/constants/transactions/parameters/refund/ticket_change_indicators'
 
+# rubocop:disable Naming/VariableNumber
 module GenesisRuby
   module Api
     module Requests
@@ -7,27 +10,34 @@ module GenesisRuby
         # Refund reference transaction request
         class Refund < Requests::Base::Reference
 
+          include Mixins::Requests::Financial::Cards::InstallmentAttributes
+
           attr_accessor :beneficiary_bank_code, :beneficiary_name, :beneficiary_account_number, :bank, :bank_branch,
-                        :bank_account
-          attr_reader :bank_account_type
-
-          # The type of account
-          def bank_account_type=(value)
-            allowed_options attribute:   __method__,
-                            allowed:     Api::Constants::Transactions::Parameters::Refund::BankAccountTypes.all,
-                            value:       value,
-                            allow_empty: true
-          end
+                        :bank_account, :bank_account_type, :credit_reason_indicator_1, :credit_reason_indicator_2,
+                        :ticket_change_indicator
 
           protected
 
+          # Field Validations
+          def init_field_validations
+            super
+
+            field_values.merge! bank_account_type: Constants::Transactions::Parameters::Refund::BankAccountTypes.all,
+                                credit_reason_indicator_1: Constants::Transactions::Parameters::Refund::
+                                    CreditReasonIndicators.all,
+                                credit_reason_indicator_2: Constants::Transactions::Parameters::Refund::
+                                    CreditReasonIndicators.all,
+                                ticket_change_indicator:   Constants::Transactions::Parameters::Refund::
+                                    TicketChangeIndicators.all
+          end
+
           # Refund Transaction Request type
           def transaction_type
             Api::Constants::Transactions::REFUND
           end
 
           # Refund Transaction Request Structure
-          def reference_transaction_structure
+          def reference_transaction_structure # rubocop:disable Metrics/MethodLength
             {
               beneficiary_bank_code:      beneficiary_bank_code,
               beneficiary_name:           beneficiary_name,
@@ -35,7 +45,16 @@ module GenesisRuby
               bank:                       bank,
               bank_branch:                bank_branch,
               bank_account:               bank_account,
-              bank_account_type:          bank_account_type
+              bank_account_type:          bank_account_type,
+              installment_plan_id:        installment_plan_id,
+              installment_plan_reference: installment_plan_reference,
+              travel:                     {
+                ticket: {
+                  credit_reason_indicator_1: credit_reason_indicator_1,
+                  credit_reason_indicator_2: credit_reason_indicator_2,
+                  ticket_change_indicator:   ticket_change_indicator
+                }
+              }
             }
           end
 
@@ -44,3 +63,4 @@ module GenesisRuby
     end
   end
 end
+# rubocop:enable Naming/VariableNumber

data/lib/genesis_ruby/api/requests/non_financial/installments/fetch.rb

@@ -0,0 +1,59 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Installments
+          # Fetch the applicable installments for a given amount, currency and card brand.
+          class Fetch < Base::Versioned
+
+            attr_reader :amount, :card_number
+            attr_accessor :currency
+
+            # Installments Fetch initialization
+            def initialize(configuration, _builder_interface = nil)
+              super configuration
+
+              self.request_path = 'installments'
+            end
+
+            # Amount of transaction in minor currency unit
+            def amount=(value)
+              raise InvalidArgumentError, 'Invalid Amount given, only integer value allowed!' unless value.is_a? Integer
+
+              @amount = value
+            end
+
+            # Complete cc number of customer
+            def card_number=(value)
+              value = value.to_s
+
+              raise InvalidArgumentError, 'Invalid Credit Card number given!' unless value =~ /\A[0-9]{13,19}\Z/
+
+              @card_number = value
+            end
+
+            protected
+
+            # Fetch request field validations
+            def init_field_validations
+              super
+
+              required_fields.push *%i[amount currency card_number]
+              field_values.merge! currency: Constants::Currencies::Iso4217.all.map(&:upcase)
+            end
+
+            # Installments Fetch request structure
+            def request_structure
+              {
+                amount:      amount,
+                currency:    currency,
+                card_number: card_number
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/non_financial/installments/show.rb

@@ -0,0 +1,58 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Installments
+          # Retrieves details about a specific installment based on its ID.
+          class Show < Base::Versioned
+
+            attr_writer :installment_id
+
+            # Installments Show initialization
+            def initialize(configuration, _builder_interface = nil)
+              super configuration
+
+              self.request_path = 'installments/:installment_id'
+            end
+
+            # Installment identifier
+            def installment_id
+              @installment_id.to_s
+            end
+
+            protected
+
+            # Override default Versioned Network configuration
+            def init_configuration
+              super
+
+              init_get_configuration
+            end
+
+            # Fetch request field validations
+            def init_field_validations
+              super
+
+              required_fields.push *%i[installment_id]
+            end
+
+            # Installments Show request structure
+            def request_structure
+              {}
+            end
+
+            # Override API endpoint with provided Installment ID
+            def process_request_parameters
+              super
+
+              request_path.sub!(':installment_id', installment_id)
+
+              init_api_gateway_configuration request_path: "#{version}/#{request_path}", include_token: false
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/builder.rb

@@ -1,5 +1,6 @@
 require 'genesis_ruby/builders/xml'
 require 'genesis_ruby/builders/form'
+require 'genesis_ruby/builders/json'
 require 'genesis_ruby/errors/builder_error'
 
 module GenesisRuby
@@ -20,6 +21,7 @@ module GenesisRuby
       case request_interface
       when XML then @builder_context = Builders::Xml.new
       when FORM then @builder_context = Builders::Form.new
+      when JSON then @builder_context = Builders::Json.new
       else
         raise GenesisRuby::BuilderError, 'Invalid Builder interface!'
       end

data/lib/genesis_ruby/builders/json.rb

@@ -0,0 +1,30 @@
+require 'genesis_ruby/builders/base'
+require 'json'
+
+module GenesisRuby
+  module Builders
+    # JSON Document builder
+    class Json < Base
+
+      # JSON constructor
+      def initialize
+        @document = ''
+
+        super
+      end
+
+      # JSON output string
+      def output
+        @document
+      end
+
+      # Generate JSON document
+      def populate_nodes(structure)
+        @document = JSON.pretty_generate structure
+      rescue StandardError => e
+        raise BuilderError, "Given request structure can not be generated! #{e.message}"
+      end
+
+    end
+  end
+end

data/lib/genesis_ruby/dependencies.rb

@@ -20,6 +20,7 @@ require 'genesis_ruby/api/requests/base/financial'
 require 'genesis_ruby/api/requests/base/financials/credit_card'
 require 'genesis_ruby/api/requests/base/financials/south_american_payments'
 require 'genesis_ruby/api/requests/base/reference'
+require 'genesis_ruby/api/requests/base/versioned'
 require 'genesis_ruby/api/notification'
 
 # Load Financial and Non Financial API Requests

data/lib/genesis_ruby/network/adapter/net_http_adapter.rb

@@ -22,15 +22,15 @@ module GenesisRuby
         end
 
         # Send the request
-        def execute
+        def execute # rubocop:disable Metrics/AbcSize
           raise NetworkError, 'Request is not initialized' unless @request
 
           safe_execute do
             case request_data.type
             when Api::Request::METHOD_POST then @response = @request.post path, request_data.body, headers
             when Api::Request::METHOD_PUT then @response = @request.put path, request_data.body, headers
-            else
-              raise 'Invalid Request Type!'
+            when Api::Request::METHOD_GET then @response = @request.get path, headers
+            else raise 'Invalid Request Type!'
             end
           end
         end
@@ -90,12 +90,17 @@ module GenesisRuby
 
         # Define Headers
         def headers
-          {
-            'Content-Type'   => request_data.format,
-            'Content-Length' => request_data.body&.length.to_s,
-            'Authorization'  => "Basic #{request_data.user_login}",
-            'User-Agent'     => request_data.user_agent
+          headers = {
+            'Authorization' => "Basic #{request_data.user_login}",
+            'User-Agent'    => request_data.user_agent
           }
+
+          unless request_data.type == Api::Request::METHOD_GET
+            headers.merge! 'Content-Type'   => request_data.format,
+                           'Content-Length' => request_data.body&.length.to_s
+          end
+
+          headers
         end
 
         # Safe Request execution

data/lib/genesis_ruby/parser.rb

@@ -1,4 +1,5 @@
 require 'genesis_ruby/parsers/xml'
+require 'genesis_ruby/parsers/json'
 require 'genesis_ruby/errors/parser_error'
 
 module GenesisRuby
@@ -16,6 +17,8 @@ module GenesisRuby
       case response_interface
       when XML
         @parser_context = GenesisRuby::Parsers::Xml.new
+      when JSON
+        @parser_context = GenesisRuby::Parsers::Json.new
       else
         raise GenesisRuby::ParserError, 'Invalid Parser interface!'
       end

data/lib/genesis_ruby/parsers/json.rb

@@ -0,0 +1,18 @@
+require 'genesis_ruby/parsers/base'
+require 'json'
+
+module GenesisRuby
+  module Parsers
+    # JSON Document parser
+    class Json < Base
+
+      # Parse received document
+      def parse_document(document)
+        @structure = JSON.parse(document, symbolize_names: true)
+      rescue StandardError => e
+        raise ParserError, "Given JSON string can not be parsed! #{e.message}"
+      end
+
+    end
+  end
+end

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

@@ -33,6 +33,15 @@ module GenesisRuby
           self.parser_skip_root_node = true
         end
 
+        # Load pre-defined GET configuration
+        def load_get_config
+          self.protocol              = GenesisRuby::Api::Request::PROTOCOL_HTTPS
+          self.port                  = GenesisRuby::Api::Request::PORT_HTTPS
+          self.type                  = GenesisRuby::Api::Request::METHOD_GET
+          self.format                = Builder::XML
+          self.parser_skip_root_node = false
+        end
+
       end
     end
   end

data/lib/genesis_ruby/version.rb

@@ -1,5 +1,5 @@
 module GenesisRuby
 
-  VERSION = '0.2.1'.freeze
+  VERSION = '0.2.2'.freeze
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: genesis_ruby
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - emerchantpay Ltd.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-02-27 00:00:00.000000000 Z
+date: 2025-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http
@@ -270,6 +270,8 @@ files:
 - lib/genesis_ruby/api/constants/transactions/parameters/recurring/categories.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/recurring/types.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/refund/bank_account_types.rb
+- lib/genesis_ruby/api/constants/transactions/parameters/refund/credit_reason_indicators.rb
+- lib/genesis_ruby/api/constants/transactions/parameters/refund/ticket_change_indicators.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/sca_exemptions.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/threeds/version2/browser/color_depths.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/threeds/version2/card_holder_account/password_change_indicators.rb
@@ -312,6 +314,7 @@ files:
 - lib/genesis_ruby/api/mixins/requests/financial/cards/credential_on_file_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/cards/credit_card_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/cards/fx_rate_attributes.rb
+- lib/genesis_ruby/api/mixins/requests/financial/cards/installment_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/cards/mpi_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/cards/recurring/managed_recurring_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/cards/recurring/managed_recurring_indian_card_attributes.rb
@@ -358,6 +361,7 @@ files:
 - lib/genesis_ruby/api/requests/base/financials/credit_card.rb
 - lib/genesis_ruby/api/requests/base/financials/south_american_payments.rb
 - lib/genesis_ruby/api/requests/base/reference.rb
+- lib/genesis_ruby/api/requests/base/versioned.rb
 - lib/genesis_ruby/api/requests/financial/capture.rb
 - lib/genesis_ruby/api/requests/financial/cards/argencard.rb
 - lib/genesis_ruby/api/requests/financial/cards/aura.rb
@@ -397,6 +401,8 @@ files:
 - lib/genesis_ruby/api/requests/financial/refund.rb
 - lib/genesis_ruby/api/requests/financial/void.rb
 - lib/genesis_ruby/api/requests/financial/wallets/pay_pay.rb
+- lib/genesis_ruby/api/requests/non_financial/installments/fetch.rb
+- lib/genesis_ruby/api/requests/non_financial/installments/show.rb
 - lib/genesis_ruby/api/requests/non_financial/reconcile/date_range.rb
 - lib/genesis_ruby/api/requests/non_financial/reconcile/transaction.rb
 - lib/genesis_ruby/api/requests/wpf/create.rb
@@ -405,6 +411,7 @@ files:
 - lib/genesis_ruby/builder.rb
 - lib/genesis_ruby/builders/base.rb
 - lib/genesis_ruby/builders/form.rb
+- lib/genesis_ruby/builders/json.rb
 - lib/genesis_ruby/builders/xml.rb
 - lib/genesis_ruby/configuration.rb
 - lib/genesis_ruby/connection.rb
@@ -425,6 +432,7 @@ files:
 - lib/genesis_ruby/network/net_http.rb
 - lib/genesis_ruby/parser.rb
 - lib/genesis_ruby/parsers/base.rb
+- lib/genesis_ruby/parsers/json.rb
 - lib/genesis_ruby/parsers/xml.rb
 - lib/genesis_ruby/utils/common.rb
 - lib/genesis_ruby/utils/formatters/base.rb
@@ -475,7 +483,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.2.33
 signing_key:
 specification_version: 4
 summary: Ruby Client for Genesis Payment Processing Gateway