genesis_ruby 0.2.2 → 0.2.4

data/lib/genesis_ruby/api/requests/financial/sdd/recurring/init_recurring_sale.rb

@@ -0,0 +1,23 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module Sdd
+          module Recurring
+            # Sepa Direct Debit initial recurring
+            class InitRecurringSale < Api::Requests::Financial::Sdd::Sale
+
+              protected
+
+              # SDD Sale transaction type
+              def transaction_type
+                Api::Constants::Transactions::SDD_INIT_RECURRING_SALE
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/sdd/recurring/recurring_sale.rb

@@ -0,0 +1,28 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module Sdd
+          module Recurring
+            # Sepa Direct Debit Payment, popular in Germany.
+            class RecurringSale < Requests::Base::Reference
+
+              protected
+
+              # SDD Recurring Sale transaction type
+              def transaction_type
+                Constants::Transactions::SDD_RECURRING_SALE
+              end
+
+              # Reference transaction request structure
+              def reference_transaction_structure
+                {}
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module Sdd
+          # Sepa Direct Debit Payment, popular in Germany.
+          class Refund < Requests::Base::Reference
+
+            protected
+
+            # SDD Refund transaction type
+            def transaction_type
+              Api::Constants::Transactions::SDD_REFUND
+            end
+
+            # Reference transaction request structure
+            def reference_transaction_structure
+              {}
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,57 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module Sdd
+          # Sepa Direct Debit Payment, popular in Germany.
+          class Sale < Requests::Base::Financial
+
+            include Api::Mixins::Requests::CustomerAddress::BillingInfoAttributes
+            include Api::Mixins::Requests::CustomerAddress::ShippingInfoAttributes
+            include Api::Mixins::Requests::Financial::AsyncAttributes
+            include Api::Mixins::Requests::Financial::BankAttributes
+            include Api::Mixins::Requests::Financial::PendingPaymentAttributes
+            include Api::Mixins::Requests::Financial::DynamicDescriptorAttributes
+
+            attr_accessor :company_name, :mandate_reference
+
+            protected
+
+            # SDD Sale transaction type
+            def transaction_type
+              Api::Constants::Transactions::SDD_SALE
+            end
+
+            # SDD field validation
+            def init_field_validations
+              super
+
+              required_fields.push *%i[
+                transaction_id usage amount currency iban billing_first_name billing_last_name billing_country
+              ]
+
+              field_values.merge! billing_country: %w(AT BE CY EE FI FR DE GR IE IT LV LT LU MT MC NL PT SK SM SI ES)
+            end
+
+            # SDD Sale request structure
+            def payment_transaction_structure # rubocop:disable Metrics/MethodLength
+              {
+                iban:                      iban,
+                bic:                       bic,
+                company_name:              company_name,
+                mandate_reference:         mandate_reference,
+                return_success_url:        return_success_url,
+                return_failure_url:        return_failure_url,
+                return_pending_url:        return_pending_url,
+                billing_address:           billing_address_parameters_structure,
+                shipping_address:          shipping_address_parameters_structure,
+                dynamic_descriptor_params: dynamic_descriptor_structure
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -3,8 +3,9 @@ module GenesisRuby
     module Requests
       module Financial
         # Void or undo payment transaction request
-        class Void < Base::Financial
+        class Void < Request
 
+          include Mixins::Requests::Financial::BaseAttributes
           include Mixins::Requests::Financial::ReferenceAttributes
 
           protected
@@ -18,10 +19,16 @@ module GenesisRuby
             required_fields.push *%i[transaction_id reference_id]
           end
 
-          # Void transaction request structure
-          def payment_transaction_structure
-            {
-              reference_id: reference_id
+          # Returns the Request transaction structure
+          def populate_structure
+            @tree_structure = {
+              payment_transaction: {
+                transaction_type: transaction_type,
+                transaction_id:   transaction_id,
+                usage:            usage,
+                reference_id:     reference_id,
+                remote_ip:        remote_ip
+              }
             }
           end
 

data/lib/genesis_ruby/api/requests/financial/wallets/alipay.rb

@@ -0,0 +1,46 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module Wallets
+          # Alipay is an oBeP-style alternative payment method that allows you to pay directly with your ebank account.
+          class Alipay < Base::Financial
+
+            include Api::Mixins::Requests::AddressInfoAttributes
+            include Api::Mixins::Requests::BirthDateAttributes
+            include Api::Mixins::Requests::Financial::AsyncAttributes
+
+            protected
+
+            # Alipay transaction type
+            def transaction_type
+              Api::Constants::Transactions::ALIPAY
+            end
+
+            # Alipay Field Validations
+            def init_field_validations
+              super
+
+              required_fields.push *%i[transaction_id amount currency return_success_url return_failure_url]
+              field_values.merge! currency: %w(EUR CNY)
+            end
+
+            # Alipay request structure
+            def payment_transaction_structure
+              {
+                return_success_url: return_success_url,
+                return_failure_url: return_failure_url,
+                customer_email:     customer_email,
+                customer_phone:     customer_phone,
+                birth_date:         birth_date,
+                billing_address:    billing_address_parameters_structure,
+                shipping_address:   shipping_address_parameters_structure
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/wallets/{pay_pay.rb → pay_pal.rb}

@@ -14,7 +14,6 @@ module GenesisRuby
             include Api::Mixins::Requests::Financial::Business::BusinessAttributes
             include Api::Mixins::Requests::DocumentAttributes
             include Api::Mixins::Requests::Financial::NotificationAttributes
-            include Api::Mixins::Requests::Financial::PaymentAttributes
             include Api::Mixins::Requests::Financial::NotificationAttributes
             include Api::Mixins::Requests::Financial::PendingPaymentAttributes
 
@@ -24,12 +23,13 @@ module GenesisRuby
 
             # Initialize PayPal request field validations
             def init_field_validations
+              super
+
               required_fields
                 .push *%i[transaction_id payment_type amount currency return_success_url return_failure_url]
 
-              field_values.merge! currency:     Api::Constants::Currencies::Iso4217.all.map(&:upcase),
-                                  payment_type: Api::Constants::Transactions::Parameters::Wallets::PayPal::
-                                      PaymentTypes.all
+              field_values.merge! payment_type:
+                Api::Constants::Transactions::Parameters::Wallets::PayPal::PaymentTypes.all
             end
 
             # PayPal transaction type
@@ -39,22 +39,20 @@ module GenesisRuby
 
             # PayPal request attributes structure
             def payment_transaction_structure # rubocop:disable Metrics/MethodLength
-              payment_attributes_structure.merge(
-                {
-                  notification_url:    notification_url,
-                  return_success_url:  return_success_url,
-                  return_failure_url:  return_failure_url,
-                  return_pending_url:  return_pending_url,
-                  customer_email:      customer_email,
-                  customer_phone:      customer_phone,
-                  payment_type:        payment_type,
-                  birth_date:          birth_date,
-                  document_id:         document_id,
-                  billing_address:     billing_address_parameters_structure,
-                  shipping_address:    shipping_address_parameters_structure,
-                  business_attributes: business_attributes_structure
-                }
-              )
+              {
+                notification_url:    notification_url,
+                return_success_url:  return_success_url,
+                return_failure_url:  return_failure_url,
+                return_pending_url:  return_pending_url,
+                customer_email:      customer_email,
+                customer_phone:      customer_phone,
+                payment_type:        payment_type,
+                birth_date:          birth_date,
+                document_id:         document_id,
+                billing_address:     billing_address_parameters_structure,
+                shipping_address:    shipping_address_parameters_structure,
+                business_attributes: business_attributes_structure
+              }
             end
 
           end

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

@@ -0,0 +1,203 @@
+require 'date'
+require 'genesis_ruby/api/constants/transactions/parameters/non_financial/billing_api/order_by_fields'
+require 'genesis_ruby/api/constants/transactions/parameters/non_financial/billing_api/response_fields'
+require 'genesis_ruby/api/constants/transactions/parameters/non_financial/billing_api/transaction_types'
+require 'genesis_ruby/api/constants/transactions/parameters/non_financial/sort_directions'
+
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module BillingApi
+          # Billing Transactions API allows to programmatically retrieve information about billing transactions
+          # using given filters, pagination, and sort parameters.
+          class Transactions < Base::Graphql # rubocop:disable Metrics/ClassLength
+
+            include Api::Mixins::Requests::NonFinancial::BillingApi::SortAttributes
+            include Api::Mixins::Requests::NonFinancial::DateAttributes
+            include Api::Mixins::Requests::NonFinancial::PagingAttributes
+
+            def initialize(configuration, _builder_interface = nil)
+              super configuration
+
+              self.root_key     = 'query'
+              self.request_name = 'billingTransactions'
+              self.request_path = 'billing_transactions'
+            end
+
+            # Response Fields
+            def response_fields
+              @response_fields || []
+            end
+
+            # Response Fields
+            def response_fields=(value)
+              parse_array_of_strings attribute: __method__,
+                                     value: value,
+                                     allowed: Api::Constants::Transactions::Parameters::NonFinancial::BillingApi::
+                                         ResponseFields.all
+            end
+
+            # List of billing transaction unique IDs. Max number of elements is 10000. Primary filter.
+            def unique_id
+              @unique_id || []
+            end
+
+            # List of billing transaction unique IDs. Max number of elements is 10000. Primary filter.
+            def unique_id=(value)
+              parse_array_of_strings attribute: __method__, value: value, allow_empty: true
+            end
+
+            # List of billing statement names. Max number of elements allowed is 10. Primary filter.
+            def billing_statement
+              @billing_statement || []
+            end
+
+            # List of billing statement names. Max number of elements allowed is 10. Primary filter.
+            def billing_statement=(value)
+              parse_array_of_strings attribute: __method__, value: value, allow_empty: true
+            end
+
+            # List of merchant transaction IDs. Max number of elements allowed is 10000. Primary filter.
+            def merchant_transaction_id
+              @merchant_transaction_id || []
+            end
+
+            # List of merchant transaction IDs. Max number of elements allowed is 10000. Primary filter.
+            def merchant_transaction_id=(value)
+              parse_array_of_strings attribute: __method__, value: value, allow_empty: true
+            end
+
+            # List of master account names. Max number of elements allowed is 10. Secondary filter.
+            def master_account_name
+              @master_account_name || []
+            end
+
+            # List of master account names. Max number of elements allowed is 10. Secondary filter.
+            def master_account_name=(value)
+              parse_array_of_strings attribute: __method__, value: value, allow_empty: true
+            end
+
+            # List of billing transaction types. Max number of elements allowed is 10.
+            def transaction_type
+              @transaction_type || []
+            end
+
+            # List of billing transaction types. Max number of elements allowed is 10.
+            def transaction_type=(value)
+              parse_array_of_strings attribute: __method__,
+                                     value: value,
+                                     allowed: Api::Constants::Transactions::Parameters::NonFinancial::BillingApi::
+                                         TransactionTypes.all,
+                                     allow_empty: true
+            end
+
+            protected
+
+            # Billing API Authorization Token
+            def init_authorization_token
+              api_config.bearer_token = configuration.billing_api_token
+            end
+
+            # Billing API Transactions field validations
+            def init_field_validations
+              super
+
+              required_fields.push *%i[response_fields]
+              field_values.merge! sort_by_direction: Api::Constants::Transactions::Parameters::NonFinancial::
+                                      SortDirections.all,
+                                  sort_by_field: Api::Constants::Transactions::Parameters::NonFinancial::BillingApi::
+                                      OrderByFields.all
+            end
+
+            # Billing API Transactions custom validations
+            def check_requirements
+              super
+
+              validate_filters
+              validate_dates if @start_date || @end_date
+              validate_array_fields_size
+            end
+
+            # Transactions GraphQL query filters
+            def query_filters # rubocop:disable Metrics/MethodLength
+              {
+                filter: {
+                  startDate:             escape_argument(:start_date),
+                  endDate:               escape_argument(:end_date),
+                  uniqueId:              unique_id,
+                  billingStatement:      billing_statement,
+                  merchantTransactionId: merchant_transaction_id,
+                  masterAccountName:     master_account_name,
+                  transactionType:       transaction_type
+                },
+                sort:   {
+                  byDirection: sort_by_direction,
+                  byField:     sort_by_field
+                },
+                paging: {
+                  page:    page,
+                  perPage: per_page
+                }
+              }
+            end
+
+            # Transactions Response Fields
+            def query_response_fields
+              {
+                items:  response_fields,
+                paging: paging_query_fields
+              }
+            end
+
+            # Format given timestamp string to GraphQL suitable argument
+            def escape_argument(attribute)
+              __send__(attribute).to_s.empty? ? nil : "\"#{__send__(attribute)}\""
+            end
+
+            # Validate Billing API Primary filters
+            def validate_filters
+              unless start_date.nil? && end_date.nil? && unique_id.empty? && billing_statement.empty? &&
+                     merchant_transaction_id.empty?
+                return
+              end
+
+              raise ParameterError, 'At least one Primary filter is required!'
+            end
+
+            # Validate StartDate and EndDate
+            def validate_dates
+              message   = 'If filter startDate is provided, then endDate should also be provided and vice versa.'
+              raise ParameterError, message unless @start_date.is_a?(DateTime) && @end_date.is_a?(DateTime)
+
+              raise ParameterError, 'EndData must be after StartDate!' if @start_date == @end_date
+
+              days_diff = @end_date - @start_date
+              message   = 'Maximum difference between StartDate and EndDate is 7 days'
+              raise ParameterError, message unless days_diff >= 0 && days_diff <= 7
+            end
+
+            # Validate Billing API Array field requirements
+            def validate_array_fields_size
+              validate_array_size :unique_id, 10_000
+              validate_array_size :billing_statement, 10
+              validate_array_size :merchant_transaction_id, 10_000
+              validate_array_size :master_account_name, 10
+              validate_array_size :transaction_type, 10
+            end
+
+            # Validate Max size of the given Array attribute
+            def validate_array_size(attribute, size)
+              message = format 'Max array length on %{attribute} exceed allowed size of %{size}',
+                               attribute: attribute,
+                               size:      size
+
+              raise ParameterError, message if __send__(attribute).length > size
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/non_financial/consumers/create.rb

@@ -0,0 +1,44 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Consumers
+          # Creates a consumer based on email address
+          class Create < Base::Consumer
+
+            include Api::Mixins::Requests::CustomerAddress::BillingInfoAttributes
+            include Api::Mixins::Requests::CustomerAddress::ShippingInfoAttributes
+
+            attr_accessor :email
+
+            # Create Consumer constructor
+            def initialize(configuration, _builder_interface = nil)
+              super configuration
+
+              self.request_path = 'create_consumer'
+            end
+
+            protected
+
+            # Create Consumer field validations
+            def init_field_validations
+              super
+
+              required_fields.push *%i[email]
+            end
+
+            # Create Consumer request structure
+            def request_structure
+              {
+                email:            email,
+                billing_address:  billing_address_parameters_structure,
+                shipping_address: shipping_address_parameters_structure
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/non_financial/consumers/disable.rb

@@ -0,0 +1,40 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Consumers
+          # Disable consumer from usage until further action.
+          class Disable < Base::Consumer
+
+            attr_accessor :email, :consumer_id
+
+            # Disable Consumer constructor
+            def initialize(configuration, _builder_interface = nil)
+              super configuration
+
+              self.request_path = 'disable_consumer'
+            end
+
+            protected
+
+            # Disable consumer field validations
+            def init_field_validations
+              super
+
+              required_fields.push *%i[email consumer_id]
+            end
+
+            # Disable Consumer request structure
+            def request_structure
+              {
+                email:       email,
+                consumer_id: consumer_id
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/non_financial/consumers/enable.rb

@@ -0,0 +1,40 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Consumers
+          # Enable consumer that was disabled in the past.
+          class Enable < Base::Consumer
+
+            attr_accessor :email, :consumer_id
+
+            # Enable Consumer constructor
+            def initialize(configuration, _builder_interface = nil)
+              super configuration
+
+              self.request_path = 'enable_consumer'
+            end
+
+            protected
+
+            # Enable consumer field validations
+            def init_field_validations
+              super
+
+              required_fields.push *%i[email consumer_id]
+            end
+
+            # Enable Consumer request structure
+            def request_structure
+              {
+                email:       email,
+                consumer_id: consumer_id
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/non_financial/consumers/get_cards.rb

@@ -0,0 +1,40 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Consumers
+          # Get previously tokenized card details for a consumer.
+          class GetCards < Base::Consumer
+
+            attr_accessor :email, :consumer_id
+
+            # GetCards Consumer constructor
+            def initialize(configuration, _builder_interface = nil)
+              super configuration
+
+              self.request_path = 'get_consumer_cards'
+            end
+
+            protected
+
+            # GetCards consumer field validations
+            def init_field_validations
+              super
+
+              required_fields.push *%i[email consumer_id]
+            end
+
+            # GetCards Consumer request structure
+            def request_structure
+              {
+                email:       email,
+                consumer_id: consumer_id
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/non_financial/consumers/retrieve.rb

@@ -0,0 +1,40 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Consumers
+          # Retrieves consumer details based on consumer id or email
+          class Retrieve < Base::Consumer
+
+            attr_accessor :email, :consumer_id
+
+            # Retrieve Consumer constructor
+            def initialize(configuration, _builder_interface = nil)
+              super configuration
+
+              self.request_path = 'retrieve_consumer'
+            end
+
+            protected
+
+            # Retrieve Consumer custom field validations
+            def check_requirements
+              raise ParameterError, 'Either email or consumer_id field has to be set.' if email.nil? && consumer_id.nil?
+
+              super
+            end
+
+            # Retrieve Consumer request structure
+            def request_structure
+              {
+                email:       email,
+                consumer_id: consumer_id
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end