取消行程
功能: 取消行程
支持运力: 所有运力类型
资源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": "行程已被司机接单,取消请重新进行取消确认"
}