接收订单状态回调

优质
小牛编辑
140浏览
2023-12-01

接收订单状态回调

说明

  1. 当订单状态发生改变时,滴滴出行会通过回调服务将这些事件通知接入方。使用此功能需开启回调服务,关于如何设置接收消息请见回调服务配置
  2. 当接入方收到回调后,需要重新调用订单详情接口,拉取最新的订单状态和信息,然后做相应处理

支持场景

  1. 订单中间状态流转
     司机接单(等待接驾)
     改派中
     乘客迟到
     乘客迟到计费
     司机迟到
     司机到达
     计费中(行程中)
    
  2. 订单终态通知
     正常支付待评论
     正常支付已评论
     取消订单已支付
     取消订单无需支付
     订单超时
     司机改派关闭
     未能完成服务关闭
    
  3. 订单支付确认通知
     订单正常结束待支付(确认支付或费用投诉)
     订单取消费用待支付(确认支付)
    
  4. 订单退款通知:产生投诉的订单,退款操作后,通知接入方调用订单详情获取退款信息
  5. 订单改价通知:客服对未支付订单更改价格后,通知接入方调用订单详情获取最新价格
  6. 客服关单通知:由于各种原因,客服核实后,关闭订单,通知接入方获取订单详情

注:收到回调通知后,拉取订单详情接口获取最新状态(status,sub_status)

HTTP请求方式

POST (普通form格式传参)

返回数据格式

Json

访问授权限制

暂无

请求参数

名称类型必选描述
client_idstringyes申请应用时分配的AppKey(同授权认证)
order_idstringyes订单id
notify_typeintyes通知类型:
1-订单中间状态流转
2-订单终态通知
3-支付确认通知
4-订单退款通知
5-订单改价通知
6-客服关单通知
8-下单成功通知(Webapp、H5)
notify_descstringyes通知说明
timestampintyes当前时间戳
signstringyes签名

注意事项

sign签名请参照 签名算法

返回数据

{
    "errno":0,
    "errmsg":"SUCCESS"
}
返回值字段字段类型字段说明
errnoint错误码,0为通知成功,非0为通知失败
errmsgstring错误信息描述