Test in Sandbox
Step 7: Test Payments in Sandbox
Sandbox lets you simulate the full payment experience without real funds. Use your Sandbox API keys and follow the same integration steps as Production.
Common mistake: Using Production API keys in Sandbox. Always double-check which key pair you're using.
How Sandbox Payments Work
No dummy cards, wallets, or tokens needed. After selecting a payment method in the widget, choose Pass or Fail to simulate the outcome.
What Happens
On Pass:
- Status updates to
fund_settledorasset_settled - Webhook sent to your endpoint
- Customer redirected to
successRedirectUrl
On Fail:
- Status updates to
fund_failed - Webhook sent
- Customer redirected to
failureRedirectUrl
What to Verify
- ✅ Transaction status updated correctly
- ✅ Webhook received and processed
- ✅ Redirect triggered to the right URL
- ✅ Duplicate webhook delivery handled correctly (idempotency)
Common Issues
| Issue | Cause |
|---|---|
| No payment methods shown | Currency not enabled in widget |
| Webhook not received | Webhook URL not configured for Sandbox |
| Transaction fails silently | Wrong API keys |
| Redirect not working | Missing or malformed redirect URLs |
Was this page helpful?