取消订单

PUT

/openapi/v3/orders/:id/cancel

该接口用于取消订单。具体可取消条件及证书后续处理以产品与 CA 规则为准。完整的 取消订单流程 见业务流程章节。

关于强制取消（force_cancel）

一般情况下，仅未签发或仍处于产品规定取消期（通常为签发后 30 天内，部分产品为 7 天内）的订单可发起取消。

force_cancel=true 在账户已开通强制取消权限，且仍符合服务年窗口、产品和 CA 规则时，可对签发超过 30 天的订单申请取消。

• 非续期订单：证书签发时间在 30 天内，取消时自动吊销；签发时间超过 30 天，证书不会吊销。
• 多年期续期订单：续期前的证书不会吊销；续期中的证书签发未超过 30 天时自动吊销，超过 30 天时不会吊销，且费用不退回。

Path 参数

参数	类型	必填	说明
id	string	是	订单 ID

Body 参数 application/json

参数	类型	必填	说明
force_cancel	bool	否	强制取消

curl -X PUT 'https://api.certcloud.cn/openapi/v3/orders/F7vbIVYL/cancel' \
  -H 'Content-Type: application/json' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id' \
  -d '{
    "force_cancel": false
  }'

fetch('https://api.certcloud.cn/openapi/v3/orders/F7vbIVYL/cancel', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id'
  },
  body: JSON.stringify({ force_cancel: false })
});

payload := map[string]bool{"force_cancel": false}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("PUT", "https://api.certcloud.cn/openapi/v3/orders/F7vbIVYL/cancel", bytes.NewBuffer(body))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-CC-Auth-Key", "your-auth-key")
req.Header.Set("X-CC-Key-ID", "your-key-id")
client := &http.Client{}
resp, _ := client.Do(req)

import requests

requests.put(
    'https://api.certcloud.cn/openapi/v3/orders/F7vbIVYL/cancel',
    headers={
        'Content-Type': 'application/json',
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id'
    },
    json={'force_cancel': False}
)

200成功

{
  "code": "success"
}