test mode, also called the sandbox, lets you test the API without making payments or connecting a real account. The sandbox creates simulated objects without affecting real transactions or moving money.
To use test mode, send your test API keys when you call the API. You can find your test API keys in the Dashboard. API keys for test mode have the sk_test_ and pk_test_ prefixes.
The documentation pages for each product list the test credentials, so you can test every flow your users might follow.
You can use test mode for Movements, Payment Initiation, Direct Debit, and Transfers.
Test mode versus live mode
All Fintoc API requests occur in eithertest or live mode. API objects in one mode aren’t accessible from the other. The following table compares both modes:
The Test mode toggle in the Dashboard doesn’t affect your integration code. Your
test and live API keys determine your code’s behavior.
Why the Dashboard shows different sections in test and live mode
Every Fintoc product appears intest mode so you can explore the Dashboard. In live mode, a section you saw in test mode, such as Tesorería, may not appear for two reasons:
- The product isn’t enabled for your organization yet. If a section is missing, contact your Sales or Customer Success representative, or use the chat.
- Your role doesn’t include permission to view that section. Even when a product is enabled, you can see that section only if your role grants View access. If a teammate can see the section and you can’t, ask your Administrator to grant you access. See Permission Roles for how access levels work.