Payout Failure Reasons

The field payout.status_description will contain the reason for a payout failure.

Error CodeError MessageDescriptionWhen should you retry?
PO1001insufficient_balanceThere is insufficient balance in your account to make the desired payout.Please ensure you have added sufficient funds to your account before retrying.
PO1002invalid_destinationThis 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.
PO1003rejected_by_bankThe 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.
PO1004rejected_by_channelThe 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.
PO1005cancelledThe 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.
PO1006payout_expiredThe payout was not funded within the required time limit and has expired.Please ensure you have added sufficient funds to your account before retrying.
PO1007exchange_rate_expiredThe updated exchange rate is rejected.Please ensure you have verified the live exchange rates before initiating.
PO1008entity_approval_rejectedThe entity approval is rejected.You are unlikely to succeed if you retry with the same payout request.
PO1000otherThe reason of failure cannot be specified.You are unlikely to succeed if you retry with the same payout request.
PO1009payout_expiredThe payout was not approved within the required time limit and has expired.Please ensure you approve the payouts within the expiry time limit.