Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.borderless.xyz/llms.txt

Use this file to discover all available pages before exploring further.

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.