> ## Documentation Index
> Fetch the complete documentation index at: https://dev.moonpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Virtual Accounts

> Currently supported Virtual Accounts events

## Events

### `virtual_account_status_updated`

Triggered when the status of a virtual account changes.

```json Example payload theme={null}
{
  "virtualAccountId": "9bc86a06-8300-41c8-8cef-d2eaa852164f",
  "externalCustomerId": "external_customer_id_123",
  "status": "completed",
  "timestamp": 1678901234567
}
```

| Field                | Type    | Description                                                              |
| -------------------- | ------- | ------------------------------------------------------------------------ |
| `virtualAccountId`   | string  | Unique identifier (uuid) of the virtual account                          |
| `externalCustomerId` | string  | External identifier of the customer                                      |
| `status`             | string  | Current status of the virtual account (`pending`, `completed`, `failed`) |
| `timestamp`          | integer | Unix timestamp (milliseconds) when the event was triggered               |

### `virtual_account_transaction_status_updated`

Triggered when the status of a transaction within a virtual account changes.

```json Example payload theme={null}
{
  "virtualAccountId": "9bc86a06-8300-41c8-8cef-d2eaa852164f",
  "externalCustomerId": "external_customer_id_123",
  "transactionId": "7a2cbc6f-ddef-4071-9628-a6559cb4ad89",
  "status": "Completed",
  "timestamp": 1678901234567
}
```

| Field                | Type    | Description                                                          |
| -------------------- | ------- | -------------------------------------------------------------------- |
| `virtualAccountId`   | string  | Unique identifier (uuid) of the virtual account                      |
| `externalCustomerId` | string  | External identifier provided for the customer                        |
| `transactionId`      | string  | Unique identifier (uuid) of the transaction                          |
| `status`             | string  | Current status of the transaction (`Pending`, `Completed`, `Failed`) |
| `timestamp`          | integer | Unix timestamp (milliseconds) when the event was triggered           |