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:

  1. Configure your app to use the sandbox base URL.
  2. Generate sandbox credentials and confirm you can authenticate.
  3. Register a webhook endpoint if your flow depends on asynchronous state changes.
  4. 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:

  1. Authenticate and send protected API requests successfully.
  2. Create or query the wallets, beneficiaries, or sub-accounts your flow depends on.
  3. Simulate or receive inbound funds and reconcile the resulting wallet credit.
  4. Execute outbound actions like FX conversion or payout without losing track of state.
  5. Process webhook deliveries and ignore duplicate events safely.
  6. Retry uncertain requests without creating duplicate financial operations.

Recommended test scenarios

ScenarioWhat to validate
Authentication worksYour app can obtain a bearer token and use it on protected requests.
Inbound funds are reconciledWallet balances update only after the expected webhook state is received.
FX conversion settles correctlyConverted funds are not used downstream until the conversion is complete.
Payout timeout is safeYou retry with the same Idempotency-Key and reconcile final state via webhooks.
Platform scoping is correctX-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.