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 ofaccountType.
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.
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
productIda required parameter in future API versions to strengthen product-management capabilities and clarity and to deprecatetheaccountTypeparameter
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.