API docs · 13 of 14
Errors
Errors use the normal HTTP status codes and always have the same shape:
{
"success": false,
"error": { "code": "insufficient_balance", "message": "Not enough money in this wallet for the amount plus fees." }
}Write your code against error.code, which does not change. error.message is written for people and may change.
| Status | Code | What happened |
|---|---|---|
| 400 | invalid_currency | currency is missing or not one of the five. |
| 400 | invalid_amount | amount is missing, zero, negative or not a whole number. |
| 400 | invalid_phone | The phone number is not valid for that country. |
| 400 | below_minimum | The amount is under the minimum for that currency. |
| 400 | above_maximum | The amount (including fees, for collections) is over the maximum. |
| 400 | insufficient_balance | Your wallet cannot cover a payout plus its fees. |
| 401 | invalid_api_key | The key is missing, wrong or revoked. |
| 403 | kyc_required | Live keys only work once your business is verified. |
| 403 | account_frozen | The account is frozen. Contact support. |
| 404 | not_found | No transaction with that reference for this key, or the endpoint does not exist. |
| 429 | too_many_prompts | Too many payment requests to one phone number (5 every 10 minutes). |
| 502 | provider_refused | The mobile network refused the request. Nothing was charged. |
| 500 | server_error | Something went wrong on our side. It is safe to retry with the same Idempotency-Key. |