送件侠开放平台

闪时送开放平台


加小费

简要描述:

请求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

页面列表

ITEM_HTML