Failure Codes
Learn why a financial transaction was declined by banks and how you can rectify the issue and retry the transaction.
Payments and transfers can fail for various reasons. It is possible that the payment or transfer API call was successful, but the transaction failed because it was rejected by an intermediary bank or a financial institution.
In such scenarios, the API returns a 200 HTTP code. However, the status of the failed transaction is set to either pending or failed and the reason the transaction failed is included in the API response.
Failure Parameters
The table below lists the various parameters we return when a financial transaction is declined. Values returned against these parameters tell you why the transaction was declined, where the error occurs, and how you can rectify the error and retry the transaction.
| Parameter | Type | Description |
|---|---|---|
| error_type | string | Type of error that occured. Possible values:
|
| bank_error_code | string | Error code returned by the bank. Example: beneificary_account_blocked |
| message | string | Short reason the transaction was declined. Example: Account blocked/frozen |
| reason_for_error | string | Details about why the transaction was declined. Example: Beneficiary account is either blocked or frozen |
| recommended_action | string | Steps you can take to rectify the error and retry the transaction. Example: Contact beneficiary before retrying the transfer |
Updated over 2 years ago