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"
    }
}