Test Mode
Use test mode to build and verify your integration without processing real payments.
How it works
Test mode uses the same API endpoints as live mode. The only difference is the API key prefix:
- Test keys:
sk_test_.../pk_test_... - Live keys:
sk_live_.../pk_live_...
Test mode behavior
| Feature | Test mode | Live mode |
|---|---|---|
| Virtual accounts | Created (partner sandbox) | Created (partner production) |
| Dynamic PayIDs | Created | Created |
| Webhooks | Delivered | Delivered |
| Real money movement | No | Yes |
| Domain restrictions | Localhost always allowed | Enforced |
Getting test keys
- Log in to the Dashboard
- Go to Developers > API Keys
- Create a key pair: test keys are generated by default
Testing payments
In test mode, checkout sessions are created normally. To simulate a completed payment, use the dashboard or wait for test webhook triggers.
TIP
Always verify your webhook handling works correctly in test mode before going live.