genesis_ruby 0.2.1 → 0.2.3

data/lib/genesis_ruby/api/requests/financial/online_banking_payments/eps.rb

@@ -0,0 +1,47 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module OnlineBankingPayments
+          # EPS is the main bank transfer payment method in Austria
+          class Eps < Base::Financial
+
+            include Api::Mixins::Requests::AddressInfoAttributes
+            include Api::Mixins::Requests::Financial::AsyncAttributes
+            include Api::Mixins::Requests::Financial::PaymentAttributes
+            include Api::Mixins::Requests::Financial::PendingPaymentAttributes
+
+            protected
+
+            # EPS transaction type
+            def transaction_type
+              Api::Constants::Transactions::EPS
+            end
+
+            # EPS field validations
+            def init_field_validations
+              required_fields.push *%i[transaction_id return_success_url return_failure_url
+               amount currency billing_country]
+              field_values.merge! currency:        'EUR',
+                                  billing_country: 'AT'
+            end
+
+            # EPS request structure
+            def payment_transaction_structure
+              payment_attributes_structure.merge(
+                {
+                  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
+                }
+              )
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/online_banking_payments/idebit/pay_in.rb

@@ -0,0 +1,55 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module OnlineBankingPayments
+          module Idebit
+            # iDebit PayIn transaction class
+            class PayIn < Requests::Base::Financial
+
+              include Api::Mixins::Requests::AddressInfoAttributes
+              include Api::Mixins::Requests::BirthDateAttributes
+              include Api::Mixins::Requests::Financial::PaymentAttributes
+
+              attr_reader :customer_account_id
+
+              # Customer account id parameter validation
+              def customer_account_id=(value)
+                limited_string attribute: __method__, value: value.to_s.empty? ? nil : value.to_s, max: 20
+              end
+
+              protected
+
+              # iDebit PayIn transaction type
+              def transaction_type
+                Api::Constants::Transactions::IDEBIT_PAYIN
+              end
+
+              # iDebit PayIn field validations
+              def init_field_validations
+                required_fields.push *%i[transaction_id customer_account_id amount currency billing_country]
+
+                field_values.merge! billing_country: 'CA'
+              end
+
+              # iDebit PayIn parameters structure
+              def payment_transaction_structure
+                payment_attributes_structure.merge(
+                  {
+                    customer_email:      customer_email,
+                    customer_phone:      customer_phone,
+                    customer_account_id: customer_account_id,
+                    birth_date:          birth_date,
+                    billing_address:     billing_address_parameters_structure,
+                    shipping_address:    shipping_address_parameters_structure
+                  }
+                )
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/online_banking_payments/idebit/pay_out.rb

@@ -0,0 +1,28 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module OnlineBankingPayments
+          module Idebit
+            # iDebit PayOut transaction class
+            class PayOut < Requests::Base::Reference
+
+              protected
+
+              # iDebit PayOut transaction type
+              def transaction_type
+                Constants::Transactions::IDEBIT_PAYOUT
+              end
+
+              # iDebit PayOut parameters structure
+              def reference_transaction_structure
+                {}
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/financial/online_banking_payments/wechat.rb

@@ -0,0 +1,53 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module Financial
+        module OnlineBankingPayments
+          # WeChat Pay solution offers merchants access to the over 300 million
+          # WeChat users that have linked payment accounts to their WeChat account
+          class Wechat < Base::Financial
+
+            include Api::Mixins::Requests::AddressInfoAttributes
+            include Api::Mixins::Requests::Financial::PaymentAttributes
+            include Api::Mixins::Requests::Financial::AsyncAttributes
+
+            attr_accessor :product_code, :product_num, :product_desc
+
+            protected
+
+            # WeChat transaction type
+            def transaction_type
+              Api::Constants::Transactions::WECHAT
+            end
+
+            # WeChat field validations
+            def init_field_validations
+              super
+
+              required_fields.push *%i[transaction_id usage return_success_url return_failure_url
+               amount currency billing_country]
+            end
+
+            # WeChat transaction request structure
+            def payment_transaction_structure # rubocop:disable Metrics/MethodLength
+              payment_attributes_structure.merge(
+                {
+                  return_success_url: return_success_url,
+                  return_failure_url: return_failure_url,
+                  product_code:       product_code,
+                  product_num:        product_num,
+                  product_desc:       product_desc,
+                  customer_email:     customer_email,
+                  customer_phone:     customer_phone,
+                  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/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/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,61 @@
+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::PaymentAttributes
+            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! currency:        Api::Constants::Currencies::Iso4217.all.map(&:upcase),
+                                  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
+              payment_attributes_structure.merge(
+                {
+                  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/wallets/alipay.rb

@@ -0,0 +1,49 @@
+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
+            include Api::Mixins::Requests::Financial::PaymentAttributes
+
+            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 # rubocop:disable Metrics/MethodLength
+              payment_attributes_structure.merge(
+                {
+                  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/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