Update a virtual account
Change the markup or the metadata of one of your virtual accounts. Only what you send changes — every field you leave out keeps its value.
A new markup prices the deposits that settle after the call. A deposit held for a compliance check (KYT_PENDING) is priced when the check clears, with the markup in effect at that moment. A crypto inbound is the exception: it is priced when it arrives, with the markup in effect then. A deposit that has already settled keeps the markup it settled with. usd_usdc_conversion_fee_pct also prices the payouts from this account that turn USD into a token. The other fields price deposits only.
The response is the whole account, in the same shape Get a virtual account returns.
Authorizations
The data.access_token value from Get access token.
Headers
Version applied to this request. It wins over your account's pinned version — see Versioning.
"2026-06-01"
Body
Send markup, metadata, or both.
A patch, not a replacement: a key with a value sets it, a key with "" deletes it, and {} clears every key. The limits apply to the result — see Metadata.
Response
Success.
One virtual account. The six flat bank fields repeat what source_deposit_instructions holds: absent when it is null, and null where it holds an empty value.
Where the account is in its lifecycle. See Virtual account values. Available options: pending, activating, active, failed, deactivated, frozen.
Which bank the account runs on, and with it the rail — see Virtual account values. null while the bank is still opening it.
What the account does with a deposit. Available options: fiat, crypto. See Virtual account values.
The bank details a payer uses to send money to this account. null until the bank assigns them.
They can also arrive filled with placeholders, such as an account_number of PENDING-ACT-ACCOUNT. Treat them as real only after the virtual_account.activated webhook — see Webhooks.
Addresses where a payer can send stablecoins, one per network. What arrives is credited to this account in dollars — see Crypto inbound. Absent while the account has none.