Skip to main content

​
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 notification to your system.

​
Deposit methods

Funds can reach a Virtual Account over the following rails. The rail is reported in the depositType field of the transaction webhook, and the shape of the sender information depends on it.

​
Transaction lifecycle

Deposits move through the following statuses: Meridian sends the created webhook event when the deposit enters PENDING. Meridian sends the updated event only when the deposit reaches SUCCESS, FAILED, or ERROR.

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