接收订单状态回调
优质
小牛编辑
140浏览
2023-12-01
接收订单状态回调
说明
- 当订单状态发生改变时,滴滴出行会通过回调服务将这些事件通知接入方。使用此功能需开启回调服务,关于如何设置接收消息请见回调服务配置。
- 当接入方收到回调后,需要重新调用订单详情接口,拉取最新的订单状态和信息,然后做相应处理
支持场景
- 订单中间状态流转
司机接单(等待接驾) 改派中 乘客迟到 乘客迟到计费 司机迟到 司机到达 计费中(行程中)
- 订单终态通知
正常支付待评论 正常支付已评论 取消订单已支付 取消订单无需支付 订单超时 司机改派关闭 未能完成服务关闭
- 订单支付确认通知
订单正常结束待支付(确认支付或费用投诉) 订单取消费用待支付(确认支付)
- 订单退款通知:产生投诉的订单,退款操作后,通知接入方调用订单详情获取退款信息
- 订单改价通知:客服对未支付订单更改价格后,通知接入方调用订单详情获取最新价格
- 客服关单通知:由于各种原因,客服核实后,关闭订单,通知接入方获取订单详情
注:收到回调通知后,拉取订单详情接口获取最新状态(status,sub_status)
HTTP请求方式
POST (普通form格式传参)
返回数据格式
Json
访问授权限制
暂无
请求参数
名称 | 类型 | 必选 | 描述 |
client_id | string | yes | 申请应用时分配的AppKey(同授权认证) |
order_id | string | yes | 订单id |
notify_type | int | yes | 通知类型: 1-订单中间状态流转 2-订单终态通知 3-支付确认通知 4-订单退款通知 5-订单改价通知 6-客服关单通知 8-下单成功通知(Webapp、H5) |
notify_desc | string | yes | 通知说明 |
timestamp | int | yes | 当前时间戳 |
sign | string | yes | 签名 |
注意事项
sign签名请参照 签名算法
返回数据
{
"errno":0,
"errmsg":"SUCCESS"
}
返回值字段 | 字段类型 | 字段说明 |
errno | int | 错误码,0为通知成功,非0为通知失败 |
errmsg | string | 错误信息描述 |