Skip to main content
POST
/
payout
/
accounts
/
setup
/
virtual-account
Step 2: Create a virtual account (requires liquidation address)
curl --request POST \
  --url http://localhost:4000/v1/payout/accounts/setup/virtual-account \
  --header 'Content-Type: application/json' \
  --data '
{
  "source_currency": "mxn",
  "liquidation_address_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "developer_fee_percent": "0.5"
}
'

Body

application/json
​
source_currency
enum<string>
required

Fiat currency for deposits into this virtual account

Available options:
usd,
eur,
mxn,
brl,
gbp
Example:

"mxn"

​
liquidation_address_id
string

UUID of a liquidation address to use as the destination. If omitted, auto-resolves from the integrator's most recent liquidation address.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
developer_fee_percent
string

Developer fee percentage as a decimal string (e.g. "0.5" for 0.5%)

Example:

"0.5"

Response

Virtual account created or already exists