Payout response codes
Last updated: April 29, 2022
After you've sent your payout request and got a successful response, you will receive a webhook notification that will tell you the status of your payout and include a response code and summary:
- If your payout is successful, you will receive a
payment_paid
webhook, with a10000
response code and theApproved
summary. - If your payout is declined, you will receive a
payment_declined
webhook with a50001-50399
response code and a summary explaining the reason for the decline. - If your payout is returned, you will receive a
payment_returned
webhook with50401-50599
response code and a summary explaining the reason for the return.
Below, you'll find all the response codes you could receive and their summaries.
Code | Summary |
---|---|
Approval response | |
| Approved |
Code | Summary |
---|---|
Decline responses | |
| Compliance error |
| Sanctions screening rejected error |
| Recipient error |
| Invalid recipient error |
| Unsupported recipient error |
| Recipient limit error |
| Sender error |
| Instruction error |
| Instruction amount limit error |
| Instruction amount limit sender error |
| Instruction amount limit recipient error |
| Velocity limit |
| Velocity limit sender error |
| Velocity limit recipient limit error |
| Processing error |
| Validation error |
| Configuration error |
| Cancellation error |
| Returned error |
| Insufficient funds |
| Unmapped response |
Code | Summary |
---|---|
Return responses | |
| Bank details invalid |
| Account not found |
| Account inactive |
| Account dormant |
| Account number invalid |
| Branch not found |
| Branch code invalid |
| Branch code required |
| Bank code invalid |
| Bank code required |
| Account type required |
| Account holder details invalid |
| Account holder identification number required |
| Account holder type not supported |
| Account holder type not allowed |
| Account closed |
| Account blocked |
| Invalid debtor account type |
| Account holder billing address details incorrect |
| Account holder billing address details required |
| Account holder billing address can not be PO box |
| Unsupported characters |
| Invalid amount |
| Minimum amount not met |
| Exceeded transaction value |
| Exceeded daily limit |
| Exceeded weekly limit |
| Exceeded monthly limit |
| Recalled |
| Unknown reason |