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

# 账户状态

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

## 事件类型

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

`data` 对象的结构与[Retrieve Account](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/retrieve-account.md) API响应一致。

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


## 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: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.