Using Product ID in Account Creation

In the Toqio ecosystem, account creation and management rely on key identifiers:

• productId:A unique identifier for specific financial products configured in Toqio.
• accountType (planned to be DEPRECATED): Represents the banking partner's product type (e.g., current account, loan account, savings account, acquiring account for PoS products). It is mandatory for creating accounts.
• partnerProduct: The identifier widely used across various Toqio endpoints, indicating the specific partner product associated with an account. It always matches the value of accountType.

These identifiers ensure accurate and efficient integration with BaaS partners.

Current Use of productId

Currently, within the Toqio API, the productId parameter is not mandatory when creating accounts. However, specifying a productId can enhance management, reporting, and integration clarity when dealing with multiple financial products.

Please note that if you intend to use the Create Account endpoint for our new ledger apps like PoS, productId will always be required

Mandatory Parameter: accountType (planned to be DEPRECATED)

The accountType parameter is currently mandatory when creating an account via the Public API. Please note, accountType always has the same value as the partnerProduct field used across other Toqio endpoints.

To obtain available values for accountType, use the Get partner products endpoint, which returns a list of BaaS partner products configured for a Customer.

Toqio plans to make productId a required parameter in future API versions to strengthen product-management capabilities and to deprecate the accountType parameter.

Recommendations for Integrators

Given the upcoming changes, we recommend proactively making productId a mandatory field in your current integrations and plan for the accountTypeto be deprecated.

Related Endpoints for productId Management

To effectively manage products, use these endpoints:

• Retrieve Products: Use Get Products to fetch existing product details.
• Update Products: Modify existing products via Edit Existing Products.
• Create Products: Add new products through Create New Products.