Skip to main content
如果你运营一个平台或市场,可以将下游商户或客户以子账户的形式入驻到你的 UQPAY 主账户下。每个子账户拥有独立的身份、验证状态和 UQPAY 产品访问权限。你通过 API 管理这些子账户,并在账户激活后代表它们进行操作。

前置条件

开始之前,请确认你已准备好:

实体类型

创建子账户时需指定实体类型:

入驻流程

1

创建子账户

调用 Create SubAccount 并传入实体资料和实体类型。此请求无需选择业务线。
成功响应会返回新账户的详情:
响应中的关键字段:
2

处理初始响应

账户不会立即激活。创建后:
  • statusPROCESSING — 账户已创建但尚不可用。
  • verification_statusPENDING — 身份验证或企业验证进行中。
妥善保存 account_id 供后续使用。无需轮询 — 请通过 Webhook 接收状态更新。
3

监听 Webhook 通知

UQPAY 会在账户进入验证流程后发送 Webhook 事件:在控制台配置你的 Webhook 端点。配置步骤参见 Webhook 设置

账户状态生命周期

账户创建之后,子账户会沿两条并行的状态维度推进:

status

跟踪账户是否可用:

verification_status

跟踪身份验证或企业验证的结果:
accountStatus webhook 对拒绝和退回状态下发的是 REJECTEDRETURNED(而非 REJECT / RETURN)。详见 Account Status webhook

下一步

关联账户

使用 x-on-behalf-of header 代表子账户发起 API 请求。

Create SubAccount API

Create SubAccount 接口的完整参数说明。

Account Status webhook

onboarding.account.createonboarding.account.update 的事件 payload 参考。