Mobile Money Error Codes

For sandbox bank codes, account numbers, and test payout behavior, see Payouts > Sandbox / Test Mode.

Transfer Errors

Error Message	Cause
`Name query failed`	Account name verification was unsuccessful. Check the account number and bank code.
`Insufficient wallet balance`	Sender wallet does not have enough funds to complete the transfer.

{
  "success": false,
  "message": "Name query failed"
}

Verify the beneficiary details with /api/v1/account_name_verify before initiating a transfer.
Confirm that the bank_code matches the selected bank or mobile money provider.
Confirm that the currency value is either KES or GHS.
Check wallet balance before retrying transfers that fail with Insufficient wallet balance.