加小费
<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&quot;: &quot;16,1&quot;,则表示只有闪送、达达加小费成功,UU加小费失败</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>
#成功
{
&quot;code&quot;: 0,
&quot;message&quot;: &quot;ok&quot;,
&quot;data&quot;: {
&quot;sss_peisong_id&quot;: &quot;1920078&quot;,
&quot;order_id&quot;: &quot;20200511175113&quot;,
&quot;msg&quot;:&quot;闪送、达达平台加小费成功 UU跑腿加小费失败&quot;,
&quot;success_third_logistics_ids&quot;: &quot;16,1&quot;,
&quot;fail_third_logistics_ids&quot;: &quot;8&quot;
}
}
#失败
{
&quot;code&quot;: 1,
&quot;message&quot;: &quot;当前订单状态不支持加小费操作&quot;
}
{
&quot;code&quot;: 1,
&quot;message&quot;: &quot;账户余额不足&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>