The field payout.status_description will contain the reason for a payout failure.
| Error Code | Error Message | Description |
|---|---|---|
| PO1001 | insufficient_balance | There is insufficient balance in your account to make the desired payout |
| PO1002 | invalid_destination | This occurs when a banking channel tells us that an account is invalid. Typically, this means that 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. |
| 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 |
| 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 |
| PO1005 | cancelled | The payout has been cancelled by the sender |
| PO1006 | payout_expired | The payout was not funded within the required time limit and has expired. |
| PO1007 | exchange_rate_expired | The updated exchange_rate is rejected |
| PO1008 | entity_approval_rejected | The entity approval is rejected |
| PO1000 | other | The reason of failure cannot be specified |
| PO1009 | payout_expired | The payout was not approved within the required time limit and has expired. |
| PO1010 | incomplete_details | The payout could not be processed because the provided details are incomplete. Ensure that all required fields, such as account number, bank name, and beneficiary details are correctly filled in. |
| PO1011 | incorrect_tax_id | The payout could not be completed due to an incorrect or invalid tax identification number. |
| PO1012 | incorrect_swift_code | The SWIFT code provided for the payout is incorrect or invalid |
| PO1013 | incorrect_beneficiary_name | The beneficiary name provided does not match the records at the receiving bank. |
| PO1014 | invalid_account_number | The account number provided is invalid or does not exist |
| PO1015 | compliance_issue | The payout has been flagged for a compliance issue. This may occur if the transaction violates regulatory guidelines or Tazapay's policies. |
| PO5001 | transaction_failed | Transaction failed at the bank's end, please retry after some time. |
| PO5002 | transaction_timedout | Transaction timed out, please retry. |
| PO5506 | invalid_account | Beneficiary details are invalid. |
| PO5512 | rejected_by_beneficiary_bank | Rejected by beneficiary bank |
| PO5513 | returned_from_beneficiary | Transaction was rejected by the beneficiary bank |
| PO5519 | invalid_transaction | The transaction is invalid. |
| PO5522 | declined_by_bank | Transaction has been declined by the bank, please retry after some time or verify bank details. |
| PO5524 | invalid_ifsc_code | IFSC code is incorrect. Please amend and retry. |
| PO5530 | transaction_not_allowed | Transaction declined as the beneficiary account is not allowed to receive credits as per guideline. |
| PO5532 | foreign_inward_remittance_not_allowed | Transaction has been declined by beneficiary's bank. |
| PO5535 | invalid_document_id | Transaction declined due to invalid beneficiary document ID. |
| PO5541 | invalid_originating_bank_bic | There was an error processing your transaction. Please try again shortly. If the issue continues, kindly send a screenshot of this error to [email protected] for further assistance. |
| PO5545 | intermediary_bic_ is_incorrect | There was an error processing your transaction. Please try again shortly. If the issue continues, kindly write to [email protected] for further assistance. |
| PO5546 | swift_bic_of_payer/payee_is_incorrect | There was an error processing your transaction. Please try again shortly. If the issue continues, kindly write to [email protected] for further assistance. |
| PO6255 | blacklisted_remitter_or_beneficiary | Remitter or beneficiary found in the negative list. |
| PO6256 | blacklisted_beneficiary | Beneficiary name has been found in the blacklisted list. |
| PO6257 | blacklisted_remitter_and_beneficiary | Remitter and beneficiary found in the negative list. |
| PO6258 | beneficiary_keyword_contains_companyname | The beneficiary name contains keywords usually found in company names, while it was indicated that the beneficiary is an individual. Please correct and retry. |
| PO6259 | beneficiary_keyword_not_allowed | The beneficiary name contains keywords usually found in institutions that are not allowed to receive funds via this route. This transaction cannot proceed. |
| PO6260 | remitter_keyword_not_allowed | The remitter name contains keywords usually found in institutions that are not allowed to receive funds via this route. This transaction cannot proceed. |
| PO6261 | transaction_on_hold | The transaction is on hold due to AML check. |
| PO6262 | suspected_fraud | Transaction declined due to suspected fraud. |
| PO6263 | declined_by_antifraud_or_compliance | Transaction declined due to suspected fraud. |
| PO6264 | divergence_tax_id_information | Transaction declined due to divergence in tax id information |
| PO5559 | invalid_wallet_address | Transaction declined due to invalid wallet address information |