Skip to main content
A virtual account is the org’s managed wallet hierarchy: a primary account (empty reference) with crypto wallets on enabled chains, plus optional pay-in sub-accounts for permanent deposit addresses.

​
Create the virtual account

Virtual-account write endpoints require request signing when signature verification is enforced. See Authentication.

​
Get virtual account

Returns the primary virtual account and nested structure (chains, addresses, state). The parent must be enabled and in a Ready state before you create pay-in deposit wallets.

​
Update virtual account

Enable additional chains/currencies or disable existing ones via PATCH https://mapi.zbx.boomfi.xyz/v1/accounts/virtual.

​
Balances

Lists balances across the primary virtual-account hierarchy.

​
Permanent pay-in wallets

Create customer deposit addresses with POST https://mapi.zbx.boomfi.xyz/v1/accounts/virtual/payin/address. Deposits on those addresses are swept to the parent account. Full guide: Create a Deposit Address.

​
Dashboard

  • Settlement: https://merchants.zbx.boomfi.xyz/dashboard/settings/settlement
  • Account balances UI: https://merchants.zbx.boomfi.xyz/dashboard/account
ZBX virtual account balances

​
Payouts from the virtual account

POST https://mapi.zbx.boomfi.xyz/v1/accounts/virtual/payout/address creates a payout to an external wallet (signed; session auth may require step-up). See the API reference for the full request schema.

​
Next steps