Testing
Validate authentication, collections, payouts, webhook handling, and retry behavior in sandbox before you move your Verto integration to production.
Testing
Use sandbox testing to validate authentication, inbound collections, payout handling, webhook processing, and retry logic before you move to production.
✅ Before you test
Complete these steps first:
- Configure your app to use the sandbox base URL.
- Generate sandbox credentials and confirm you can authenticate.
- Register a webhook endpoint if your flow depends on asynchronous state changes.
- Decide which flows you need to validate: receive, FX, payout, or platform orchestration.
Core test goals
Make sure your integration can do all of the following in sandbox:
- Authenticate and send protected API requests successfully.
- Create or query the wallets, beneficiaries, or sub-accounts your flow depends on.
- Simulate or receive inbound funds and reconcile the resulting wallet credit.
- Execute outbound actions like FX conversion or payout without losing track of state.
- Process webhook deliveries and ignore duplicate events safely.
- Retry uncertain requests without creating duplicate financial operations.
Recommended test scenarios
| Scenario | What to validate |
|---|---|
| Authentication works | Your app can obtain a bearer token and use it on protected requests. |
| Inbound funds are reconciled | Wallet balances update only after the expected webhook state is received. |
| FX conversion settles correctly | Converted funds are not used downstream until the conversion is complete. |
| Payout timeout is safe | You retry with the same Idempotency-Key and reconcile final state via webhooks. |
| Platform scoping is correct | X-Sub-Account-Id or scoped auth always targets the intended downstream customer. |
Sandbox reminder
Sandbox uses test data only. No real money is transferred, and live settlement timing can differ from what you observe in test flows.
Next steps
| Testing & Sandbox Guide → Use simulation tools and sandbox-specific test flows. | Go-Live Requirements → Prepare your tested integration for production approval. |
Updated about 1 month ago
