取消行程

功能: 取消行程

支持运力: 所有运力类型

资源URL

PUT: v1/orders/{didi_oid}/cancel

请求参数:

参数名 类型 说明
didi_oid string 行程ID
passenger_phone string 乘车人手机号码,避免错误取消
lat float(平台可选) 用户当前坐标
lng float(平台可选) 用户当前坐标
map_type string(可选) 坐标系类型,默认soso,支持坐标系见备注
device json 设备相关信息,用于安全风控处理。如:{"imei":"12wdw","suuid":"123juuiuiausd","network":"WIFI","wifi_name":"tp_link123","wifi_ip":"10.10.10.10","wifi_mac":"asdasasd"}
imei/suuid imei/suuid必须存在一个
ip 设备ip地址
network(可选,wifi/2G/3G/4G) 如果network为wifi,wifi_name,wifi_ip,wifi_mac必须提供
wifi_name(可选) wifi名称
wifi_ip(可选) wifi ip地址
wifi_mac(可选) wifi mac地址
cancel_msg string(可选) 取消原因
cancel_token string(可选) 接入二次取消的必传参数,token有效时长20秒
type int(可选) 1:二次取消第一次取消请求;2:二次取消第二次取消确认;0:默认值,旧取消方式;0和1+2两种方式不能同时存在

注:取消可能需要支付取消费用。若用户频繁取消(24小时内超过3次),将被封禁24小时(提供用户id,则封禁id,未提供,则封禁手机号)

curl -X PUT 
-H "Content-Type: application/json" 
-H "Authorization: Bearer domain|{access_token}"     
"https://api.xiaojukeji.com/v1/orders/{didi_oid}/cancel" 
-d '{"cancel_msg":"Driver Late","device":{"imei":"YUIANE987","suuid":"132456987","time":"2016-03-01T10:00:00+0800"},"lat":"37.7766874","lng":"122.394857"}'

返回字段说明:

参数名 类型 说明
oid string 第三方订单id
didi_oid string 滴滴订单id
status string 行程状态(见备注
cancel_token string 用于二次取消的token(只第一次取消时返回)
cancel_fee int 二次取消方式下的取消费,单位(分)(只第一次取消时返回)

返回成功:

成功:http status 200

{
  "status": "PassengerCancelled",
  "oid": "1234567890",
  "didi_oid": "{didi_oid}"
  "cancel_token": "xxxxxxxxxxxxxxxxxx"
  "cancel_fee": "300"
}

错误返回:

失败:http status 非200

{
  "error": "code(40003)",
  "error_detail": "行程已结束,不能取消"
}
{
  "error": "code(68005)",
  "error_detail": "行程已被司机接单,取消请重新进行取消确认"
}

results matching ""

    No results matching ""