Skip to main content
POST
Create Virtual Account

Authorizations

Authorization
string
header
required

Bearer authentication with an API token

Path Parameters

identity_id
string
required

Identity to create the virtual account for.

Body

application/json
identity_id
string
required

Identity to create the virtual account for.

request_id
string
required

Request identifier in a UUID format. Serves as an idempotency key.

source
source · object
required

Fiat deposit configuration.

destination
account_id · object
required

Asset delivery configuration.

Response

Success

id
string
read-only

Unique identifier for this virtual account.

identity_id
string
read-only

Bastion identity that owns the account.

status
enum<string>
read-only

Current status.

Available options:
VIRTUAL_ACCOUNT_STATUS_UNSPECIFIED,
VIRTUAL_ACCOUNT_STATUS_PENDING,
VIRTUAL_ACCOUNT_STATUS_ACTIVE,
VIRTUAL_ACCOUNT_STATUS_INACTIVE,
VIRTUAL_ACCOUNT_STATUS_FAILED
Example:

"VIRTUAL_ACCOUNT_STATUS_PENDING"

source
source · object
read-only

Source: fiat deposit configuration.

destination
account_id · object

Destination: asset delivery configuration.

deposit_instructions
deposit_instructions · object
read-only

Deposit instructions (populated when status = ACTIVE). Returned synchronously by providers that support it (e.g. CRB/MT).

created_at
string
read-only
updated_at
string
read-only