genesis_ruby 0.3.1 → 0.3.2

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

@@ -57,16 +57,6 @@ module GenesisRuby
                 }
               end
 
-              # Field value dependencies for MPI parameters
-              def mpi_attributes_field_dependencies
-                {
-                  mpi_protocol_version: Hash[
-                    Api::Constants::Transactions::Parameters::MpiProtocolVersions::PROTOCOL_VERSION_2,
-                    %w(mpi_directory_server_id)
-                  ]
-                }
-              end
-
             end
           end
         end

data/lib/genesis_ruby/api/mixins/requests/financial/money_transfer_payout_attributes.rb

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+require 'genesis_ruby/api/constants/transactions/parameters/money_transfer/types'
+require 'genesis_ruby/api/constants/transactions/parameters/money_transfer/sender_account_number_types'
+require 'genesis_ruby/api/constants/transactions/parameters/money_transfer/purpose_of_payments'
+require 'genesis_ruby/api/constants/transactions/parameters/money_transfer/source_of_funds'
+
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module Financial
+          # Money Transfer Payout Attributes
+          module MoneyTransferPayoutAttributes
+
+            attr_accessor :money_transfer_sender_account_number,
+                          :money_transfer_service_provider_name,
+                          :money_transfer_sender_address_country,
+                          :money_transfer_sender_address_city,
+                          :money_transfer_sender_address_line,
+                          :money_transfer_sender_address_state,
+                          :money_transfer_sender_address_postal_code,
+                          :money_transfer_receiver_first_name,
+                          :money_transfer_receiver_last_name,
+                          :money_transfer_receiver_address_country,
+                          :money_transfer_receiver_address_city,
+                          :money_transfer_receiver_address_line,
+                          :money_transfer_receiver_address_state,
+                          :money_transfer_receiver_address_postal_code,
+                          :money_transfer_receiver_account_number,
+                          :money_transfer_receiver_account_number_type
+
+            attr_reader :money_transfer_type, :money_transfer_sender_account_number_type,
+                        :money_transfer_purpose_of_payment, :money_transfer_source_of_funds
+
+            # Money Transfer Type setter
+            def money_transfer_type=(value)
+              allowed_options(
+                attribute:     __method__,
+                allowed:       Api::Constants::Transactions::Parameters::MoneyTransfer::Types.all,
+                value:         value,
+                error_message: 'Invalid data for Money Transfer Type',
+                allow_empty:   true
+              )
+            end
+
+            # Money Transfer Sender Account Number Type setter
+            def money_transfer_sender_account_number_type=(value)
+              allowed_options(
+                attribute:     __method__,
+                allowed:       Api::Constants::Transactions::Parameters::MoneyTransfer::
+                    SenderAccountNumberTypes.all,
+                value:         value,
+                error_message: 'Invalid data for Money Transfer Sender Account Number Type',
+                allow_empty:   true
+              )
+            end
+
+            # Money Transfer Purpose of Payment setter
+            def money_transfer_purpose_of_payment=(value)
+              allowed_options(
+                attribute:     __method__,
+                allowed:       Api::Constants::Transactions::Parameters::MoneyTransfer::PurposeOfPayments.all,
+                value:         value,
+                error_message: 'Invalid data for Money Transfer Purpose of Payment',
+                allow_empty:   true
+              )
+            end
+
+            # Money Transfer Source of Funds setter
+            def money_transfer_source_of_funds=(value)
+              allowed_options(
+                attribute:     __method__,
+                allowed:       Api::Constants::Transactions::Parameters::MoneyTransfer::SourceOfFunds.all,
+                value:         value,
+                error_message: 'Invalid data for Money Transfer Source of Funds',
+                allow_empty:   true
+              )
+            end
+
+            # Money Transfer Sender Birth Date accessor
+            def money_transfer_sender_birth_date
+              @money_transfer_sender_birth_date&.strftime(
+                Api::Constants::DateTimeFormats::DD_MM_YYYY_L_HYPHENS
+              )
+            end
+
+            # Money Transfer Sender Birth Date setter
+            def money_transfer_sender_birth_date=(value)
+              parse_date attribute: __method__, value: value, allow_empty: true
+            end
+
+            protected
+
+            # Money Transfer Payout Attributes Structure
+            def money_transfer_payout_attributes_structure # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+              {
+                type:                       money_transfer_type,
+                sender_account_number:      money_transfer_sender_account_number,
+                sender_birth_date:          money_transfer_sender_birth_date,
+                service_provider_name:      money_transfer_service_provider_name,
+                sender_account_number_type: money_transfer_sender_account_number_type,
+                purpose_of_payment:         money_transfer_purpose_of_payment,
+                source_of_funds:            money_transfer_source_of_funds,
+                sender_address:             {
+                  country:     money_transfer_sender_address_country,
+                  city:        money_transfer_sender_address_city,
+                  line:        money_transfer_sender_address_line,
+                  state:       money_transfer_sender_address_state,
+                  postal_code: money_transfer_sender_address_postal_code
+                },
+                receiver:                   {
+                  first_name:          money_transfer_receiver_first_name,
+                  last_name:           money_transfer_receiver_last_name,
+                  country:             money_transfer_receiver_address_country,
+                  city:                money_transfer_receiver_address_city,
+                  line:                money_transfer_receiver_address_line,
+                  state:               money_transfer_receiver_address_state,
+                  postal_code:         money_transfer_receiver_address_postal_code,
+                  account_number:      money_transfer_receiver_account_number,
+                  account_number_type: money_transfer_receiver_account_number_type
+                }
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/non_financial/date_attributes.rb

@@ -15,38 +15,100 @@ module GenesisRuby
                        else
                          Api::Constants::DateTimeFormats::YYYY_MM_DD_ISO_8601
                        end
-
               @start_date&.strftime format
             end
 
             # Start of the requested date range (time is optional)
             def start_date=(value)
               self.start_date_time = Utils::Common.date_has_time? value
-
               parse_date attribute: __method__, value: value, allow_empty: true
             end
 
-            # Start of the requested date range (time is optional)
+            # End of the requested date range (time is optional)
             def end_date
               format = if end_date_time?
                          Api::Constants::DateTimeFormats::YYYY_MM_DD_H_I_S
                        else
                          Api::Constants::DateTimeFormats::YYYY_MM_DD_ISO_8601
                        end
-
               @end_date&.strftime format
             end
 
             # End of the requested date range (time is optional)
             def end_date=(value)
               self.end_date_time = Utils::Common.date_has_time? value
+              parse_date attribute: __method__, value: value, allow_empty: true
+            end
+
+            # Start of the requested date range in UTC.
+            def start_date_from
+              format = if start_date_from_time?
+                         Api::Constants::DateTimeFormats::YYYY_MM_DD_H_I_S
+                       else
+                         Api::Constants::DateTimeFormats::YYYY_MM_DD_ISO_8601
+                       end
+              @start_date_from&.strftime format
+            end
+
+            # Start of the requested date range in UTC.
+            def start_date_from=(value)
+              self.start_date_from_time = Utils::Common.date_has_time? value
+              parse_date attribute: __method__, value: value, allow_empty: true
+            end
+
+            # End of the requested date range in UTC.
+            def start_date_to
+              format = if start_date_to_time?
+                         Api::Constants::DateTimeFormats::YYYY_MM_DD_H_I_S
+                       else
+                         Api::Constants::DateTimeFormats::YYYY_MM_DD_ISO_8601
+                       end
+              @start_date_to&.strftime format
+            end
+
+            # End of the requested date range in UTC.
+            def start_date_to=(value)
+              self.start_date_to_time = Utils::Common.date_has_time? value
+              parse_date attribute: __method__, value: value, allow_empty: true
+            end
+
+            # Start of the requested date range in UTC.
+            def end_date_from
+              format = if end_date_from_time?
+                         Api::Constants::DateTimeFormats::YYYY_MM_DD_H_I_S
+                       else
+                         Api::Constants::DateTimeFormats::YYYY_MM_DD_ISO_8601
+                       end
+              @end_date_from&.strftime format
+            end
+
+            # Start of the requested date range in UTC.
+            def end_date_from=(value)
+              self.end_date_from_time = Utils::Common.date_has_time? value
+              parse_date attribute: __method__, value: value, allow_empty: true
+            end
+
+            # End of the requested date range in UTC.
+            def end_date_to
+              format = if end_date_to_time?
+                         Api::Constants::DateTimeFormats::YYYY_MM_DD_H_I_S
+                       else
+                         Api::Constants::DateTimeFormats::YYYY_MM_DD_ISO_8601
+                       end
+              @end_date_to&.strftime format
+            end
 
+            # End of the requested date range in UTC.
+            def end_date_to=(value)
+              self.end_date_to_time = Utils::Common.date_has_time? value
               parse_date attribute: __method__, value: value, allow_empty: true
             end
 
             private
 
-            attr_accessor :start_date_time, :end_date_time
+            attr_accessor :start_date_time, :end_date_time,
+                          :start_date_from_time, :start_date_to_time,
+                          :end_date_from_time, :end_date_to_time
 
             # Start Date has time within the given string
             def start_date_time?
@@ -58,6 +120,26 @@ module GenesisRuby
               self.end_date_time ||= false
             end
 
+            # Start Date has time within the given string
+            def start_date_from_time?
+              self.start_date_from_time ||= false
+            end
+
+            # End Date has time within the given string
+            def start_date_to_time?
+              self.start_date_to_time ||= false
+            end
+
+            # End Date has time within the given string
+            def end_date_from_time?
+              self.end_date_from_time ||= false
+            end
+
+            # End Date has time within the given string
+            def end_date_to_time?
+              self.end_date_to_time ||= false
+            end
+
           end
         end
       end

data/lib/genesis_ruby/api/mixins/requests/non_financial/kyc/business_attributes.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        module NonFinancial
+          module Kyc
+            # Business-related AML screening attributes
+            module BusinessAttributes
+
+              attr_accessor :business_name
+
+              # Date of incorporation of the business
+              def business_incorporation_date
+                @business_incorporation_date&.strftime(
+                  GenesisRuby::Api::Constants::DateTimeFormats::YYYY_MM_DD_ISO_8601
+                )
+              end
+
+              # Date of incorporation of the business
+              def business_incorporation_date=(value)
+                parse_date attribute: __method__, value: value, allow_empty: true
+              end
+
+              protected
+
+              # Defines the structure of the business attributes
+              def business_attributes_structure
+                {
+                  name:               business_name,
+                  incorporation_date: business_incorporation_date
+                }
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/mixins/requests/non_financial/kyc/document_attributes.rb

@@ -9,7 +9,7 @@ module GenesisRuby
             # Document Attributes mixin
             module DocumentAttributes
 
-              attr_accessor :proof, :full_address
+              attr_accessor :proof, :additional_proof, :full_address
               attr_reader   :first_name, :middle_name, :last_name
 
               # Gets date of birth for the document attributes
@@ -44,12 +44,13 @@ module GenesisRuby
               # Defines the structure of the document attributes
               def document_attributes_structure
                 {
-                  proof:         proof,
-                  date_of_birth: date_of_birth,
-                  first_name:    first_name,
-                  middle_name:   middle_name,
-                  last_name:     last_name,
-                  full_address:  full_address
+                  proof:            proof,
+                  additional_proof: additional_proof,
+                  date_of_birth:    date_of_birth,
+                  first_name:       first_name,
+                  middle_name:      middle_name,
+                  last_name:        last_name,
+                  full_address:     full_address
                 }
               end
 

data/lib/genesis_ruby/api/request.rb

@@ -15,12 +15,13 @@ module GenesisRuby
       include Mixins::Requests::AttributeValidation
 
       PROTOCOL_HTTPS = 'https'
-      PORT_HTTPS     = 443
+      PORT_HTTPS = 443
 
-      METHOD_POST    = 'POST'
-      METHOD_GET     = 'GET'
-      METHOD_PUT     = 'PUT'
-      METHOD_PATCH   = 'PATCH'
+      METHOD_POST   = 'POST'
+      METHOD_GET    = 'GET'
+      METHOD_PUT    = 'PUT'
+      METHOD_PATCH  = 'PATCH'
+      METHOD_DELETE = 'DELETE'
 
       AUTH_TYPE_BASIC = 'basic'
       AUTH_TYPE_TOKEN = 'bearer'
@@ -28,9 +29,9 @@ module GenesisRuby
       attr_reader :api_config
 
       def initialize(configuration, builder_interface = 'xml')
-        @configuration     = configuration
+        @configuration = configuration
         @builder_interface = builder_interface
-        @api_config        = GenesisRuby::Utils::Options::ApiConfig.new
+        @api_config = GenesisRuby::Utils::Options::ApiConfig.new
 
         init_configuration
         init_field_validations
@@ -91,9 +92,14 @@ module GenesisRuby
         @api_config.load_patch_config
       end
 
+      # Pre-defined DELETE Request Configuration
+      def init_delete_configuration
+        @api_config.load_delete_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'
+        request_path = options.fetch :request_path, 'process'
         include_token = options.fetch :include_token, true
 
         api_config.url = build_request_url(
@@ -168,7 +174,7 @@ module GenesisRuby
       #   path - the requested service /blacklists, threeds/threeds_method/<unique_id>, wpf/reconcile, etc/
       #   token - the MID configuration, appended to the end of the URL
       def build_request_url(options = { subdomain: 'gateway', path: '', token: '' })
-        options  = parse_request_parameters(options)
+        options = parse_request_parameters(options)
 
         format('%{protocol}://%{sub}%{domain}:%{port}/%{path}', {
                  protocol: api_config.protocol || PROTOCOL_HTTPS,

data/lib/genesis_ruby/api/requests/base/non_financial/billing_api/base.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+require 'genesis_ruby/api/constants/transactions/parameters/non_financial/billing_api/order_by_fields'
+require 'genesis_ruby/api/constants/transactions/parameters/non_financial/sort_directions'
+
+module GenesisRuby
+  module Api
+    module Requests
+      module Base
+        module NonFinancial
+          module BillingApi
+            # Base class for Billing API GraphQL requests
+            class Base < Requests::Base::Graphql
+
+              include Api::Mixins::Requests::NonFinancial::BillingApi::SortAttributes
+              include Api::Mixins::Requests::NonFinancial::DateAttributes
+              include Api::Mixins::Requests::NonFinancial::PagingAttributes
+
+              # List of billing statement names
+              def billing_statement
+                @billing_statement || []
+              end
+
+              # List of billing statement names
+              def billing_statement=(value)
+                parse_array_of_strings attribute: __method__, value: value, allow_empty: true
+              end
+
+              protected
+
+              # Billing API Authorization Token
+              def init_authorization_token
+                api_config.bearer_token = configuration.billing_api_token
+              end
+
+              # Additional optional filter arguments (sort + paging)
+              def additional_arguments
+                [request_order, request_paging].reject(&:empty?).join(' ')
+              end
+
+              # Validate max size of an array attribute
+              def validate_array_size(attribute, size)
+                return if __send__(attribute).length <= size
+
+                raise ParameterError,
+                      format('Max array length on %{attribute} exceed allowed size of %{size}',
+                             attribute: attribute, size: size)
+              end
+
+              # Validate a pair of date attributes: both required, from < to
+              def validate_date_range(from_attr, to_attr, max_days_difference = 7)
+                from_val = instance_variable_get("@#{from_attr}")
+                to_val   = instance_variable_get("@#{to_attr}")
+                message  = "If filter #{from_attr} is provided, then #{to_attr} should also be provided and vice versa."
+
+                raise ParameterError, message unless from_val.is_a?(DateTime) && to_val.is_a?(DateTime)
+                raise ParameterError, "#{to_attr} must be after #{from_attr}!" if from_val >= to_val
+
+                days_diff = to_val - from_val
+                return unless days_diff > max_days_difference
+
+                raise ParameterError, "Maximum difference between date range is #{max_days_difference} days"
+              end
+
+              # Wraps a date attribute value in GraphQL double-quotes, or returns nil if blank
+              def escape_argument(attribute)
+                val = __send__(attribute)
+                val.to_s.empty? ? nil : "\"#{val}\""
+              end
+
+              # Wraps a string value in GraphQL double-quotes, or returns nil if blank
+              def escape_string(val)
+                val.to_s.empty? ? nil : "\"#{val}\""
+              end
+
+              private
+
+              # Generate the paging part of the GraphQL query
+              def request_paging
+                paging = {}
+                paging[:page]    = page if page
+                paging[:perPage] = per_page if per_page
+                generate_graphql_code(paging, 'paging')
+              end
+
+              # Generate the sort/order part of the GraphQL query
+              def request_order
+                elements = {}
+                elements[:byDirection] = sort_by_direction if sort_by_direction
+                elements[:byField]     = sort_by_field if sort_by_field
+                generate_graphql_code(elements, 'sort')
+              end
+
+              # Render a GraphQL inline argument block: key { k: v ... }
+              def generate_graphql_code(hash, key)
+                return '' if hash.empty?
+
+                pairs = hash.map { |param, value| "#{param}: #{value.inspect}" }.join(', ')
+                "#{key} { #{pairs} }"
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/base/non_financial/payee/base.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module GenesisRuby
+  module Api
+    module Requests
+      module Base
+        module NonFinancial
+          module Payee
+            # Base Request class for Payee Non-Financial API services (non-versioned)
+            class Base < Api::Request
+
+              protected
+
+              attr_reader :request_path
+
+              # Constructor for the Payee Base Request
+              def initialize(configuration, _builder_interface = nil)
+                super configuration, Builder::JSON
+              end
+
+              # Defines the endpoint of the request
+              def request_path=(value)
+                @request_path = value.to_s
+
+                init_configuration
+              end
+
+              # Initialize Request configuration
+              def init_configuration
+                super
+
+                init_json_configuration
+                init_api_service_configuration request_path: request_path if request_path && !request_path.empty?
+              end
+
+              # Request structure. Overridden for common structure parameters
+              def populate_structure
+                super
+
+                @tree_structure = request_structure
+              end
+
+              # Request structure
+              def request_structure
+                {}
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -51,14 +51,12 @@ module GenesisRuby
 
               field_value_dependencies.merge! required_tokenization_fields_conditional, required_cc_fields_conditional,
                                               required_recurring_managed_type_field_conditional,
-                                              threeds_field_conditional_validations, mpi_attributes_field_dependencies
+                                              threeds_field_conditional_validations
             end
 
             # Special validations upon document building
             def check_requirements
               validate_threeds_card_holder_dates
-              # MPI Directory Server ID is optional when Scheme Tokenized with MPI Protocol Version 2
-              field_value_dependencies.delete :mpi_protocol_version if scheme_tokenized
 
               super
             end

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

@@ -20,6 +20,7 @@ module GenesisRuby
             include Mixins::Requests::Financial::CustomerIdentificationAttributes
             include Mixins::Requests::Financial::DynamicDescriptorAttributes
             include Mixins::Requests::Financial::GamingAttributes
+            include Mixins::Requests::Financial::MoneyTransferPayoutAttributes
             include Mixins::Requests::Financial::MotoAttributes
             include Mixins::Requests::Financial::PurposeOfPaymentAttributes
             include Mixins::Requests::Financial::SourceOfFundsAttributes
@@ -61,7 +62,8 @@ module GenesisRuby
                   billing_address:           billing_address_parameters_structure,
                   shipping_address:          shipping_address_parameters_structure,
                   customer_identification:   customer_identification_attributes_structure,
-                  dynamic_descriptor_params: dynamic_descriptor_structure
+                  dynamic_descriptor_params: dynamic_descriptor_structure,
+                  money_transfer:            money_transfer_payout_attributes_structure
                 }
               )
             end

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

@@ -49,14 +49,12 @@ module GenesisRuby
 
               field_value_dependencies.merge! required_tokenization_fields_conditional, required_cc_fields_conditional,
                                               required_recurring_managed_type_field_conditional,
-                                              threeds_field_conditional_validations, mpi_attributes_field_dependencies
+                                              threeds_field_conditional_validations
             end
 
             # Special validations upon document building
             def check_requirements
               validate_threeds_card_holder_dates
-              # MPI Directory Server ID is optional when Scheme Tokenized with MPI Protocol Version 2
-              field_value_dependencies.delete :mpi_protocol_version if scheme_tokenized
 
               super
             end