Sign in

v1

latestOpenAPI 3.1.02026-07-226250251.5 KB
Virtual Accounts

Create Virtual Account

Create a virtual bank account for a customer to convert USD deposits to USDC on Polygon

post/v1/customers/virtual-account

Request body

customer_idstring uuid required
destination_currency'USDC' required
destination_chain'POLYGON' required
source_railstring required
source_currencystring required
destination_wallet_addressstring required
developer_fee_percentagenumber required

Example request

{
  "customer_id": "5a6f47f7-7326-409f-a4da-90e409133fb8",
  "source_rail": "ACH",
  "source_currency": "USD",
  "destination_wallet_address": "0x7f1568190e318da16a9ef5a46cba19d5b97d9b29",
  "developer_fee_percentage": 1.5
}

Response

Virtual account created successfully

Example response

{
  "data": {
    "id": "92eceee4-ec6a-4fe3-a224-f5914cabe001",
    "status": "ACTIVE",
    "developer_fee_percent": 1.65,
    "customer_id": "196ce546-900d-4294-90ca-5546a5923f35",
    "created_at": "2025-12-22T06:09:23.456895Z",
    "updated_at": "2025-12-22T06:09:23.456895Z",
    "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": "900336047672",
      "bank_beneficiary_name": "Portgas D Ace",
      "bank_beneficiary_address": "321 British Columbia City, British Columbia, BC V0C 1Y0, CA",
      "payment_rails": [
        "ACH",
        "FEDWIRE"
      ]
    },
    "destination": {
      "address": "0x7f1568190e318da16a9ef5a46cba19d5b97d9b29"
    }
  }
}