Sandbox & Testing
Test Partner API integrations without moving real money or delivering real mobile money.
Partner API sandbox
| Property | Value |
|---|---|
| Base URL | https://sandbox.fiatsend.com/v1 |
| API keys | fs_test_* from console.fiatsend.com |
| MoMo | Simulated — no real disbursements |
| Withdrawal status | Auto: pending (~0s) → processing (~5s) → completed (~15s) |
| Data | May reset — do not rely on long-lived sandbox IDs |
Follow Partner API — Start Here.
Test phone numbers
Ghana numbers must be E.164: +233 + 9 digits (no leading zero).
| Phone | Network | Typical outcome |
|---|---|---|
+233501234567 | MTN | Success |
+233201234567 | Telecel | Success |
+233271234567 | AirtelTigo | Success |
Webhooks in sandbox
Register an HTTPS endpoint in Console or via POST /v1/webhooks. Use ngrok or similar for local development. Verify signatures with your sandbox webhook secret.
FiatsendOne
The consumer app at app.fiatsend.com uses production infrastructure for real users. For payment-intent E2E tests, coordinate with partners@fiatsend.com.
Pre-production checklist
-
fs_live_*key in secrets manager (not source code) - Base URL
https://api.fiatsend.com/v1 - Webhook HTTPS + signature verification
-
reference_idon every withdrawal - Handled
withdrawal.failedevents - End-to-end sandbox payout completed