Skip to main content
WEBHOOK
virtual_account.created
{
  "event": {
    "id": "3fb02b56-911e-42c0-843c-c08785bdde56",
    "event_reference_id": "900f750d-6868-457e-a777-1a35566a6b5f",
    "type": "virtual_account.created",
    "created_at": "2025-12-10T08:11:25.269644Z",
    "sandbox_mode": true
  },
  "data": {
    "created_at": "2025-12-10T08:11:25.216572Z",
    "customer_id": "a41a6d76-4545-47ab-93d1-696a3221d39c",
    "deposit_instructions": {
      "bank_account_number": "900937198167",
      "bank_address": "1800 North Pole St., Orlando, FL 32801",
      "bank_beneficiary_address": "250 Innovation Way, Houston, TX 77002, US",
      "bank_beneficiary_name": "Acme Corp",
      "bank_name": "Bank of Nowhere",
      "bank_routing_number": "101019644",
      "currency": "USD",
      "payment_rails": [
        "ACH",
        "FEDWIRE"
      ]
    },
    "destination": {
      "address": "0x1d1f9801d6d98e49438cda3a3b8e0c9f5e6f8c44",
      "currency": "USDC",
      "destination_chain": "POLYGON"
    },
    "developer_fee_percent": 0.5,
    "id": "900f750d-6868-457e-a777-1a35566a6b5f",
    "status": "ACTIVE",
    "updated_at": "2025-12-10T08:11:25.216572Z"
  }
}
This webhook event is triggered when a new virtual account is created for a customer. It provides comprehensive details about the virtual account, including deposit instructions (bank account details, routing numbers, supported payment rails), the destination blockchain address for converted funds, and the developer fee configuration.
Security: All webhook requests include HMAC signatures for verification. Learn how to verify webhook signatures to ensure requests are authentic.

Body

application/json

Webhook triggered when a new virtual account is created

event
object
required
data
object
required

Virtual account data in webhook payload

Response

200

Webhook received successfully