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

# 虚拟账户创建 / 更新

> 当虚拟账户被创建、更新或关闭时发送。

<Warning>
  [Create Virtual Account](/zh/global-account/v1.6/api-reference/create-virtual-account) 接口的同步响应**仅是受理**——无论虚拟账户是否真正开通成功，接口都会返回 `SUCCESS`。最终状态由本 Webhook 推送：

  * `virtual.account.create`：UQPAY 已受理对应币种的开户申请。
  * `virtual.account.update` 且 `status = Active`：VA 已开通成功，可以使用。

  **申请失败时不会推送任何 Webhook。** 如果在预期时间内未收到 `virtual.account.update`，请联系 UQPAY support。
</Warning>

## 事件类型

| 事件类型                     | 描述         |
| ------------------------ | ---------- |
| `virtual.account.create` | 新的虚拟账户已创建。 |
| `virtual.account.update` | 已有虚拟账户被更新。 |
| `virtual.account.closed` | 虚拟账户已关闭。   |


## OpenAPI

````yaml webhooks-banking.yaml webhook virtualAccountCreateUpdate
openapi: 3.1.0
info:
  title: Banking Webhooks
  version: 1.6.0
  description: |
    Webhook events for the Global Account product. UQPAY sends these events to
    your registered webhook endpoint as HTTP POST requests with a JSON body.

    All events share a common envelope (`event_id`, `event_name`, `event_type`,
    `source_id`, `version`) and carry event-specific data in the `data` field.
servers: []
security: []
paths: {}

````