跳转到主要内容
POST
创建子账户
reference 不可更改。 它是您在 X-Sub-Account 请求头中发送、用于在子账户上操作的标识符,也是 webhook 中 subAccount 字段收到的值——请谨慎选择,因为创建后无法修改。格式:^[a-z0-9][a-z0-9_-]{1,31}$——2 到 32 个字符,仅限小写字母、数字、- 和 _,并以小写字母或数字开头。reference 在账户内必须唯一:重复使用已存在的值将返回 409 SUB_ACCOUNT_REFERENCE_TAKEN。子账户创建时拥有独立余额,初始为零,与主账户余额完全独立。关于 X-Sub-Account 请求头的行为和完整的错误表,参见子账户。

授权

Authorization
string
header
必填

通过 POST /auth(client_id + client_secret)获取的访问令牌。有效期 300 秒。

请求体

application/json
reference
string
必填

由您定义的子账户标识符。在账户内唯一,创建后不可更改。principal 是主账户的保留字,不可使用:将返回 400 SUB_ACCOUNT_INVALID_REFERENCE。

Pattern: ^[a-z0-9][a-z0-9_-]{1,31}$
示例:

"loja-centro"

name
string
必填

子账户显示名称

Maximum string length: 255
示例:

"Loja Centro"

响应

子账户创建成功

id
string<uuid>
必填

子账户 ID

reference
string
必填

子账户的 reference

示例:

"loja-centro"

name
string
必填

子账户名称

示例:

"Loja Centro"

status
string
必填

子账户状态

示例:

"approved"

createdAt
string<date-time>
必填

创建时间