Virtual Account

Simulate a deposit to a virtual account

Changed on Nov 3, 2026

Simulate a deposit to a virtual account in sandbox environment. This endpoint is only available in sandbox and allows testing deposit flows.

Note: This endpoint is only available in sandbox environment.

post/v2/users/{userId}/virtual-accounts/{accountId}/simulate-deposit

Request

Base URL
https://production.hifibridge.com
URL
https://production.hifibridge.com/v2/users/{userId}/virtual-accounts/{accountId}/simulate-deposit
Auth
HTTP bearer

Path parameters

userIdstring required

ID of the user

accountIdstring required

ID of the virtual account

Request body

amountstring required

Amount to simulate deposit

paymentRail'WIRE' | 'ACH' | 'RTP' required

Payment rail for the simulated deposit , recommended to use WIRE for faster settlement

requestIdstring required

Unique identifier for the request (recommend using uuid v4)

userIdstring

Optional user ID to associate with this deposit

referencestring

Optional reference for this deposit

descriptionstring

Optional description for this deposit

sandboxScenario'FIAT_FAILED' | 'COMPLETED'

Sandbox-only field that forces the onramp created by this deposit to a predetermined outcome

Response

Successfully triggered sandbox deposit