预授权冻结资金支付
<p><strong>接口描述:</strong> </p>
<ul>
<li>1、预授权主扫/被扫的前提下使用,预授权完成。</li>
<li>2、预授权冻结资金支付的金额即入账商户账户,剩余金额退还用户侧。</li>
<li>3、预授权冻结资金支付的金额,如有多收的场景,可调用退款接口退还用户多扣的货款</li>
</ul>
<p><strong>接口URL:</strong> </p>
<ul>
<li><code>https://open.51shoubei.com/openpay/v3/freezetopay</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>内容</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Content-Type</td>
<td style="text-align: left;">是</td>
<td>application/json</td>
</tr>
</tbody>
</table>
<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 style="text-align: left;">说明</th>
<th>参数示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">inst_no</td>
<td style="text-align: left;">string(8)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">机构号 ,收呗分配</td>
<td>900024</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">收呗商户号</td>
<td>851811130002</td>
</tr>
<tr>
<td style="text-align: left;">trade_no</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">支付订单号(微信/支付宝/收呗订单号)</td>
<td>20000032114018111516011200013</td>
</tr>
<tr>
<td style="text-align: left;">pay_trace_no</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">支付请求流水号(支付订单号和支付请求流水号二选其一必传)</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">pay_time</td>
<td style="text-align: left;">string(14)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">请求支付时间</td>
<td>2018116165053</td>
</tr>
<tr>
<td style="text-align: left;">total_amount</td>
<td style="text-align: left;">string(8)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">支付金额,单位:分</td>
<td>100</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">签名</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
</tbody>
</table>
<p><strong>请求示例:</strong></p>
<ul>
<li>通过支付订单号查询</li>
</ul>
<pre><code class="language-json">{
"inst_no": 60000001,
"mch_no": "851808290003",
"trade_no": "20000002814118090716435200001",
"sign": "6e461f5c95c055b3aed017b8fcb8a1a9"
}</code></pre>
<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 style="text-align: left;">说明</th>
<th>参数示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">return_code</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">响应码:SUCCESS成功,FAIL失败,响应码仅代表通信或参数</td>
<td>SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">return_msg</td>
<td style="text-align: left;">string(128)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">返回信息提示,“支付成功”,“支付中”,“参数不合法” 等</td>
<td>支付成功</td>
</tr>
<tr>
<td style="text-align: left;">result_code</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">业务结果:PAY_SUCCESS 支付成功 ,PAY_IN_PROCESS 支付中 ,PAY_FAIL 支付失败,只有在return_code为SUCCESS时才会返回。</td>
<td>PAY_SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">pay_type</td>
<td style="text-align: left;">string(3)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">支付类型:300支付宝,400微信</td>
<td>300</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">商户号</td>
<td>851811130002</td>
</tr>
<tr>
<td style="text-align: left;">shop_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">门店号</td>
<td>86000033007</td>
</tr>
<tr>
<td style="text-align: left;">mch_name</td>
<td style="text-align: left;">string(80)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">商户名称</td>
<td>休休4D</td>
</tr>
<tr>
<td style="text-align: left;">shop_name</td>
<td style="text-align: left;">string(50)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">门店名称</td>
<td>1号店</td>
</tr>
<tr>
<td style="text-align: left;">pay_trace_no</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">交易流水号,原样回</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">pay_time</td>
<td style="text-align: left;">string(14)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">请求交易时间,yyyyMMddHHmmss</td>
<td>20181116155621</td>
</tr>
<tr>
<td style="text-align: left;">total_amount</td>
<td style="text-align: left;">string(8)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">支付金额,单位:分</td>
<td>100</td>
</tr>
<tr>
<td style="text-align: left;">end_time</td>
<td style="text-align: left;">string(14)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">支付完成时间,yyyyMMddHHmmss</td>
<td>20181116155621</td>
</tr>
<tr>
<td style="text-align: left;">trade_no</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">收呗订单号</td>
<td>20000002814118090716435200001</td>
</tr>
<tr>
<td style="text-align: left;">td_trade_no</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">通道/微信/支付宝订单号</td>
<td>null</td>
</tr>
<tr>
<td style="text-align: left;">user_id</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">付款方用户id、微信openid、支付宝账户”等</td>
<td>wx1dafada31dskcada</td>
</tr>
<tr>
<td style="text-align: left;">attach</td>
<td style="text-align: left;">string(128)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">扩展字段原样返回</td>
<td>1234</td>
</tr>
<tr>
<td style="text-align: left;">receipt_amount</td>
<td style="text-align: left;">string(8)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">商户实收金额,单位:分</td>
<td>100</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">签名字符串</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
</tbody>
</table>
<p><code>备注:</code> 若返回结果result_code=PAY_IN_PROCESS 支付中,需要调用订单查询接口进行轮询,建议返回后5秒开始。一共轮询15次间隔5秒</p>
<p><strong>返回示例:</strong> </p>
<ul>
<li>成功返回结果:</li>
</ul>
<pre><code class="language-json">{
"return_code": "SUCCESS",
"return_msg": "支付成功",
"result_code": "PAY_SUCCESS",
"pay_type": "400",
"mch_name": "小白盒周康宝岛牛肉饭",
"shop_name": "",
"mch_no": "851808290003",
"shop_no": "",
"pay_trace_no": "134dsa463451313131313001",
"pay_time": "20780907150901",
"total_amount": "1",
"end_time": null,
"trade_no": "20000002814118090716435200001",
"td_trade_no": "4200000180201809074294896717",
"user_id": null,
"attach": "888",
"receipt_amount": "1",
"sign": "1d8612c686ef86ffe1c912a2303d3346"
}
</code></pre>