card-management-sdk 1.0.0

data/lib/shell_card_management_ap_is/exceptions/o_auth_provider_exception.rb

@@ -0,0 +1,48 @@
+# shell_card_management_ap_is
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module ShellCardManagementApIs
+  # OAuth 2 Authorization endpoint exception.
+  class OAuthProviderException < APIException
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Gets or sets error code.
+    # @return [OAuthProviderErrorEnum]
+    attr_accessor :error
+
+    # Gets or sets human-readable text providing additional information on
+    # error.
+    # Used to assist the client developer in understanding the error that
+    # occurred.
+    # @return [String]
+    attr_accessor :error_description
+
+    # Gets or sets a URI identifying a human-readable web page with information
+    # about the error, used to provide the client developer with additional
+    # information about the error.
+    # @return [String]
+    attr_accessor :error_uri
+
+    # The constructor.
+    # @param [String] The reason for raising an exception.
+    # @param [HttpResponse] The HttpReponse of the API call.
+    def initialize(reason, response)
+      super(reason, response)
+      hash = APIHelper.json_deserialize(@response.raw_body)
+      unbox(hash)
+    end
+
+    # Populates this object by extracting properties from a hash.
+    # @param [Hash] The deserialized response sent by the server in the
+    # response body.
+    def unbox(hash)
+      @error = hash.key?('error') ? hash['error'] : nil
+      @error_description =
+        hash.key?('error_description') ? hash['error_description'] : SKIP
+      @error_uri = hash.key?('error_uri') ? hash['error_uri'] : SKIP
+    end
+  end
+end

data/lib/shell_card_management_ap_is/http/auth/basic_auth.rb

@@ -0,0 +1,50 @@
+# shell_card_management_ap_is
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module ShellCardManagementApIs
+  # Utility class for basic authorization.
+  class BasicAuth < CoreLibrary::HeaderAuth
+    include CoreLibrary
+    # Display error message on occurrence of authentication failure.
+    # @returns [String] The oAuth error message.
+    def error_message
+      'BasicAuth: username or password is undefined.'
+    end
+
+    # Initialization constructor.
+    def initialize(basic_auth_credentials)
+      auth_params = {}
+      unless basic_auth_credentials.nil? ||
+             basic_auth_credentials.username.nil? ||
+             basic_auth_credentials.password.nil?
+        auth_params['Authorization'] =
+          "Basic #{AuthHelper.get_base64_encoded_value(basic_auth_credentials.username,
+                                                       basic_auth_credentials.password)}"
+      end
+
+      super auth_params
+    end
+  end
+
+  # Data class for BasicAuthCredentials.
+  class BasicAuthCredentials
+    attr_reader :username, :password
+
+    def initialize(username:, password:)
+      raise ArgumentError, 'username cannot be nil' if username.nil?
+      raise ArgumentError, 'password cannot be nil' if password.nil?
+
+      @username = username
+      @password = password
+    end
+
+    def clone_with(username: nil, password: nil)
+      username ||= self.username
+      password ||= self.password
+
+      BasicAuthCredentials.new(username: username, password: password)
+    end
+  end
+end

data/lib/shell_card_management_ap_is/http/auth/bearer_token.rb

@@ -0,0 +1,89 @@
+# shell_card_management_ap_is
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module ShellCardManagementApIs
+  # Utility class for OAuth 2 authorization and token management.
+  class BearerToken < CoreLibrary::HeaderAuth
+    include CoreLibrary
+    # Display error message on occurrence of authentication failure.
+    # @returns [String] The oAuth error message.
+    def error_message
+      'BearerToken: OAuthToken is undefined or expired.'
+    end
+
+    # Initialization constructor.
+    def initialize(bearer_token_credentials, config)
+      auth_params = {}
+      @_o_auth_client_id = bearer_token_credentials.o_auth_client_id unless
+        bearer_token_credentials.nil? || bearer_token_credentials.o_auth_client_id.nil?
+      @_o_auth_client_secret = bearer_token_credentials.o_auth_client_secret unless
+        bearer_token_credentials.nil? || bearer_token_credentials.o_auth_client_secret.nil?
+      @_o_auth_token = bearer_token_credentials.o_auth_token unless
+        bearer_token_credentials.nil? || bearer_token_credentials.o_auth_token.nil?
+      @_o_auth_api = OAuthAuthorizationController.new(config)
+      auth_params['Authorization'] = "Bearer #{@_o_auth_token.access_token}" unless @_o_auth_token.nil?
+
+      super auth_params
+    end
+
+    # Validates the oAuth token.
+    # @return [Boolean] true if the token is present and not expired.
+    def valid
+      !@_o_auth_token.nil? && !token_expired?(@_o_auth_token)
+    end
+
+    # Builds the basic auth header for endpoints in the OAuth Authorization Controller.
+    # @return [String] The value of the Authentication header.
+    def build_basic_auth_header
+      "Basic #{AuthHelper.get_base64_encoded_value(@_o_auth_client_id, @_o_auth_client_secret)}"
+    end
+
+    # Fetches the token.
+    # @param [Hash] additional_params Any additional form parameters.
+    # @return [OAuthToken] The oAuth token instance.
+    def fetch_token(additional_params: nil)
+      token = @_o_auth_api.request_token_bearer_token(
+        build_basic_auth_header,
+        _field_parameters: additional_params
+      )
+      if token.respond_to?('expires_in') && !token.expires_in.nil?
+        token.expiry = AuthHelper.get_token_expiry(token.expires_in, Time.now.utc.to_i)
+      end
+      token
+    end
+
+    # Checks if OAuth token has expired.
+    # @param [OAuthToken] token The oAuth token instance.
+    # @return [Boolean] true if the token's expiry exist and also the token is expired, false otherwise.
+    def token_expired?(token)
+      token.respond_to?('expiry') && AuthHelper.token_expired?(token.expiry)
+    end
+  end
+
+  # Data class for BearerTokenCredentials.
+  class BearerTokenCredentials
+    attr_reader :o_auth_client_id, :o_auth_client_secret, :o_auth_token
+
+    def initialize(o_auth_client_id:, o_auth_client_secret:, o_auth_token: nil)
+      raise ArgumentError, 'o_auth_client_id cannot be nil' if o_auth_client_id.nil?
+      raise ArgumentError, 'o_auth_client_secret cannot be nil' if o_auth_client_secret.nil?
+
+      @o_auth_client_id = o_auth_client_id
+      @o_auth_client_secret = o_auth_client_secret
+      @o_auth_token = o_auth_token
+    end
+
+    def clone_with(o_auth_client_id: nil, o_auth_client_secret: nil,
+                   o_auth_token: nil)
+      o_auth_client_id ||= self.o_auth_client_id
+      o_auth_client_secret ||= self.o_auth_client_secret
+      o_auth_token ||= self.o_auth_token
+
+      BearerTokenCredentials.new(o_auth_client_id: o_auth_client_id,
+                                 o_auth_client_secret: o_auth_client_secret,
+                                 o_auth_token: o_auth_token)
+    end
+  end
+end

data/lib/shell_card_management_ap_is/http/http_call_back.rb

@@ -0,0 +1,10 @@
+# shell_card_management_ap_is
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module ShellCardManagementApIs
+  # HttpCallBack allows defining callables for pre and post API calls.
+  class HttpCallBack < CoreLibrary::HttpCallback
+  end
+end

data/lib/shell_card_management_ap_is/http/http_method_enum.rb

@@ -0,0 +1,10 @@
+# shell_card_management_ap_is
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module ShellCardManagementApIs
+  # HTTP Methods Enumeration.
+  class HttpMethodEnum < CoreLibrary::HttpMethod
+  end
+end

data/lib/shell_card_management_ap_is/http/http_request.rb

@@ -0,0 +1,10 @@
+# shell_card_management_ap_is
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module ShellCardManagementApIs
+  # Represents a single Http Request.
+  class HttpRequest < CoreLibrary::HttpRequest
+  end
+end

data/lib/shell_card_management_ap_is/http/http_response.rb

@@ -0,0 +1,10 @@
+# shell_card_management_ap_is
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module ShellCardManagementApIs
+  # Http response received.
+  class HttpResponse < CoreLibrary::HttpResponse
+  end
+end

data/lib/shell_card_management_ap_is/models/account_access.rb

@@ -0,0 +1,128 @@
+# shell_card_management_ap_is
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module ShellCardManagementApIs
+  # AccountAccess Model.
+  class AccountAccess < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Collecting company id.
+    # @return [Integer]
+    attr_accessor :colco_id
+
+    # Collecting company code.
+    # @return [Integer]
+    attr_accessor :colco_code
+
+    # Payer Id to which the user has access
+    # @return [Integer]
+    attr_accessor :payer_id
+
+    # Payer Number to which the user has access
+    # @return [String]
+    attr_accessor :payer_number
+
+    # Name of the Payer to which the user has access
+    # @return [String]
+    attr_accessor :payer_name
+
+    # Account Id to which the user has access
+    # @return [Integer]
+    attr_accessor :account_id
+
+    # Account Number to which the user has access
+    # @return [String]
+    attr_accessor :account_number
+
+    # Name of the Account to which the user has access
+    # @return [String]
+    attr_accessor :account_name
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['colco_id'] = 'ColcoId'
+      @_hash['colco_code'] = 'ColcoCode'
+      @_hash['payer_id'] = 'PayerId'
+      @_hash['payer_number'] = 'PayerNumber'
+      @_hash['payer_name'] = 'PayerName'
+      @_hash['account_id'] = 'AccountId'
+      @_hash['account_number'] = 'AccountNumber'
+      @_hash['account_name'] = 'AccountName'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        colco_id
+        colco_code
+        payer_id
+        payer_number
+        payer_name
+        account_id
+        account_number
+        account_name
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      %w[
+        colco_id
+        colco_code
+        payer_id
+        payer_number
+        payer_name
+        account_id
+        account_name
+      ]
+    end
+
+    def initialize(colco_id = SKIP,
+                   colco_code = SKIP,
+                   payer_id = SKIP,
+                   payer_number = SKIP,
+                   payer_name = SKIP,
+                   account_id = SKIP,
+                   account_number = SKIP,
+                   account_name = SKIP)
+      @colco_id = colco_id unless colco_id == SKIP
+      @colco_code = colco_code unless colco_code == SKIP
+      @payer_id = payer_id unless payer_id == SKIP
+      @payer_number = payer_number unless payer_number == SKIP
+      @payer_name = payer_name unless payer_name == SKIP
+      @account_id = account_id unless account_id == SKIP
+      @account_number = account_number unless account_number == SKIP
+      @account_name = account_name unless account_name == SKIP
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      colco_id = hash.key?('ColcoId') ? hash['ColcoId'] : SKIP
+      colco_code = hash.key?('ColcoCode') ? hash['ColcoCode'] : SKIP
+      payer_id = hash.key?('PayerId') ? hash['PayerId'] : SKIP
+      payer_number = hash.key?('PayerNumber') ? hash['PayerNumber'] : SKIP
+      payer_name = hash.key?('PayerName') ? hash['PayerName'] : SKIP
+      account_id = hash.key?('AccountId') ? hash['AccountId'] : SKIP
+      account_number = hash.key?('AccountNumber') ? hash['AccountNumber'] : SKIP
+      account_name = hash.key?('AccountName') ? hash['AccountName'] : SKIP
+
+      # Create object from extracted values.
+      AccountAccess.new(colco_id,
+                        colco_code,
+                        payer_id,
+                        payer_number,
+                        payer_name,
+                        account_id,
+                        account_number,
+                        account_name)
+    end
+  end
+end

data/lib/shell_card_management_ap_is/models/account_request.rb

@@ -0,0 +1,252 @@
+# shell_card_management_ap_is
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module ShellCardManagementApIs
+  # AccountRequest Model.
+  class AccountRequest < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Account Status.
+    # Optional if StatusList is passed, else mandatory.
+    # Ignored if StatusList is passed.
+    # Allowed values:
+    # •	ALL
+    # •	ACTIVE
+    # •	BLOCKED
+    # •	CANCELLED
+    # •	CREDITLOCK
+    # •	DELINQUENCYLOCK
+    # @return [String]
+    attr_accessor :status
+
+    # Include card summary details in the response.
+    # When passed as false, the card summary related parameters on response will
+    # be set to null.
+    # Optional – default value: true.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :include_card_summary
+
+    # Payer id of the customer.
+    # Optional if PayerNumber is passed, else Mandatory.
+    # @return [Integer]
+    attr_accessor :payer_id
+
+    # PayerNumber of the customer.
+    # Optional if PayerId is passed, else Mandatory.
+    # @return [String]
+    attr_accessor :payer_number
+
+    # Page Size – Number of records to show on a page.
+    # Optional
+    # Default value 50
+    # @return [Integer]
+    attr_accessor :page_size
+
+    # API Request Id
+    # @return [String]
+    attr_accessor :request_id
+
+    # Collecting Company Code (Shell Code) of the selected payer. 
+    # ColCoCode or ColCoCountryCode  is Mandatory for serviced OUs such as
+    # Romania, Latvia, Lithuania, Estonia, Ukraine etc. It is optional for other
+    # countries if ColCoID is provided.
+    # @return [Integer]
+    attr_accessor :col_co_code
+
+    # The 2-character ISO Code for the customer and card owning country.
+    # ColCoCode or ColCoCountryCode  is Mandatory for serviced OUs such as
+    # Romania, Latvia, Lithuania, Estonia, Ukraine etc. It is optional for other
+    # countries if ColCoID is provided.
+    # @return [String]
+    attr_accessor :col_co_country_code
+
+    # Page Number (as shown to the users)
+    # Optional
+    # Default value 1
+    # @return [Integer]
+    attr_accessor :current_page
+
+    # Optional – default value: false.
+    # When passed as true, the API will return accounts that are configured as
+    # Invoice Point only.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :invoice_points_only
+
+    # Collecting Company Id (in GFN) of the selected payer. 
+    # Optional if ColCoCode or ColCoCountryCode  is passed else Mandatory.
+    # @return [Integer]
+    attr_accessor :col_co_id
+
+    # Return e-Toll Customer details When True.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :return_tolls_customer_id
+
+    # Return e-Toll Customer details When True.
+    # @return [Array[Accounts]]
+    attr_accessor :accounts
+
+    # Account Name of the customer.
+    # Optional. 
+    # Minimum of 4 characters should be provided else not considered.
+    # Accounts those have the entered value at any part of the Name will be
+    # returned.
+    # @return [String]
+    attr_accessor :account_name
+
+    # Account Statuses.
+    # Optional 
+    # Multiple statuses are allowed to be included in the search criteria.
+    # Allowed values:
+    # •	ACTIVE
+    # •	BLOCKED
+    # •	CANCELLED
+    # •	CREDITLOCK
+    # •	DELINQUENCYLOCK
+    # @return [Array[String]]
+    attr_accessor :status_list
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['status'] = 'Status'
+      @_hash['include_card_summary'] = 'IncludeCardSummary'
+      @_hash['payer_id'] = 'PayerId'
+      @_hash['payer_number'] = 'PayerNumber'
+      @_hash['page_size'] = 'PageSize'
+      @_hash['request_id'] = 'RequestId'
+      @_hash['col_co_code'] = 'ColCoCode'
+      @_hash['col_co_country_code'] = 'ColCoCountryCode'
+      @_hash['current_page'] = 'CurrentPage'
+      @_hash['invoice_points_only'] = 'InvoicePointsOnly'
+      @_hash['col_co_id'] = 'ColCoId'
+      @_hash['return_tolls_customer_id'] = 'ReturnTollsCustomerId'
+      @_hash['accounts'] = 'Accounts'
+      @_hash['account_name'] = 'AccountName'
+      @_hash['status_list'] = 'StatusList'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        status
+        include_card_summary
+        payer_id
+        payer_number
+        page_size
+        request_id
+        col_co_code
+        col_co_country_code
+        current_page
+        invoice_points_only
+        col_co_id
+        return_tolls_customer_id
+        accounts
+        account_name
+        status_list
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      %w[
+        status
+        payer_id
+        payer_number
+        page_size
+        request_id
+        col_co_code
+        col_co_country_code
+        current_page
+        invoice_points_only
+        col_co_id
+        account_name
+      ]
+    end
+
+    def initialize(status = SKIP,
+                   include_card_summary = true,
+                   payer_id = SKIP,
+                   payer_number = SKIP,
+                   page_size = SKIP,
+                   request_id = SKIP,
+                   col_co_code = SKIP,
+                   col_co_country_code = SKIP,
+                   current_page = SKIP,
+                   invoice_points_only = false,
+                   col_co_id = SKIP,
+                   return_tolls_customer_id = SKIP,
+                   accounts = SKIP,
+                   account_name = SKIP,
+                   status_list = SKIP)
+      @status = status unless status == SKIP
+      @include_card_summary = include_card_summary unless include_card_summary == SKIP
+      @payer_id = payer_id unless payer_id == SKIP
+      @payer_number = payer_number unless payer_number == SKIP
+      @page_size = page_size unless page_size == SKIP
+      @request_id = request_id unless request_id == SKIP
+      @col_co_code = col_co_code unless col_co_code == SKIP
+      @col_co_country_code = col_co_country_code unless col_co_country_code == SKIP
+      @current_page = current_page unless current_page == SKIP
+      @invoice_points_only = invoice_points_only unless invoice_points_only == SKIP
+      @col_co_id = col_co_id unless col_co_id == SKIP
+      @return_tolls_customer_id = return_tolls_customer_id unless return_tolls_customer_id == SKIP
+      @accounts = accounts unless accounts == SKIP
+      @account_name = account_name unless account_name == SKIP
+      @status_list = status_list unless status_list == SKIP
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      status = hash.key?('Status') ? hash['Status'] : SKIP
+      include_card_summary = hash['IncludeCardSummary'] ||= true
+      payer_id = hash.key?('PayerId') ? hash['PayerId'] : SKIP
+      payer_number = hash.key?('PayerNumber') ? hash['PayerNumber'] : SKIP
+      page_size = hash.key?('PageSize') ? hash['PageSize'] : SKIP
+      request_id = hash.key?('RequestId') ? hash['RequestId'] : SKIP
+      col_co_code = hash.key?('ColCoCode') ? hash['ColCoCode'] : SKIP
+      col_co_country_code =
+        hash.key?('ColCoCountryCode') ? hash['ColCoCountryCode'] : SKIP
+      current_page = hash.key?('CurrentPage') ? hash['CurrentPage'] : SKIP
+      invoice_points_only = hash['InvoicePointsOnly'] ||= false
+      col_co_id = hash.key?('ColCoId') ? hash['ColCoId'] : SKIP
+      return_tolls_customer_id =
+        hash.key?('ReturnTollsCustomerId') ? hash['ReturnTollsCustomerId'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      accounts = nil
+      unless hash['Accounts'].nil?
+        accounts = []
+        hash['Accounts'].each do |structure|
+          accounts << (Accounts.from_hash(structure) if structure)
+        end
+      end
+
+      accounts = SKIP unless hash.key?('Accounts')
+      account_name = hash.key?('AccountName') ? hash['AccountName'] : SKIP
+      status_list = hash.key?('StatusList') ? hash['StatusList'] : SKIP
+
+      # Create object from extracted values.
+      AccountRequest.new(status,
+                         include_card_summary,
+                         payer_id,
+                         payer_number,
+                         page_size,
+                         request_id,
+                         col_co_code,
+                         col_co_country_code,
+                         current_page,
+                         invoice_points_only,
+                         col_co_id,
+                         return_tolls_customer_id,
+                         accounts,
+                         account_name,
+                         status_list)
+    end
+  end
+end