Learn why financial transactions were 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 was declined 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 declined transaction is set to either pending or failed and the reason the transaction was declined is included in the API response.
Failure Parameters
The table below lists the various parameters we return when a financial transaction fails. Values returned against these parameters tell you why the transaction failed, 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 |