## 订单 / **取消订单-回调**（*oms.trade.cancel.callback*）
###### 最后更新日期：**2021-08-08 12:00:00**
*****
### **API描述**
接入方按照约定的格式标准提供【**接口调用地址**】。当平台产生获取商城客户取消订单的指令后，本平台系统调用提供的【**接口调用地址**】，把新增订单数据推送至接入方。
>[info] 数据流向：【接入方】**提供接口**，【本平台】**调用接口**，数据从【本平台】推送至【接入方】
*****
### **公共参数说明**
| 参数名称 | 类型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| app\_key | String(32) | 是 | 接入方AppKey，由平台对接人员提供 | |
| method | String(128) | 是 | 接口名称 | oms.trade.cancel.callback |
| version | String(10) | 是 | 接口版本 | 1.0 |
| biz\_content | Text | 是 | 业务参数的集合，并以**JSON格式**表示，并做urlencode处理，最大长度不限 | |
| sign | String(32) | 是 | 请求参数签名值，参考【签名加密】 | |
*****
### **业务参数说明**
| 参数名称 | 类型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| order\_sn | String | 是 | 申报订单编号 | |
| update\_time | String | 是 | 订单更新时间 | 2021-08-08 12:00:00 |
| cancel\_reason | String | 否 | 取消理由 | |
### **回调返回结果**
* 消息推送服务通过 POST 方式向接入方提供的地址推送消息。
* 只要请求正常返回并包含建议信息，本平台即认为消息成功接收。 建议的消息体格式为：
```
{"code":0,"msg":"success"}
```
