取消订阅 POST /v1/subscription/cancel

Body 字段说明

字段 类型 必填 最大长度 说明
subscriptionNo string 是 32 订阅号
merchantNo string 否 32 商户号；有值时须与订阅一致
cancelReason string 否 256 取消原因

请求示例

{
  "subscriptionNo": "SP01010120260319120000000001",
  "merchantNo": "M100001",
  "cancelReason": "USER_REQUEST"
}

响应 data 字段说明

成功时 data 为取消结果对象，字段如下：

字段 类型 说明
subscriptionNo string 订阅号
outTradeNo string 商户签约订单号
status string 订阅状态（通常为 CANCELLED；幂等场景可能为 FAILED），见 §3.1
cancelTime string 取消时间（FAILED 幂等场景为 null）

成功响应示例

{
  "success": true,
  "code": null,
  "message": null,
  "data": {
    "subscriptionNo": "SP01010120260319120000000001",
    "outTradeNo": "MCH202603190001",
    "status": "CANCELLED",
    "cancelTime": "2026-04-16 14:30:00"
  }
}

###