Sandbox

Simulate a fixed-route source deposit

Sandbox-only: triggers the fixed-route sweep without on-chain funds or provider webhooks. Works for fiat (vba_) and crypto (inw_) source routes. Does not use account fund-in -- Infinite wallets cannot be credited that way. Idempotent when reference is reused. Wire/FedWire/SWIFT deposits populate source.originator with a sandbox remitter unless you pass originator or the route has allowedSenderBanks.

post/v1/sandbox/fixed-routes/{id}/simulate-deposit

Path parameters

idstring required

Fixed route source account id (vba_ for fiat, inw_ for crypto deposit wallets)

Headers

X-API-Keystring

API key

Request body

amountstring required

Deposit amount in major units (e.g. "1000.00" for USD, "100.5" for USDT)

currencystring

Deposit currency; defaults to the route source currency when omitted

referencestring

Idempotency reference for the simulated deposit; replays return the existing sweep transfer

Example request

{
  "amount": "1000.00",
  "currency": "USD",
  "reference": "sandbox_test_deposit_1",
  "senderBank": {
    "bankName": "JPMorgan Chase",
    "routingNumber": "021000021",
    "swiftBic": "CHASUS33"
  },
  "originator": {
    "name": "Sandbox Originator LLC",
    "bankName": "Sandbox Test Bank",
    "routingNumber": "021000021",
    "accountNumber": "000123456789",
    "swiftBic": "CHASUS33",
    "bankCountry": "US"
  }
}

Response

Fixed route sweep simulated successfully

accountIdstring required

Fixed route source account ID

transferIdstring required

Sweep transfer created or replayed for this simulation

sweepReferenceIdstring required

Sweep idempotency key used for this simulation

Example response

{
  "accountId": "acc_123",
  "transferId": "tfr_123",
  "sweepReferenceId": "sandbox_sim_550e8400-e29b-41d4-a716-446655440000"
}

Changes