申请取消订单

API文档最后更新: 2026-08-31

仅当 allowedActions 包含 requestCancellation 时可调用。

{
  "reason": "采购方不再需要"
}

请求字段：

字段	位置	JSON 类型	必填	含义
`clientOrderRef`	Path	string	是	创建订单时提交的第三方订单号
`reason`	Body	string	是	申请取消的原因，1 至 255 个字符

返回字段：

字段	JSON 类型	必填	含义
`code`	integer	是	固定为 `0`，表示请求成功
`message`	string	是	本次请求的处理说明
`data`	object	是	提交结果
`data.submitted`	boolean	是	`true` 表示取消申请已提交成功
`requestId`	string	是	本次请求编号，排查问题时提供给平台

返回示例：

{
  "code": 0,
  "message": "success",
  "data": {
    "submitted": true
  },
  "requestId": "req_01K0EXAMPLE"
}

HTTP 2xx 只表示取消申请已提交，不会直接取消订单。最终结果以订单的 orderState 和订单 Webhook 为准。