跳转到主要内容
POST
Create SubAccount

授权

x-auth-token
string
header
必填

由 UQPAY 提供的登录 API Token。

请求头

x-idempotency-key
string<uuid>

建议提供此请求头,以便安全地重试创建账户。为每个新子账户使用唯一的小写 UUID;重试同一次创建请求时,复用原 key 和请求体。

提供 key 时,已完成请求的响应会缓存 24 小时,使用相同 key 重试时会返回原响应。若原请求仍在处理中,请等待后再重试。

未提供 key 时,仅在 5 秒窗口内,根据原始请求体对同一账户、同一接口的相同请求去重。该短窗口无法保护窗口过期后的重试。

请求体

application/json

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

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

entity_type
enum<string>
必填

账户的实体类型。

可用选项:
INDIVIDUAL
示例:

"COMPANY"

nickname
string
必填

该账户的昵称。

Maximum string length: 100
示例:

"MyTechCorp"

individual_info
object

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

  • 当 entity_type 为 INDIVIDUAL 时必填。
identity_verification
object

个人的身份验证信息。

  • 当 entity_type 为 INDIVIDUAL 时必填。
expected_activity
object
  • 当 entity_type 为 INDIVIDUAL 时必填。
proof_documents
object
  • 当 entity_type 为 INDIVIDUAL 时必填。
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 通知中,这两个状态 分别以 REJECTED 和 RETURNED 下发(而非 REJECT / RETURN)。 其他所有值均相同。参见 账户状态 webhook。

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

"APPROVED"