Virtual Accounts
Create Virtual Account
Create a virtual account (VBAN / IBAN) for an account in a supported currency
POST
Collect fiat by creating a virtual account (VBAN / IBAN) per currency. Create Virtual Account returns a virtual-account resource immediately, but bank details can take time to become ready. While details are being prepared, the virtual account is returned with
status = pending and nullable bank-detail fields. Use the virtual_account.updated webhook or Get Virtual Account to detect when it becomes active.
Once active, the virtual account contains full bank details — IBAN, SWIFT/BIC, routing number, and account number where applicable — so your end customers can be paid into named, attributable accounts. Each virtual account also carries its own balance, returned on the object.
Creates a virtual-account resource for the given account in a supported currency. The resource is created synchronously, but bank details may be prepared asynchronously after creation.
Some virtual accounts become
active during the create request. In that case, the create response already includes the full bank-detail fields shown in Get Virtual Account.Path Parameters
string
required
Account id (
acct_…) that will own the virtual account.Headers
string
required
Unique key for this virtual-account create. Re-using a key for the same account returns the previously created virtual account instead of creating a duplicate.
Request Body
string
required
Currency to collect in (ISO 4217, e.g.
EUR, USD, GBP). One virtual account is issued per currency.string
Free-text label for your own reference (e.g.
"EUR Collections").Response
Returns201 with the new virtual-account object. If bank details are still being prepared, the response has status = pending and nullable bank-detail fields. Subscribe to virtual_account.updated or call Get Virtual Account until the status becomes active. See Get Virtual Account for the full field reference.