跳转到主要内容
POST
Create Account

授权

x-auth-token
string
header
必填

由 UQPAY 提供的登录 API Token。

请求体

application/json

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

有关申请该账户的个人的信息。此字段适用于 INDIVIDUAL

entity_type
enum<string>
必填

账户类型。 此字段为必填,且必须是以下之一:

  • COMPANY - 为从事商业活动而设立的实体。
  • INDIVIDUAL - 来自业务场景的单一个人。目前仅适用于 Banking。
可用选项:
COMPANY,
INDIVIDUAL
示例:

"INDIVIDUAL"

name
string
必填

昵称,在控制台中选择账户时会显示。

示例:

"John Doe"

contact_details
object
必填
person_details
object
必填

个人账户持有人的个人信息。

residential_address
object
必填
documents
object[]
必填

为该个人账户提交的身份验证文件。

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"