Error Handling
Payout Initiate Status Definition
Errors can be returned if a mandatory field or a header is missing from the Initiate Payout Request.
Error Code | Message | Reason |
---|---|---|
400 | Bad Request | Mandatory fields are missing, parameter mismatch or incorrect. E.g. “Request id should not be duplicated” |
401 | Rejected | The x-signatures do not match |
403 | Forbidden | Header parameter missing, its authentication error |
Sample error responses
Check Status
These errors will be shown if the payout status is either Failed or Rejected from Check Status API.
Coda Status | Coda Error Code | Coda Error Description |
---|---|---|
REJECTED | DAILY_LIMIT_EXCESS | The daily payout limit has been exceeded. Please try again the next day. |
INCOMPLETE_DATA | Incomplete Payment Details. Please check that you have input all relevant details and try again. | |
INSUFFICIENT_FUNDS | Payout balance has insufficient funds to complete this request. | |
MAX_LIMIT_EXCEED_INTERNAL | Please contact Coda Payments for more information |
Coda Status | Coda Error Code | Coda Error Description |
---|---|---|
FAILED | BENEFICIARY_REJECTED | Beneficiary rejected the payout. Please re-submit your payout request if this was a mistake. |
EXTERNAL_ERROR | Please contact Coda Payments support team. | |
INCOMPLETE_DATA | Incomplete Payment Details. Please check that you have input all relevant details and try again. | |
INTERNAL_ERROR | Please contact Coda Payments support team. | |
INVALID_ACCOUNT | Account is Closed, Frozen, or Inactive. Please check with your provider and try again when your account is active. | |
INVALID_ACCOUNT_DETAILS | Invalid Account Details. Please check your account details and try again. | |
INVALID_ACCOUNT_NUMBER | Invalid Account Number. Please re-submit with a valid account number. | |
INVALID_AMOUNT | Invalid amount. Please re-submit with a valid input amount. | |
INVALID_BANK_CODE | Invalid Bank Code. Please re-submit with a valid bank code. | |
INVALID_CURRENCY | Invalid Currency. Please check that both the sending and receiving currency are supported and valid. | |
INVALID_DATA | Invalid Payment Details. Please check that you have input all details correctly and try again. | |
INVALID_DATE | Invalid Date. Please check the date format or the validity of the date. | |
INVALID_ID | Invalid National ID. Please retry using a valid National ID. | |
INVALID_NAME | Invalid Name, symbols are not allowed. Please re-submit using a valid name. | |
INVALID_PHONE | Invalid phone number. Please retry using a valid phone number. | |
MAX_ACCOUNT_LIMIT_EXCEED | Exceeded maximum payout amount for your account. Please check your account limits before trying again. | |
MAX_COUNT_EXCEED | Exceeded transaction count limit. Please check your count limit and try again later. | |
MAX_LIMIT_EXCEED | Exceeded maximum amount. Please change the input amount and try again. | |
NOT_VODAFONE_CASH | MSISDN is not registered as Vodafone Cash. Please provide the correct mobile operator. (This only applies for Egypt payout) |
Last updated