取消订单
接口说明
- cancelType说明
- 1001:乘客取消
- 1002:渠道超时取消 (指第三方的决策时间小于我们的派单时间,例如首约侧派单到5分钟还没有派到司机,而三方2分钟决策取消了,这时候第三方取消属于渠道超时取消)
- 1003:竞争失败取消 (指第三方接入的多家供应商都有派到司机,但是我们因为派单距离和时间等被第三方取消)
- 1004:准入过滤取消 (指第三方有司机距离、时间等范围限制,比如第三方派单半径3公里,我们派到的一个司机距离乘客4公里,那么第三方取消就属于准入过滤取消)
- 1005:渠道风控取消
接口地址
https:// <SQYC_DOMAIN>/touch/partner/cancelOrder
请求方式
POST
请求参数
名称 | 类型 | 是否必选 | 说明 |
---|---|---|---|
orderNo | string | yes | 订单号 |
partnerOrderNo | string | yes | 合作方订单号 |
reason | string | yes | 取消原因 |
cancelType | String | no | 取消类型,接入订单池功能必传(cancelType=1008) |
sign | string | yes | 参见sign生成算法 |
channel | string | yes | 渠道名称,由首约提供 |
partnerCancelOrderPenaltyAmt | string | no | 三方违约金金额(特定渠道) |
返回数据
名称 | 类型 | 说明 |
---|---|---|
result | string | 0:成功;非0:失败原因编号 |
errmsg | string | 失败原因描述,若成功则值为空 |
data | object | 取消返回数据,returnCode忽略 |
返回示例
{
"result": "0",
"data": {
"returnCode": "0",
"errmsg": null,
"orderNo": "B1517394320727868",
"cancelFee": 0
},
"errmsg": "SUCCESS"
}