status FAILED, statusReason holds one of these codes. You receive it on the Virtual Account Transaction webhook and on transactions returned by the API. When the transaction has not failed, statusReason is null.
Never retry a transaction that failed with
OUTCOME_UNDER_INVESTIGATION. The money may already have moved, so a retry can pay twice.| Code | Meaning | What to do |
|---|---|---|
INSUFFICIENT_FUNDS | The amount plus fees exceeds the available balance. Funds still processing do not count. | Retry once the balance covers the amount. |
ACCOUNT_FROZEN | The account is inactive or restricted. | Do not retry. Contact Meridian support to reactivate the account. |
RISK_REJECTION | Meridian’s automated risk checks declined the transaction. | Do not retry. Contact Meridian support. |
DECLINED_AFTER_REVIEW | Meridian declined the transaction after an account or transaction review, or a deposit arrived in a restricted account. | Do not retry. Contact Meridian support. |
BANK_REJECTION | The bank or payment network rejected or returned the transaction, including direct debit returns. | Do not retry as is. Contact Meridian support for the status of the funds. |
WITHDRAWAL_ACCOUNT_NOT_SUPPORTED | The withdrawal account is not supported for this transfer. | Choose another withdrawal account and submit a new withdrawal. |
PROCESSING_FAILED | The transaction failed during processing. Meridian returns any amount deducted automatically. | Retry later. |
OUTCOME_UNDER_INVESTIGATION | The provider accepted the credit but did not confirm the outcome, so the money may have moved. | Do not retry or re-issue: a retry can pay twice. Wait for a final update or contact Meridian support. |
REVERSAL_IN_PROGRESS | The transaction failed and Meridian could not return the deducted amount automatically. A manual return is in progress. | None. Meridian returns the amount manually. |
EXCEEDS_SEND_LIMIT | The amount exceeds the sending limit. | Retry with a smaller amount, or after the limit resets. |
EXCEEDS_RECEIVE_LIMIT | The deposit exceeds the receiving limit. | Contact Meridian support. |
WITHDRAWAL_SYSTEM_ERROR | A Meridian system error stopped the withdrawal. No funds were deducted. | Retry later. |
DEPOSIT_SYSTEM_ERROR | A Meridian system error stopped the deposit from being credited. Meridian credits the funds once it is resolved. | None. |
AUTOSWEEP_SYSTEM_ERROR | A Meridian system error stopped an auto-sweep. The funds stay in the source balance. | None. |
INTERNAL_ERROR | A Meridian system error on any other transaction, such as a transfer. | Contact Meridian support. |