The field payout.status_description will contain the reason for a payout failure.
Error Code | Error Message | Description | When should you retry? |
---|---|---|---|
PO1001 | insufficient_balance | There is insufficient balance in your account to make the desired payout. | Please ensure you have added sufficient funds to your account before retrying. |
PO1002 | invalid_destination | This occurs when a banking channel tells us that an account is invalid. Typically, this means the account is not yet registered at the destination bank or the bank has blocked the account. This also occurs for newly created bank accounts which have yet to be updated to national databases. | You are unlikely to succeed if you retry with the same payout request. Please confirm with the beneficiary that the destination bank details are correct. |
PO1003 | rejected_by_bank | The destination bank can reject the incoming funds for a variety of reasons. The reasons are typically to do with compliance or the destination account's ability to receive funds. | You are unlikely to succeed if you retry with the same payout request. Please confirm with the beneficiary that the destination bank details are correct and the bank is able to receive funds. |
PO1004 | rejected_by_channel | The switching network can reject funds transfer for a variety of reasons. The reasons are typically to do with compliance or the destination account's ability to receive funds. | You are unlikely to succeed if you retry with the same payout request. Please confirm with the beneficiary that the destination bank details are correct and the bank is able to receive funds. |
PO1005 | cancelled | The payout has been cancelled by the sender. | You are unlikely to retry if you have cancelled a payout. If you do retry, the payout will likely succeed. |
PO1006 | payout_expired | The payout was not funded within the required time limit and has expired. | Please ensure you have added sufficient funds to your account before retrying. |
PO1007 | exchange_rate_expired | The updated exchange rate is rejected. | Please ensure you have verified the live exchange rates before initiating. |
PO1008 | entity_approval_rejected | The entity approval is rejected. | You are unlikely to succeed if you retry with the same payout request. |
PO1000 | other | The reason of failure cannot be specified. | You are unlikely to succeed if you retry with the same payout request. |
PO1009 | payout_expired | The payout was not approved within the required time limit and has expired. | Please ensure you approve the payouts within the expiry time limit. |