Sandbox Testing Guide

The NadaPay sandbox is a fully functional replica of the production API with no real money movement. This page covers what the sandbox does differently, how to simulate key scenarios, and how to use it effectively before going live.

What the sandbox does differently

Behaviour	Sandbox	Production
Organization verification	Auto-approved instantly	Requires KYC/KYB review (1–3 days)
Wallet funding	Instant via test endpoint	Via bank transfer
Exchange rates	Simulated (fixed or range)	Live market rates
Transaction settlement	Simulated	Real settlement times per corridor
Data persistence	Periodic resets	Persistent

Sandbox mode

NadaPay uses one API surface for both sandbox and production.

Use your sandbox API key to send requests in sandbox mode. Use a production API key only for live processing.

Testing the documented payout flow

Use the same API paths in sandbox that you use in production. Your API key determines whether the request runs in sandbox or production mode.

1. Check verification status

GET /organizations/verification/KYB

2. Fetch organization accounts

GET /organizations/accounts

3. Create a beneficiary and resolve a bank account

POST /beneficiaries
POST /transactions/resolve-bank-account
POST /beneficiaries/{id}/accounts

4. Check limits, generate a quote, and execute the transaction

POST /transactions/limits
POST /transactions/quote
POST /transactions/execute

Use the request and response schemas in the API Reference for each endpoint. Do not add sandbox-only fields unless NadaPay has documented them for your account.

Sandbox data resets

Sandbox data may be periodically reset. Do not build your integration in a way that depends on sandbox data persisting indefinitely. Always be prepared to re-create test organizations, accounts, and beneficiaries from scratch.

Sandbox limitations

Exchange rates are simulated and do not reflect live market conditions
Some corridors available in production may be simulated or absent in sandbox
Data is not guaranteed to persist across resets

Ready to go live?

When your sandbox testing is complete, follow Going Live before switching to a production API key.