接口说明
- 请将回调作为主要状态流转方式
- 请做好防重,可能会因网络等问题相同状态多次回调,导致接入方收到多条相同的回调信息
- 状态推送一共分7种消息:
- 推送司机接单、改派
- 推送服务状态信息(出发、已到达、开始服务、结束服务)
- 推送订单取消信息(系统取消、客服取消)
- 推送订单费用信息
- 推送订单确认信息【对接该状态回调前请先与首约产品确认】(订单确认的回调url需要与completed状态的回调地址保持一致)
- 用车时间bookingDate:1、用车时间根据渠道特定需要返回;2、用车时间只在司机接单或改派状态返回
- 回调失败情况下,会发起重试 。 重试次数: 6次 重试间隔 : {1s,5s,1m,10m,30m,1h,2h}
回调地址
https:// <Partner_DOMAIN>/<CallBackURL>
请求方式
POST
请求参数
名称 | 类型 | 是否必选 | 说明 |
---|---|---|---|
eventId | string | yes | 事件id,唯一标识 |
eventTime | int | yes | 事件发生时间戳 |
expiredTime | int | yes | 请求过期时间戳 |
sign | string | yes | 请求签名,根据签名生成规则计算 |
channel | string | yes | 统一传shouqi,标识首汽调用 |
meta | object | yes | 回调信息,可参考回调demo |
meta参数
名称 | 类型 | 是否必选 | 说明 |
---|---|---|---|
orderNo | string | yes | 首约订单号 |
partnerOrderNo | string | yes | 合作方订单号 |
status | string | yes | 订单状态 |
bookingDate | string | no | 用车时间:1、用车时间根据渠道特定需要返回;2、用车时间只在司机接单或改派状态返回 |
driverInfo | object | no | 当status值为accepted或reassign时为必选,参见回调示例 |
feeInfo | object | no | 当status值为completed时为必选,参见回调示例 |
finalStatus | object | no | 当status值为order_finished时为必选,参见回调示例 |
customerServiceInfo | object | no | 当status值为sys_canceled、cs_canceled时为必选,参见回调示例 |
chargeInfo | object | no | 当status值为offline_pay时为必选,参见回调示例 |
cancelFee | string | no | 取消费,客服取消sys_canceled/系统取消cs_canceled返回,如果没有则返回0(新增字段),参见回调示例 |
passingPoints | Object | no | completed状态时,如果有途径点会返回:参见回调示例 |
返回结果
名称 | 类型 | 说明 |
---|---|---|
result | string | 0:成功;非0 :失败原因编号 |
errmsg | string | 失败原因描述,若成功值可为空 |