Skip to main content
WEBHOOK
virtual_account.status
{
  "event": {
    "id": "756ed2cd-b428-4c14-90b2-4f012dfe318a",
    "event_reference_id": "900f750d-6868-457e-a777-1a35566a6b5f",
    "type": "virtual_account.status",
    "created_at": "2025-12-10T08:14:19.048063Z",
    "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": 1.89,
    "id": "900f750d-6868-457e-a777-1a35566a6b5f",
    "status": "ACTIVE",
    "updated_at": "2025-12-10T08:14:19.017554854Z"
  }
}
This webhook event is triggered when a virtual account’s status changes. It provides real-time updates about the virtual account’s operational state. Common status values include:
  • ACTIVE - Virtual account is active and ready to receive deposits
  • INACTIVE - Virtual account is not currently active
  • SUSPENDED - Virtual account has been suspended
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 virtual account's status changes

​
event
object
required
​
data
object
required

Virtual account data in webhook payload

Response

200

Webhook received successfully