跳到主要内容

设置发行人主联系人

本端点将发行人已有的某个联系人提升为主联系人（is_default: true）。此前被标记为主联系人的联系人会自动变为 is_default: false。

更换发行人的主联系人​

发行人可以登记多个联系人，但其中只有一个被标记为主联系人。若主联系人在登记时填入了错误数据（电子邮件拼写错误、电话号码位数有误），请使用下述流程进行替换。

前提条件

发行人必须处于 in_filling 状态。一旦发行人离开该状态，就不再允许更改主联系人/主账户 — 端点会返回 HTTP 400 / ISS0000011。

更换流程（3 次调用）​

  1. POST .../issuer_contact_information → 创建新的（正确的）联系人。
  2. POST .../issuer_contact_information/{key}/set_default → 将新联系人提升为主联系人。
  3. DELETE .../issuer_contact_information/{old_key} → 删除旧的（有拼写错误的）联系人。

顺序很重要：由于不允许删除被标记为主联系人的联系人，必须先提升新联系人，再删除旧联系人。若尝试颠倒顺序，会返回 HTTP 400 / ISS0000013。

Request​

ENDPOINT
/issuer_management/issuer/ISSUER-KEY/issuer_contact_information/ISSUER-CONTACT-INFORMATION-KEY/set_default
方法
POST

Path Params​

字段类型描述字符数
ISSUER-KEYstring发行人的唯一键值（UUID v4）。36
ISSUER-CONTACT-INFORMATION-KEYstring将被提升为主联系人的联系人的唯一键值（UUID v4）。36

Request Body​

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

Response​

STATUS
204

联系人已提升为主联系人。响应体中不返回任何内容。

错误​

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