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.

StatusCodeWhat happened
400invalid_currencycurrency is missing or not one of the five.
400invalid_amountamount is missing, zero, negative or not a whole number.
400invalid_phoneThe phone number is not valid for that country.
400below_minimumThe amount is under the minimum for that currency.
400above_maximumThe amount (including fees, for collections) is over the maximum.
400insufficient_balanceYour wallet cannot cover a payout plus its fees.
401invalid_api_keyThe key is missing, wrong or revoked.
403kyc_requiredLive keys only work once your business is verified.
403account_frozenThe account is frozen. Contact support.
404not_foundNo transaction with that reference for this key, or the endpoint does not exist.
429too_many_promptsToo many payment requests to one phone number (5 every 10 minutes).
502provider_refusedThe mobile network refused the request. Nothing was charged.
500server_errorSomething went wrong on our side. It is safe to retry with the same Idempotency-Key.