Send a Mock Deposit
Simulates an inbound deposit into a balance account through a given deposit instruction, so you can exercise downstream processing — balances, transactions, and webhooks — without moving real money. This is fire-and-acknowledge: it responds 202 with an empty body and settles out of band, so observe the result by polling the account balance or transactions.
Sandbox only. This endpoint exists exclusively in the sandbox environment for testing. Simulating a deposit is not possible in production.
Authorizations
Bearer token authentication, for client-server calls.
Send the access token issued by POST /v1/auth/token as Authorization: Bearer {token}. The token carries its own program and user context, so the X-Meridian-* headers are not required. See Authentication.
Headers
Server-to-server (HMAC) requests only. Partner API key issued by Meridian during provisioning.
Server-to-server (HMAC) requests only. Current time in milliseconds since the Unix epoch. Must be within 60 seconds of the request.
Server-to-server (HMAC) requests only. Identifies the program context for the request.
Server-to-server (HMAC) requests only. Identifies the Meridian user targeted by the request. Required for MULTI_USER integrations; omit for SINGLE_USER.
Path Parameters
ID of the balance account to deposit into — the id returned by GET /v1/accounts (e.g. uspay-...).
Body
The deposit instruction to credit and the amount to deposit.
Request payload for simulating an inbound deposit in the sandbox
The id of the deposit instruction to credit — an opaque identifier such as uspay-..., NOT a rail name like ACH or WIRE. Each deposit instruction is a funding rail (ACH, Fedwire, etc.) configured on the account that an inbound deposit would arrive through. To find it, call GET /v1/accounts/{accountId} and copy the id of the desired entry from the depositInstructions array (match on its rail.label, e.g. Fedwire for a wire). Passing anything that is not an existing instruction id returns 404.
"uspay-rvrsmt8vngju3kea5mm6fcck"
Amount to deposit, as a decimal string in the account's currency (e.g. 100.00). Must be greater than zero.
"100.00"
Response
Deposit simulation accepted; settles out of band
Response carrying no resource data, with an optional human-readable message
Optional human-readable message describing the outcome