加小费
简要描述:
请求URL:
/v1/order/addTip
请求方式:
- POST
参数:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
sss_peisong_id | 是 | string | 送件侠订单号 |
third_logistics_ids | 是 | string | 需要加小费的运力,多个以,分隔 必须匹配下单接口所选的运力 |
tip_amount | 是 | int | 小费金额,单位:元, int类型,不支持小数 |
请求示例demo x-www-form-urlencoded
appkey:4aa32923334940099ad6ecf6a552de33
timestamp:1575525613228
version:1.0
sign:c960c8153c5e7c8654ef60ec64aeb7c023eb48af
sss_peisong_id:1920025
third_logistics_ids:1,8,16
tip_amount:1
特别说明
只有`已下单成功并且骑手未接单状态`才支持加小费操作。
不同的运力方有不同的加小费规则,请最终以接口返回的success_third_logistics_ids参数结果为准
举例:
下单时选中的发单运力:闪送、达达、uu,调用此接口加小费1元
接口返回 success_third_logistics_ids": "16,1",则表示只有闪送、达达加小费成功,UU加小费失败
返回示例
#成功
{
"code": 0,
"message": "ok",
"data": {
"sss_peisong_id": "1920078",
"order_id": "20200511175113",
"msg":"闪送、达达平台加小费成功 UU跑腿加小费失败",
"success_third_logistics_ids": "16,1",
"fail_third_logistics_ids": "8"
}
}
#失败
{
"code": 1,
"message": "当前订单状态不支持加小费操作"
}
{
"code": 1,
"message": "账户余额不足"
}
返回参数说明
参数 | 说明 | 类型 | 必定返回 |
---|---|---|---|
sss_peisong_id | 送件侠订单号 | string | 是 |
order_id | 合作方订单号 | string | 是 |
msg | 加小费结果文字提示 | string | 是 |
success_third_logistics_ids | 加小费成功的运力, 多个以,分隔 | string | 是 |
fail_third_logistics_ids | 加小费失败的运力, 多个以,分隔 | string | 是 |