Magic Numbers
Magic numbers let you test predictable sandbox outcomes without touching live customer accounts. Use them only with sandbox credentials and test traffic.
How To Use Them
- Use a sandbox credential.
- Send the test phone number in the customer or payment payload.
- Verify the API response and the webhook behavior.
- Confirm your system handles the result safely.
Example Outcomes
| Scenario | What to verify |
|---|---|
| Success | Your system marks the payment complete only after verified state |
| Decline | Your system keeps fulfilment blocked and shows the right customer state |
| Timeout | Your system waits, retries safely, or reconciles without guessing |
| Duplicate event | Your system dedupes by event ID |
| Delayed event | Your system can reconcile late state changes |
Important Limits
Sandbox outcomes are testing aids. They do not guarantee live provider behavior, live product availability, or production approval for your account.