Skip to main content
POST
/
v2
/
users
/
{userId}
/
virtual-accounts
/
{accountId}
/
simulate-deposit
Simulate a deposit to a virtual account
curl --request POST \
  --url https://production.hifibridge.com/v2/users/{userId}/virtual-accounts/{accountId}/simulate-deposit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": "<string>",
  "paymentRail": "WIRE",
  "requestId": "<string>",
  "source": {
    "routingNumber": "<string>",
    "accountNumber": "<string>",
    "name": "<string>",
    "bankName": "<string>"
  },
  "userId": "<string>",
  "reference": "<string>",
  "description": "<string>"
}'
{
  "amount": "88.8",
  "paymentRail": "WIRE",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "source": {
    "routingNumber": "021000021",
    "accountNumber": "123456789",
    "name": "Henry Wu",
    "bankName": "Bank of NoWhere"
  },
  "userId": "840c28f2-ea7d-5c3a-9271-b10fd8b6ae6d",
  "reference": "Test deposit",
  "description": "Simulated test deposit"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

userId
string
required

ID of the user

accountId
string
required

ID of the virtual account

Body

application/json
amount
string
required

Amount to simulate deposit

paymentRail
enum<string>
required

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

Available options:
WIRE,
ACH
requestId
string
required

Unique identifier for the request (recommend using uuid v4)

source
object
required
userId
string

Optional user ID to associate with this deposit

reference
string

Optional reference for this deposit

description
string

Optional description for this deposit

Response

Successfully triggered sandbox deposit

amount
string
required

Amount to simulate deposit

paymentRail
enum<string>
required

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

Available options:
WIRE,
ACH
requestId
string
required

Unique identifier for the request (recommend using uuid v4)

source
object
required
userId
string

Optional user ID to associate with this deposit

reference
string

Optional reference for this deposit

description
string

Optional description for this deposit

I