Skip to main content
POST
/
virtual-account
/
{customerId}
/
create
Create virtual account
curl --request POST \
  --url https://business.bfinance.app/external/api/virtual-account/{customerId}/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "usd",
  "destination": {
    "currency": "usdc",
    "chain": "base",
    "address": "0x1234..."
  }
}
'
{
  "status": "success",
  "data": {
    "status": "active",
    "depositInstructions": {
      "currency": "<string>",
      "iban": "<string>",
      "bic": "<string>",
      "accountHolderName": "<string>",
      "bankName": "<string>",
      "bankAddress": "<string>",
      "bankRoutingNumber": "<string>",
      "bankAccountNumber": "<string>",
      "beneficiaryName": "<string>",
      "beneficiaryAddress": "<string>",
      "paymentRails": [
        "<string>"
      ],
      "clabe": "<string>",
      "pixCode": "<string>"
    }
  }
}

Authorizations

Authorization
string
header
required

JWT authentication token

Path Parameters

customerId
string
required

Customer ID

Body

application/json
type
enum<string>
required
Available options:
usd,
eur,
mxn,
brl
destination
object
required

Response

Virtual account created.

status
string
Example:

"success"

data
object