扫码枪扣款请求
<h5>简要描述</h5>
<ul>
<li>车辆出场时到达出口通道,车主出示付款码,岗亭收费员使用扫码枪扫描车主付款码,扫码后本地停车场系统主动向支付平台发起扣款请求;</li>
<li>支付平台收到请求后执行扣款动作,扣款成功后通过 下行接口[支付结果通知] 返回给本地停车场系统;</li>
</ul>
<h5>注意事项</h5>
<ul>
<li>对应入场时上传的order_id,每次请求相同</li>
</ul>
<h5>请求参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
<th style="text-align: left;">示列</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">service</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">接口名称</td>
<td style="text-align: left;">requestbarcodepay</td>
</tr>
<tr>
<td style="text-align: left;">parkid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">车场ID</td>
<td style="text-align: left;">20210001</td>
</tr>
<tr>
<td style="text-align: left;">order_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单记录号</td>
<td style="text-align: left;">10001</td>
</tr>
<tr>
<td style="text-align: left;">parking_serial</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单流水号</td>
<td style="text-align: left;">PN0000000889</td>
</tr>
<tr>
<td style="text-align: left;">car_number</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">车牌号</td>
<td style="text-align: left;">粤A12345</td>
</tr>
<tr>
<td style="text-align: left;">in_time</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">入场时间</td>
<td style="text-align: left;">2021-02-01 18:48:56</td>
</tr>
<tr>
<td style="text-align: left;">duration</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">停车时长(分钟)</td>
<td style="text-align: left;">120</td>
</tr>
<tr>
<td style="text-align: left;">price</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">单价</td>
<td style="text-align: left;">15.80</td>
</tr>
<tr>
<td style="text-align: left;">gateid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">出口通道编号</td>
<td style="text-align: left;">2</td>
</tr>
<tr>
<td style="text-align: left;">gatename</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">出口通道名称</td>
<td style="text-align: left;">大门出口</td>
</tr>
<tr>
<td style="text-align: left;">auth_code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">付款码</td>
<td style="text-align: left;">13888889999</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">当前时间戳,单位ms</td>
<td style="text-align: left;">1546831287000</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">签名</td>
<td style="text-align: left;">1E181500D2BBBF47F45C360459E96DD0</td>
</tr>
</tbody>
</table>
<pre><code>sign = md5(UTF8(parkid+order_id+parking_serial+price+timestamp+auth_code))
=md5(UTF8(2021000110001PN000000088915.50154683128700013888889999))
=189352E7ECE76D74AB46452561235FD3</code></pre>
<h5>请求示例</h5>
<pre><code> {
"service": "requestbarcodepay",
"parkid": "20210001",
"order_id": "10001",
"parking_serial": "PN0000000889",
"car_number": "粤A12345",
"in_time": "2021-02-01 18:48:56",
"duration": 110,
"price": "15.50",
"gateid": 2,
"gatename": "北门出口",
"auth_code": "13888889999",
"timestamp": 1546831287000,
"sign": "AFE60745D403AC71DE46A6E157906C91"
}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>示列</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">service</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>接口名称</td>
<td>requestbarcodepay</td>
</tr>
<tr>
<td style="text-align: left;">result_code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>返回代码</td>
<td>0 成功,其它失败</td>
</tr>
<tr>
<td style="text-align: left;">order_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>订单记录号</td>
<td>10001</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>返回描述</td>
<td>上传成功</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<p><strong>注意 :</strong> 返回成功只是代表支付平台收到了请求并且在处理扣款,真正扣款成功后要通过—>下行接口[支付结果通知] 返回给本地停车场系统</p>
<pre><code> {
"service": "requestbarcodepay",
"result_code": 0,
"order_id": "10001",
"message": "请求成功,正在扣款"
}
{
"service": "requestbarcodepay",
"result_code": 1,
"order_id": "10001",
"message": "请求失败"
}</code></pre>