设置发行人主银行账户
本端点将发行人已有的某个银行账户提升为主账 户(is_default: true)。此前被标记为主账户的账户会自动变为 is_default: false。
更换发行人的主银行账户
发行人可以登记多个银行账户,其中只有一个被标记为主账户。若需更正主账户中有误的数据(校验位、分行、ISPB),请使用下述流程。
前提条件
发行人必须处于 in_filling 状态。超过该状态之后,主账户便不可更改 — 这是有意为之的行为,因为主账户会在金融操作中被引用。
更换流程(3 次调用)
- POST
.../bank_account→ 创建新的(正确的)账户。 - POST
.../bank_account/{key}/set_default→ 将新账户提升为主账户。 - DELETE
.../bank_account/{old_key}→ 删除旧账 户。
同样的顺序约束在此适用:由于不允许删除主账户,提升操作必须先于删除操作。若尝试颠倒顺序,会返回 HTTP 400 / ISS0000012。
Request
ENDPOINT
/issuer_management/issuer/ISSUER-KEY/bank_account/BANK-ACCOUNT-KEY/set_default方法
POSTPath Params
| 字段 | 类型 | 描述 | 字符数 |
|---|---|---|---|
ISSUER-KEY | string | 发行人的唯一键值(UUID v4)。 | 36 |
BANK-ACCOUNT-KEY | string | 将被提升为主账户的银行账户的唯一键值(UUID v4)。 | 36 |
Request Body
请求体中无需提交任何内容。
Response
STATUS
204账户已提升为主账户。响应体中不返回任何内容。
错误
| HTTP | 错误码 | 场景 |
|---|---|---|
| 400 | ISS0000011 | 发行人不处于 in_filling 状态。 |
| 403 | ISS000011 | 该租户无权访问此发行人。 |
| 404 | ISS000005 | 在该发行人下未找到对应的 bank_account_key。 |
| 404 | ISS000009 | 未找到 issuer_key。 |