Skip to main content
If you’re just getting started, please check out our quick start guide.
There are two events regarding virtual accounts:
  • VirtualAccount_Created
  • VirtualAccount_CreationFailed

​
Created

VirtualAccount_Created is sent after virtual account has been created successfully and deposit instructions obtained. Below is a payload example: 
{
    "organizationId": "clxt0xrqp0000gokerkq2mpdl",
    "type": "VirtualAccount_Created",
    "data": {
        "id": "cmbz2ee050011yn24wqjru28f",
        "accountId": "cmbz2dgni000tyn241ip38gwj",
        "counterPartyIdentityId": "cmbz0v42m0002yn53zeayhilz",
        "status": "Active",
        "asset": "USDC_ETHEREUM",
        "fiat": "USD",
        "instructions": {
            "currency": "usd",
            "bank_name": "Bank of Nowhere",
            "bank_address": "1800 North Pole St., Orlando, FL 32801",
            "payment_rail": "ach_push",
            "payment_rails": [
                "ach_push",
                "wire"
            ],
            "bank_account_number": "900544275163",
            "bank_routing_number": "101019644",
            "bank_beneficiary_name": "Olaf Kling",
            "bank_beneficiary_address": "123 Washington St, Apt 2F, Chicago, IL 10001, US"
        },
        "createdAt": "2025-06-16T12:22:42.533Z",
        "failureReason": null
    },
    "timestamp": 1750076563854
}

​
Failed

VirtualAccount_CreationFailed is sent after virtual account failed to create. 
{
    "organizationId": "clxt0xrqp0000gokerkq2mpdl",
    "type": "VirtualAccount_CreationFailed",
    "data": {
        "id": "cmbz2brwb000nyn245kyyrgqw",
        "accountId": "cmbhs3xxa000nynt7lqwbyjsw",
        "counterPartyIdentityId": "cmbz0v42m0002yn53zeayhilz",
        "status": "Rejected",
        "asset": "USDC_POLYGON",
        "fiat": "USD",
        "instructions": null,
        "createdAt": "2025-06-16T12:20:40.572Z",
        "failureReason": "Couldn't find asset USDC_POLYGON in account: cmbhs3xxa000nynt7lqwbyjsw, add this asset to account before using it"
    },
    "timestamp": 1750076440780
}
If you have any questions, please don’t hesitate to reach out to us via email or slack.