Skip to main content
POST
Create USD virtual account

Overview

Creates a new USD virtual account for a customer. The customer must have completed tier 2 verification before creating a USD virtual account. Payments into the account settle into the merchant collection balance, are listed as USD virtual account deposits, and send a webhook.
Prerequisite: The customer must have completed tier 2 verification (POST /v1/customers/{id}/tier2-verification).

Authentication

X-Api-Key
string
required
Your merchant API key

Request Body

customer_id
string
required
Customer ID (UUID). The customer must have completed tier 2 verification.Example: 650e8400-e29b-41d4-a716-446655440000
currency
string
Currency for the virtual account. Defaults to usd if omitted. Currently only usd is supported.Example: usd
developer_fee
object
Optional fee that your merchant account keeps from each USD deposit received through this virtual account. Omit to use 0%.

Request Example

Response

id
string
required
Virtual account ID (UUID)
customer_id
string
required
Associated customer ID
merchant_id
string
required
Merchant ID
currency
string
required
Source currency (e.g. usd)
status
string
required
Account status (e.g. active)
provider
string
required
Virtual account provider (e.g. bridge)
developer_fee
object
required
Developer fee percentage used for deposits received through this virtual account.
deposit_instructions
object
Bank deposit instructions for funding the virtual account.
destination
object
Crypto destination where settled funds are sent.
created_at
string
required
When the account was created (ISO 8601)
updated_at
string
required
When the account was last updated (ISO 8601)