> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mnai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transaction failure reasons

> What each virtual account transaction failure code means and what to do.

When a virtual account transaction has `status` `FAILED`, `statusReason` holds one of these codes. You receive it on the [Virtual Account Transaction](https://docs.mnai.com/products/retail-va/api-reference/webhooks/webhooks-transaction.md) webhook and on transactions returned by the API. When the transaction has not failed, `statusReason` is `null`.

> [!WARNING]
>
> 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. |
