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

string
required
Your merchant API key

Request Body

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

Request Example

Response

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