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
failed and the reason the transaction was declined is included in the API response.
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.
|error_type||Type of error that occured.|
|bank_error_code||Error code returned by the bank.|
|message||Short reason the transaction was declined.|
|reason_for_error||Details about why the transaction was declined.|
|recommended_action||Steps you can take to rectify the error and retry the transaction.|