Skip to main content
Every account can receive USD by wire. You ask for deposit instructions with USD as the asset, share the bank details with the sender, and the funds are available once the wire settles. There’s no attribution step for USD.

What’s available

How it works

1

Get instructions for USD

GET /v4/accounts/{accountId}/deposit-instructions/USD. If the account has no instructions yet, they’re created on this call.
2

Share the wire details

Give the sender the bank name, account and routing numbers, and the beneficiary name and address exactly as returned. Wires that don’t match the beneficiary details can be delayed or returned.
3

The wire settles

The deposit appears as a DEPOSIT transaction in the account. Once it’s POSTED, the funds are available. See Transactions.

Integration steps

Step 1: Get wire instructions

GET /v4/accounts/{accountId}/deposit-instructions/{assetType} In the sandbox, use USD_R as the asset type (USD is the production code). Check GET /v4/asset-types if in doubt.
The same instructions are returned on every later call for the account. Deposit instructions are per account, which is what lets a wire land in the right account without a memo.