Errors Registry
The following is a list of potential error codes that can be returned when using the Payouts API
Response Error Code | HTTP Status Code | Response Description | Meaning |
---|---|---|---|
011 | 400 | ACCOUNT_LOOKUP_FAILED | Name lookup failed for the specified account number and bank |
012 | 400 | INSUFFICIENT_BALANCE | The transaction creation request failed due to insufficient balance on the customer account |
014 | 409 | EXISTING_TRANSACTION_CUSTOMER_REFERENCE | The transaction creation request could not be processed because an existing transaction of the same customer reference exists. |
013 | 400 | INVALID_REQUEST | Other Invalid requests that cannot be processed. e.g Unsupported country codes |
400 | 400 | INVALID_REQUEST | Invalid request due to invalid input parameters. |
018 | 409 | TRANSACTION_CANNOT_BE_CANCELLED | The request could not be processed because the transaction is no longer in a state that allows cancellation |
015 | 404 | NOT_FOUND | Currently requested resource not found on the system |
016 | 404 | UNAUTHORIZED | The request is rejected due to missing/invalid/inactive API key |
017 | 403 | FORBIDDEN | When access is denied based on the status of the user. e.g A non-active customer trying to make a payout |
999 | 500 | UNKNOWN_ERROR | An unknown error has occurred, this rarely happens. Please contact support if this persists. |
Examples
{
"error": {
"message": "Transfer with id wz_trsf_qYvR_1690198508263 is not cancellable",
"code": "014",
"description": "TRANSACTION_CANNOT_BE_CANCELLED"
}
}
{
"error": {
"message": "Invalid request in body",
"code": "400",
"description": "INVALID_REQUEST",
"field_errors": [
{
"field": "country",
"message": "\"country\" is required"
}
]
}
}
{
"error": {
"message": "Insufficient Balance of ₦940000.00, requires ₦35060000.00 more",
"code": "012",
"description": "INSUFFICIENT_BALANCE"
}
}
{
"error": {
"message": "Only Nigerian transfers are supported",
"code": "013",
"description": "INVALID_REQUEST"
}
}
Updated 10 months ago
What’s Next