> ## 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.

# Deposits

> Learn how customers receive ACH and wire deposits into their Virtual Account, including the transaction lifecycle and Auto-sweep feature.

## How deposits work

From the Account Home screen, your customer can access their Virtual Account details — including the account and routing information needed to receive funds. Your customer provides these details to the sending party, who submits the transfer through their own bank via ACH or wire.

Once Meridian receives the funds, it credits the deposit to the customer's Virtual Account and sends a [webhook](/products/retail-va/webhooks-overview) notification to your system.

```mermaid theme={null}
sequenceDiagram
    actor Employer
    participant VA as Customer Virtual Account
    participant Backend as Partner Backend

    Employer->>VA: Submits payroll deposit

    VA->>VA: Balance refreshed in UI session

    VA->>Backend: Triggers webhook notification
```

## Deposit methods

There are two ways to receive funds into a Virtual Account:

| Method   | Description                                |
| :------- | :----------------------------------------- |
| **ACH**  | Standard bank transfer via the ACH network |
| **WIRE** | Domestic wire transfer                     |

## Transaction lifecycle

Deposits move through the following statuses:

| Status    | Description                                                     |
| :-------- | :-------------------------------------------------------------- |
| `PENDING` | Deposit has been initiated and is awaiting settlement           |
| `SUCCESS` | Funds have been successfully credited to the Virtual Account    |
| `FAILED`  | Deposit could not be completed — see `statusReason` for details |

## Auto-sweep feature

When funds arrive in a Virtual Account configured for "Auto-sweep," Meridian immediately moves them to the linked account on your platform. Meridian sets your program defaults during onboarding, and you can manage individual account configurations through Meridian's REST API.

```mermaid theme={null}
sequenceDiagram
    actor Employer
    participant VA as Customer Virtual Account
    participant LA as Customer Local Account

    Employer->>VA: Submits payroll deposit

    VA->>VA: Calculate Conversion from USD to Local currency

    VA->>LA: Executes domestic transfer in local currency
```