跳到主要内容

设置发行人主银行账户

本端点将发行人已有的某个银行账户提升为主账户(is_default: true)。此前被标记为主账户的账户会自动变为 is_default: false


更换发行人的主银行账户

发行人可以登记多个银行账户,其中只有一个被标记为主账户。若需更正主账户中有误的数据(校验位、分行、ISPB),请使用下述流程。

前提条件

发行人必须处于 in_filling 状态。超过该状态之后,主账户便不可更改 — 这是有意为之的行为,因为主账户会在金融操作中被引用。

更换流程(3 次调用)

  1. POST .../bank_account → 创建新的(正确的)账户。
  2. POST .../bank_account/{key}/set_default → 将新账户提升为主账户。
  3. DELETE .../bank_account/{old_key} → 删除旧账户。

同样的顺序约束在此适用:由于不允许删除主账户,提升操作必须先于删除操作。若尝试颠倒顺序,会返回 HTTP 400 / ISS0000012


Request

ENDPOINT
/issuer_management/issuer/ISSUER-KEY/bank_account/BANK-ACCOUNT-KEY/set_default
方法
POST

Path Params

字段类型描述字符数
ISSUER-KEYstring发行人的唯一键值(UUID v4)。36
BANK-ACCOUNT-KEYstring将被提升为主账户的银行账户的唯一键值(UUID v4)。36

Request Body

请求体中无需提交任何内容。


Response

STATUS
204

账户已提升为主账户。响应体中不返回任何内容。


错误

HTTP错误码场景
400ISS0000011发行人不处于 in_filling 状态。
403ISS000011该租户无权访问此发行人。
404ISS000005在该发行人下未找到对应的 bank_account_key
404ISS000009未找到 issuer_key