Sign in
Sandbox

Simulate account funding

Simulate inbound funding for a sandbox funding-method account (vba_ for virtual bank accounts, including USD balance accounts; vwa_ for virtual wallets; pba_ for stablecoin balance accounts) using a requested rail.

post/v1/sandbox/accounts/{id}/fund-in

Path parameters

idstring required

Funding-method account id (vba_ for virtual bank, vwa_ for virtual wallet, pba_ for stablecoin balance)

Headers

X-API-Keystring

API key

Request body

rail'WIRE' | 'ACH' | 'BLOCKCHAIN' required

Funding rail to simulate

amountstring required

Funding amount as a decimal string. Fiat rails accept up to 2 decimals; stablecoin balance funding accepts up to 6.

currencystring required

Funding currency code

network'ETHEREUM' | 'BASE' | 'SOLANA' | 'ARBITRUM' | 'POLYGON' | 'TRON'

Blockchain network when rail is BLOCKCHAIN

referencestring

Optional client reference for future providers

Example request

{
  "rail": "WIRE",
  "amount": "1000.00",
  "currency": "USD",
  "network": "BASE",
  "reference": "fund_in_123"
}

Response

Sandbox fund-in simulated successfully

accountIdstring required

Internal account ID used for the sandbox simulation

rail'WIRE' | 'ACH' | 'BLOCKCHAIN' required

Funding rail simulated

transactionHashstring

Blockchain transaction hash when provided by the sandbox provider

Example response

{
  "accountId": "vba_123",
  "amount": {
    "value": "1000.00",
    "currency": "USD"
  },
  "rail": "WIRE",
  "transactionHash": "0x1234"
}

Changes