接口说明

  1. 请将回调作为主要状态流转方式
  2. 请做好防重,可能会因网络等问题相同状态多次回调,导致接入方收到多条相同的回调信息
  3. 状态推送一共分7种消息:
    1. 推送司机接单、改派
    2. 推送服务状态信息(出发、已到达、开始服务、结束服务)
    3. 推送订单取消信息(系统取消、客服取消)
    4. 推送订单费用信息
    5. 推送订单确认信息【对接该状态回调前请先与首约产品确认】(订单确认的回调url需要与completed状态的回调地址保持一致)
  4. 用车时间bookingDate:1、用车时间根据渠道特定需要返回;2、用车时间只在司机接单或改派状态返回
  5. 回调失败情况下,会发起重试 。 重试次数: 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时为必选,参见回调示例
refundInfo object no 当status值为cs_refund时为必选,参见回调示例(后续不再对接,请对接投诉通知)
cancelFee string no 取消费,客服取消sys_canceled/系统取消cs_canceled返回,如果没有则返回0(新增字段),参见回调示例
passingPoints Object no completed状态时,如果有途径点会返回:参见回调示例

返回结果

名称 类型 说明
result string 0:成功;非0 :失败原因编号
errmsg string 失败原因描述,若成功值可为空
Copyright © 首约科技(北京)有限公司 2020 all right reserved,powered by Gitbook该文件修订时间: 2024-09-10 08:31:45

results matching ""

    No results matching ""