送件侠开放平台

闪时送开放平台


加小费

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

页面列表

ITEM_HTML