取消自动签署

此端点用于取消发行人当前有效的自动签署。取消之后，集成方应将该发行人此后的发行改走人工签署流程（QI SIGN）。

完整的流程衔接及各状态的含义请参阅自动签署流程。

吊销完成前仍可能自动签署

当自动签署已进入 pending_certificate 或 enabled 时，发行人的私有证书可能已安装在 CertifiQI 中。此时，取消会使自动签署转为 pending_revocation，待 QI Tech 吊销证书后才转为 canceled。

自动签署由 CertifiQI 使用该证书完成，只有吊销后才无法再进行。在此之前，通过 CertifiQI 送签的该发行人操作仍可能被自动签署。因此，请在申请取消后立即将该发行人的操作改走人工签署流程（QI SIGN）。

取消自动签署 (PUT)

Request

ENDPOINT

/issuer_management/issuer/ISSUER-KEY/auto_signature/cancel

MÉTODO

PUT

Path Params

字段	类型	描述	字符数
`ISSUER-KEY`	string	发行人的唯一键（UUID v4）。	36

Request Body

{
  "reason": "发行人申请终止自动签署"
}

Request Body Params

字段	类型	描述	字符数
`reason` *	string	取消原因。会记录在自动签署的事件历史中。	1023

可取消的状态

取消作用于发行人当前有效的自动签署，无需提供 issuer_auto_signature_key。

当前状态	是否可取消	取消后的状态
`pending_term_generation`	是	`canceled`
`pending_signature`	是	`canceled`
`pending_certificate`	是	`pending_revocation`
`enabled`	是	`pending_revocation`
`pending_revocation`	否	取消已在进行中。

处于 reproved 或 canceled 的自动签署已不再是发行人当前有效的自动签署，取消将返回 ISS0000028。

取消的影响

取消加入协议的签署信封，前提是自动签署处于 pending_signature。已分发的签署链接将失效。
吊销期间禁止新的启用。 自动签署处于 pending_revocation 期间，申请自动签署将返回 ISS0000029。进入 canceled 之后，可以申请新的启用。
触发 webhook issuer_management.auto_signature_status_change，携带取消后的状态。当取消经过 pending_revocation 时，吊销结束后会再发送一次状态为 canceled 的 webhook。

Response

STATUS

200

响应与自动签署查询返回的对象相同，状态为取消后的状态。

Response Body

{
  "issuer_auto_signature_key": "9c3f0f1e-6a2b-4c58-9c9c-0f6b1d2a7e34",
  "status": "pending_revocation",
  "signed_at": "2026-02-11T14:02:31",
  "enabled_at": "2026-02-12T10:40:12",
  "issuer_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e",
  "term_document_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e/adhesion_auto_signature_term/5d1c8b30-2f44-4a9e-8c7b-1e0a6f2d9b55",
  "envelope_key": "5b930d3d-3713-4c42-85d5-f8e9e44e30ce",
  "created_at": "2026-02-10T09:15:44",
  "event_list": [
    {
      "event_type": "auto_signature_status_change",
      "status": "enabled",
      "event_data": {
        "status": "enabled"
      },
      "created_at": "2026-02-12T10:40:12"
    },
    {
      "event_type": "auto_signature_status_change",
      "status": "pending_revocation",
      "event_data": {
        "status": "pending_revocation",
        "reason": "发行人申请终止自动签署"
      },
      "created_at": "2026-03-02T16:21:08"
    }
  ]
}

错误

HTTP	代码	触发条件
400	`QIT000001`	请求体缺少 `reason`，或含有未知字段。
400	`ISS0000030` (`AutoSignatureInWrongStatus`)	自动签署已处于 `pending_revocation`。
403	`ISS000011` (`TenantForbidden`)	客户对所指定发行人的登记信息不具备完整访问权限。
404	`ISS000009` (`IssuerNotFound`)	不存在与所给键对应的发行人。
404	`ISS0000028` (`AutoSignatureNotFound`)	发行人没有有效的自动签署。

取消自动签署 (PUT)​

Request​

Path Params​

Request Body Params​

可取消的状态​

取消的影响​

Response​

错误​