Skip to main content
POST
/
v1
/
customers
/
virtual-account
Create Virtual Account
curl --request POST \
  --url https://sandbox.api.fin.com/v1/customers/virtual-account \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer_id": "5a6f47f7-7326-409f-a4da-90e409133fb8",
  "destination_currency": "USDC",
  "destination_chain": "POLYGON",
  "source_rail": "ACH",
  "source_currency": "USD",
  "destination_wallet_address": "0x7f1568190e318da16a9ef5a46cba19d5b97d9b29",
  "developer_fee_percentage": 1.5
}
'
{
  "data": {
    "id": "eb99dce4-d26d-442a-9873-47336e9936ca",
    "status": "ACTIVE",
    "developer_fee_percent": 1.5,
    "customer_id": "5a6f47f7-7326-409f-a4da-90e409133fb8",
    "created_at": "2025-12-17T10:57:19.113092Z",
    "updated_at": "2025-12-17T10:57:19.113092Z",
    "deposit_instructions": {
      "currency": "USD",
      "bank_name": "Bank of Nowhere",
      "bank_address": "1800 North Pole St., Orlando, FL 32801",
      "bank_routing_number": "101019644",
      "bank_account_number": "900801702004",
      "bank_beneficiary_name": "Stageusa Testva",
      "bank_beneficiary_address": "1200 Pennsylvania Avenue NW, Georgia, GA 20500, US",
      "payment_rails": [
        "ACH",
        "FEDWIRE"
      ]
    },
    "destination": {
      "currency": "USDC",
      "destination_chain": "POLYGON",
      "address": "0x7f1568190e318da16a9ef5a46cba19d5b97d9b29"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Obtain token from /v1/oauth/token endpoint

Body

application/json
​
customer_id
string<uuid>
required

Unique identifier for the customer

Example:

"5a6f47f7-7326-409f-a4da-90e409133fb8"

​
destination_currency
enum<string>
default:USDC
required

Destination cryptocurrency

Available options:
USDC
​
destination_chain
enum<string>
default:POLYGON
required

Blockchain network for destination

Available options:
POLYGON
​
source_rail
string
required

Payment rail for deposits

Example:

"ACH"

​
source_currency
string
required

Source currency code

Example:

"USD"

​
destination_wallet_address
string
required

Destination wallet address in hexadecimal format (0x...)

Example:

"0x7f1568190e318da16a9ef5a46cba19d5b97d9b29"

​
developer_fee_percentage
number
required

Developer fee percentage

Example:

1.5

Response

Virtual account created successfully

​
data
object
required