Ssentezo Developers
Sandbox
A new merchant organization starts as SANDBOX. It uses the same API host and routes as live. Collection, payout, bank transfer, and card checkout are answered by a simulator. They are not live payments.
Sandbox vs live is the organization status on the account. A request field cannot switch that. Use the test numbers below only on a SANDBOX organization.
What you can test
- Authentication errors, by omitting or changing the Basic header.
- Validation errors, by sending an amount below 500 or a bad phone number.
- Balance, bank list, transaction history, and status for references on that organization. The playground can run these for a signed-in sandbox merchant.
- A simulated collection, payout, bank transfer, or card checkout with one of the test numbers below. Any other number stays pending.
Simulated outcomes
Put the test number in msisdn, or include the matching token in your reference. Any other number or reference stays pending. The same outcome is reused when you check status later. Checking status again does not create a second payment.
A simulated success becomes SUCCEEDED when status is checked later, not necessarily at the moment the request is accepted. Pending and timeout stay unresolved. A timeout is not proof the payment failed. The simulator does not send a merchant callback.
| Outcome | Test number | Reference token |
|---|---|---|
| Success | 256770000001 | sandbox-success |
| Failure | 256770000002 | sandbox-failure |
| Pending | 256770000003 | sandbox-pending |
| Timeout | 256770000004 | sandbox-timeout |
There is no simulated cancellation status. Signed webhook delivery stays off unless that organization enables it.
Statuses the API returns
| API value | Meaning |
|---|---|
| SUCCEEDED | Payment completed. Safe to fulfill when the reference, amount, and currency match. |
| FAILED | Payment failed. |
| PENDING | Not finished yet. Keep waiting and poll status. |
There is no public cancelled or timed-out status. Leave an order pending until the status API says SUCCEEDED or FAILED.
Resetting a workspace
There is no API to wipe a sandbox organization. Create a new external reference for each attempt. References stay unique, including ones used on a request that later failed validation.
Going live
When an administrator sets the organization to LIVE, the same routes run real payments. The sandbox simulator no longer applies. Signed webhook delivery still stays off unless that organization enables it.