genesis_ruby 0.2.0 → 0.2.2

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.0'.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.0
+  version: 0.2.2
 platform: ruby
 authors:
 - emerchantpay Ltd.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-11-15 00:00:00.000000000 Z
+date: 2025-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http
@@ -245,9 +245,11 @@ files:
 - lib/genesis_ruby/api/constants/states/state.rb
 - lib/genesis_ruby/api/constants/transactions.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/business/payment_types.rb
+- lib/genesis_ruby/api/constants/transactions/parameters/cash_payments/cash_payment_types.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/cash_payments/company_types.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/cash_payments/genders.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/cash_payments/marital_statuses.rb
+- lib/genesis_ruby/api/constants/transactions/parameters/credential_on_files.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/funding/business_application_identifier_types.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/funding/identifier_types.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/funding/receiver_account_types.rb
@@ -260,12 +262,16 @@ files:
 - lib/genesis_ruby/api/constants/transactions/parameters/mobile/google_pay/payment_subtypes.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/online_banking/bank_account_types.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/online_banking/bank_code_currencies.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/online_banking/bank_codes.rb
 - lib/genesis_ruby/api/constants/transactions/parameters/online_banking/payment_types.rb
+- lib/genesis_ruby/api/constants/transactions/parameters/online_banking/payout_payment_types.rb
 - 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
@@ -305,14 +311,17 @@ files:
 - lib/genesis_ruby/api/mixins/requests/financial/business/hotels_and_real_estate_rentals_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/business/travel_agencies_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/cards/account_owner_attributes.rb
+- 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
 - lib/genesis_ruby/api/mixins/requests/financial/cards/recurring/recurring_category_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/cards/recurring/recurring_type_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/cards/tokenization_attributes.rb
+- lib/genesis_ruby/api/mixins/requests/financial/cards/ucof_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/consumer_identifier_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/crypto_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/dynamic_descriptor_attributes.rb
@@ -322,6 +331,7 @@ files:
 - lib/genesis_ruby/api/mixins/requests/financial/mobile/google_pay_token_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/moto_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/notification_attributes.rb
+- lib/genesis_ruby/api/mixins/requests/financial/online_banking_payments/pix_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/online_banking_payments/virtual_payment_address_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/payment_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/financial/pending_payment_attributes.rb
@@ -351,11 +361,13 @@ 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
 - lib/genesis_ruby/api/requests/financial/cards/authorize.rb
 - lib/genesis_ruby/api/requests/financial/cards/authorize3d.rb
+- lib/genesis_ruby/api/requests/financial/cards/bancontact.rb
 - lib/genesis_ruby/api/requests/financial/cards/cabal.rb
 - lib/genesis_ruby/api/requests/financial/cards/cencosud.rb
 - lib/genesis_ruby/api/requests/financial/cards/elo.rb
@@ -368,6 +380,7 @@ files:
 - lib/genesis_ruby/api/requests/financial/cash_payments/baloto.rb
 - lib/genesis_ruby/api/requests/financial/cash_payments/banco_de_occidente.rb
 - lib/genesis_ruby/api/requests/financial/cash_payments/boleto.rb
+- lib/genesis_ruby/api/requests/financial/cash_payments/cash.rb
 - lib/genesis_ruby/api/requests/financial/cash_payments/efecty.rb
 - lib/genesis_ruby/api/requests/financial/cash_payments/oxxo.rb
 - lib/genesis_ruby/api/requests/financial/cash_payments/pago_facil.rb
@@ -380,6 +393,7 @@ files:
 - lib/genesis_ruby/api/requests/financial/online_banking_payments/davivienda.rb
 - lib/genesis_ruby/api/requests/financial/online_banking_payments/itau.rb
 - lib/genesis_ruby/api/requests/financial/online_banking_payments/online_banking/pay_in.rb
+- lib/genesis_ruby/api/requests/financial/online_banking_payments/online_banking/pay_out.rb
 - lib/genesis_ruby/api/requests/financial/online_banking_payments/pse.rb
 - lib/genesis_ruby/api/requests/financial/online_banking_payments/rapi_pago.rb
 - lib/genesis_ruby/api/requests/financial/online_banking_payments/santander.rb
@@ -387,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
@@ -395,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
@@ -415,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
@@ -465,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