跳转到主要内容
POST
Create SubAccount

授权

x-auth-token
string
header
必填

由 UQPAY 提供的登录 API Token。

请求体

application/json

请从以下实体类型中选择一项。

有关申请该账户的个人的信息。

entity_type
enum<string>
必填

该账户的实体类型。

可用选项:
COMPANY,
INDIVIDUAL
示例:

"COMPANY"

nickname
string
必填

该账户的昵称。

Maximum string length: 100
示例:

"MyTechCorp"

individual_info
object

个人账户注册的个人信息。

  • entity_typeINDIVIDUAL 时必填。
  • genderannual_income 自 2026-07-02 起,对个人类型 SubAccount 为必填。
identity_verification
object

个人的身份验证信息。

  • entity_typeINDIVIDUAL 时必填。
expected_activity
object
  • entity_typeINDIVIDUAL 时必填。
proof_documents
object
  • entity_typeINDIVIDUAL 时必填。
tos_acceptance
object

有关该账户接受 UQPAY 服务协议的详细信息。此属性仅可针对 Custom 账户更新。

响应

200 - application/json

账户创建成功。

account_id
string
必填

账户的唯一标识符。

示例:

"f5bb6498-552e-40a5-b14b-616aa04ac1c1"

short_reference_id
string
必填

账户的短引用 ID。

示例:

"P220406-LLCVLRM"

status
string
必填

账户的状态。为以下之一:

  • ACTIVE - 账户已激活。
  • PROCESSING - 账户当前正在审核和处理中。
  • INACTIVE - 账户暂时未激活
  • CLOSED - 账户已关闭。
示例:

"PROCESSING"

verification_status
enum<string>
必填

KYC/KYB 的状态。为以下之一:

  • REJECT - 账户在身份验证过程中被拒绝。
  • APPROVED - 账户已通过验证且处于激活状态。
  • PENDING - 账户当前正在进行身份验证。
  • EXPIRED - 验证已过期。
  • RETURN - 账户已被退回以进行身份验证,需要重新上传。

Webhook 说明:accountStatus webhook 通知中,这两个状态 分别以 REJECTEDRETURNED 下发(而非 REJECT / RETURN)。 其他所有值均相同。参见 账户状态 webhook

可用选项:
APPROVED,
PENDING,
REJECT,
EXPIRED,
RETURN
示例:

"APPROVED"