Basics
Test Mode
Use test mode to test your Ivy integration before going live with payments.
Ivy’s Test Mode lets you safely test your integration without moving real money. Simulate payments, refunds, and more—so you can catch bugs and verify your workflow before going live.
You can simulate different payment and payout scenarios directly from the Dashboard:
What’s Next
Test Mode activated in the Ivy Dashboard
How to use Test Mode
1
Enable Test Mode in the Dashboard
Toggle the Test Mode switch at the top right of your Ivy Dashboard. This gives you access to test API keys and the sandbox environment.
2
Use Test API Keys
Find your test API key in the integration section. Use it to make requests to the Ivy Sandbox API:
https://api.sand.getivy.de.3
Simulate Transactions
Simulate success and error scenarios right from the Dashboard with the “Sandbox Tools” tab.
4
Switch to Live Mode When Ready
When you’re ready to accept real payments, activate your account, toggle off test mode, and use your live API keys.
Simulating incoming payments in Test Mode
Simulating customer payouts in Test Mode
Test mode and live mode are separate. Objects created in one mode are not accessible in the other. For example, a test-mode order can’t be used in a live payment.
Comparison of Test and Live Mode
The Test Mode toggle in the Dashboard does not affect your integration code. Your API keys and base URL determine the mode.
| Mode | When to Use | Objects Returned | How to Use |
|---|---|---|---|
| Test | While building and testing your integration. No real money is moved. | Simulated objects | Use test API keys and the sandbox base URL. Try test bank flows. |
| Live | When you’re ready to launch and accept real payments. Real money is moved. | Real objects | Use live API keys and the production base URL. Accept actual payment authorizations. |
What’s Next