What sandbox is
Sandbox is a test version of the live API. Every endpoint behaves identically: same validation, same auth, same error envelope, same response shape. But:- No wallet impact — sandbox transactions do not move real funds
- Callbacks are not sent for sandbox transactions
Trigger codes
In sandbox, the trailing cents ofsource_amount decide the outcome:
source_amount ends in | sendPayoutRequest → | getPayoutStatus later → |
|---|---|---|
.00 | pending | completed |
.01 | pending | failed (Insufficient funds) |
.02 | pending | failed (Recipient not found) |
.03 | pending | pending (stays pending — useful for polling tests) |
.04 | pending | failed (Network error) |
.00 path.
Example
Sandbox transaction IDs
Sandboxtransaction_ids are prefixed sb_ so they’re easy to recognize and impossible to confuse with live IDs:
sb_ ID returned to one account cannot be queried by another.
What sandbox is NOT for
- Load testing (use a staging or dedicated test environment)
- Verifying callback delivery (callbacks are not sent in sandbox — see Callbacks)
- Validating exchange rates (quotes return placeholder rates)