Test mode
Use test mode to test your Fintoc integration before going live.
Fintoc has a test mode, also called the sandbox, for you to test the API without making actual payments or connecting a real account. The sandbox is a testing environment that simulates creating real objects without the risk of affecting real transactions or moving actual 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. Your test API keys 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 either test mode or live mode. API objects in one mode aren’t accessible to the other.
| Mode | When to use | Objects | How to use |
|---|---|---|---|
| test mode | Use test mode, and its associated test API keys, as you build your integration. | API calls return simulated objects. For example, you can retrieve and use test Link, Movement, CheckoutSession, and Subscription objects. | Use test bank accounts. You can’t accept real payment methods or work with real accounts. |
| live mode | Use live mode, and its associated live API keys, when you’re ready to launch your integration and accept real money or connect real accounts. | API calls return real objects. For example, you can retrieve and use real Link, Movement, CheckoutSession, and Subscription objects. | Accept real bank accounts and work with customer accounts. You can accept real payment authorizations and charges, and connect real links. |
The Test mode toggle in the Dashboard doesn’t affect your integration code. Your test and live mode API keys are what ultimately affect the behavior of your code.
Why the Dashboard shows different sections in test and live mode
Test mode shows every Fintoc product so you can explore the Dashboard freely. In live mode, a section that you saw in test mode (for example 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, only users whose role grants View access can see that section. 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.