Testing & Sandbox
How to safely test your SamaPay integration using our magic numbers and simulation tools.
Before you switch to production, it is crucial to test every possible payment outcome. Our sandbox environment allows you to simulate success, failures, and timeouts by using specific phone numbers.
Magic Numbers
Use these phone numbers in the customer.phone field during checkout to trigger specific scenarios.
| Phone Number | Expected Outcome | Scenario |
|---|---|---|
2207000000 | Success | Standard successful checkout |
2206000001 | Failure | Insufficient user balance |
2206000002 | Timeout | User didn't enter PIN in time |
2206000003 | Blocked | KYC-limited or blocked account |
Simulation Flow
When you use a magic number, our backend bypasses the actual Wave/QMoney gateway and returns the simulated response immediately to your webhook URL.
Loading Flow...
Magic numbers only work in the Sandbox environment. Using these numbers in Production will attempt to charge actual accounts (if they exist).
Verification Steps
- Initiate: Start a checkout session via API or Dashboard.
- Redirect: Open the
checkout_urlprovided in the response. - Trigger: Enter one of the Magic Numbers above.
- Listen: Check your Webhook Logs for the incoming event.
- Analyze: Ensure your system handles the
metadataandstatusfields correctly.