> ## 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.

# 账户状态

> 当账户的入驻状态被创建或更新时发送。

## 事件类型

| 事件类型                        | 描述                              |
| --------------------------- | ------------------------------- |
| `onboarding.account.create` | 新账户完成了初始入驻流程。                   |
| `onboarding.account.update` | 现有账户的入驻数据被更新——例如状态变更、信息修正或验证结果。 |

`data` 对象的结构与[Retrieve Account](/zh/account-center/v1.6/api-reference/retrieve-account) API响应一致。

<Warning>
  **`verification_status` 枚举值与接口不同。** 在本 webhook 通知体中，拒绝和退回状态下发的是
  `REJECTED` 和 `RETURNED`，而 [Retrieve Account](/zh/account-center/v1.6/api-reference/retrieve-account)
  与 [List Connected Accounts](/zh/account-center/v1.6/api-reference/list-connected-accounts)
  接口响应返回的是 `REJECT` 和 `RETURN`。其余值（`PENDING`、`APPROVED`、`EXPIRED`）一致。
</Warning>


## OpenAPI

````yaml webhooks-connect.yaml webhook accountStatus
openapi: 3.1.0
info:
  title: Account Center Webhooks
  version: 1.6.0
  description: |
    Webhook events for the Account Center 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: {}

````