Find Customer Endpoint Logic

The Find Customer endpoint enables the retrieval of detailed information about an existing customer using their customer ID . Below is the detailed documentation for the endpoint, including handling custom parameters and descriptions of the response body parameters.

Endpoint Functionality

Toqio uses the Find Customer endpoint to request details of an existing customer. This request involves:

  • Customer ID

In addition to common parameters, this endpoint can include custom parameters at the same hierarchical level. These custom parameters must be processed and returned by the integration connector.

Important: Secret parameters included in the response must be obfuscated to ensure security.

Custom Parameters

Once fully implemented in the integration connector, custom parameters can be returned within an additionalParams field.


Handling commercialName

The commercialName field differentiates the banking provider for each product in the account creation process. The logic for naming products is:

  • If a partner product has a defined label, this label will be shown visually.
  • If no label is available but the commercialName is provided, the product name will be formatted as: commercialName - Partner product code.
  • If neither a label nor a commercial name is provided, the product name defaults to: Default product - Partner product code.

Response Body Parameters

ParameterTypeDescription
idstringUnique identifier for the customer.
apiKeystringAPI key provided by the integration connector for secure authentication.
providerstringIdentifier of the provider associated with the customer.
superCustomerIdstringIdentifier for the super customer entity.
paymentProviderobjectDetails specific to the payment provider.
customerIdstringIdentifier provided by the payment provider for customer reference.
paymentProviderTypestringType/category of the payment provider
keystringAuthentication or configuration key with the payment provider.
loginIdstringLogin or authentication ID provided by the payment provider.
hmacKeystringKey used for HMAC-based authentication or validation processes.
commercialNamestringCommercial or brand name used to differentiate banking providers.
availableCurrenciesarray of stringsList of currency codes (ISO 4217) available for transactions with this provider.
codestringResponse code indicating the status of the request.
errorSeveritystringSeverity level of any errors encountered.
messagestringInformational message providing additional context or error details.
httpStatusint32HTTP status code corresponding to the response outcome.
requestIdstringUnique identifier for tracking and referencing the specific request.
datestringTimestamp indicating when the response was generated.

Following these guidelines ensures a consistent, secure, and effective approach to customer data retrieval within your integration.