订单回调
根据创建商家寄件订单中的call_back_url字段的回调地址,在订单状态变动时,回调给用户端
如果call_back_url为空将不会回调;回调接口以POST形式回调;
回调语法
回调头
名称 | 类型 | 是否必填 | 示例值 | 描述 |
Content-Type | 字符串 | 是 | application/x-www-form-urlencoded;charset=UTF-8 | 默认值:application/x-www-form-urlencoded;charset=UTF-8 |
回调接口状态说明
回调类型
取件后不能再取消寄件请注意
每次回调间隔1秒钟,总共回调3次;如果回调成功,并且返回status=200是不会再次回调;
类型 | 描述 |
order_success | 下单成功回调 |
order_take | 取件回调 |
order_cancel | 用户主动取消回调 |
order_fail | 下单失败回调 |
order_receipt | 快递签收回调 |
请求元素
名称 | 类型 | 示例值 | 描述 |
type | 字符串 | -- | 回调类型 |
data | 字符串 | -- | 回调数据,详情查看data数据解密结构 |
名称 | 类型 | 示例值 | 描述 |
id | 字符串 | -- | 发起订单id |
task_id | 字符串 | -- | 任务id |
label | 字符串 | -- | 快递面单图片地址,只会在type=order_success and kuaidicom=yunda时返回此字段 |
kuaidinum | 数组 | -- | 快递单号 |
返回元素
名称 | 类型 | 示例值 | 描述 |
status | 数字 | 200 | 回调响应状态:200=成功;400=再次回调 |