二维码支付(NATIVE)
<h1>二维码支付/支付宝主扫/微信主扫</h1>
<p><strong>接口描述</strong></p>
<ul>
<li>创建订单接口,返回支付宝/微信的付款链接等信息,可直接跳转到支付宝/微信收银台完成支付</li>
<li>支付宝链接以 alipay://xxx开头, 微信链接以 weixin://xxx开头(间连微信未开放)</li>
</ul>
<p><strong>接口地址</strong></p>
<p><code>测试</code>
<code>http://xipay.xiangma365.com/api/openpay/v3/prepay</code></p>
<p><code>正式</code>
<code>https://cpay.xiangma365.com/openpay/v3/prepay</code></p>
<p><strong>请求方式</strong></p>
<p><code>POST</code></p>
<p><strong>请求头部</strong></p>
<p><code>Content-Type:application/json</code></p>
<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 style="text-align: left;">示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">inst_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">机构号 ,通道分配</td>
<td style="text-align: left;">60000001</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">商户号</td>
<td style="text-align: left;">851811130002</td>
</tr>
<tr>
<td style="text-align: left;">shop_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">O</td>
<td style="text-align: left;">门店号</td>
<td style="text-align: left;">86000033007</td>
</tr>
<tr>
<td style="text-align: left;">terminal_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">O</td>
<td style="text-align: left;">终端号或设备SN</td>
<td style="text-align: left;">70020283</td>
</tr>
<tr>
<td style="text-align: left;">pay_type</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">支付类型:300 支付宝,400 微信,600 云闪付</td>
<td style="text-align: left;">300</td>
</tr>
<tr>
<td style="text-align: left;">pay_trace_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">支付请求流水号(在商户系统内唯一)</td>
<td style="text-align: left;">werddtuoji0988</td>
</tr>
<tr>
<td style="text-align: left;">pay_time</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">支付请求时间,yyyyMMddHHmmss格式</td>
<td style="text-align: left;">20880907150901</td>
</tr>
<tr>
<td style="text-align: left;">total_amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">支付金额,单位:分</td>
<td style="text-align: left;">1</td>
</tr>
<tr>
<td style="text-align: left;">notify_url</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">C</td>
<td style="text-align: left;">回调地址(无须ecode),支付成功时回调通知</td>
<td style="text-align: left;"><a href="http://open.sh.com">http://open.sh.com</a></td>
</tr>
<tr>
<td style="text-align: left;">order_body</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">O</td>
<td style="text-align: left;">订单描述</td>
<td style="text-align: left;">苹果笔记本</td>
</tr>
<tr>
<td style="text-align: left;">attach</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">O</td>
<td style="text-align: left;">自定义参数,原样返回</td>
<td style="text-align: left;">1234</td>
</tr>
<tr>
<td style="text-align: left;">goods_detail</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">O</td>
<td style="text-align: left;">详情内容,json格式字符串,详细见“goods_detail描述”</td>
<td style="text-align: left;">goods_detail”:[{\”goods_id\”:\”800510101\”,\”goods_name\”:\”ceshi\”,\”goods_price\”:\”40\”,\”goods_quantity\”:\”2\”}]”</td>
</tr>
<tr>
<td style="text-align: left;">share_type</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">O</td>
<td style="text-align: left;">分账类型:0.不分账,1.同步分账,2.异步分账,不传默认0</td>
<td style="text-align: left;">0</td>
</tr>
<tr>
<td style="text-align: left;">share_effect_time</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">C</td>
<td style="text-align: left;">异步分账有效时间(单位:天),share_type=”2”时必传,小于1取1,大于30取30,不传默认30</td>
<td style="text-align: left;">15</td>
</tr>
<tr>
<td style="text-align: left;">share_detail</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">C</td>
<td style="text-align: left;">分账详情,share_type=”1”时有效,json格式字符串,详细见“share_detail描述”</td>
<td style="text-align: left;">“{\”share_count\”:\”2\”,\”share_fee_mch\”:\”通道商户号1\”,\”share_array\”:[{\”share_mch\”:\”通道商户号2\”,\”share_amount\”:\”122\”},{\”share_mch\”:\”通道商户号3\”,\”share_amount\”:\”322\”}]}”</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">签名字符串</td>
<td style="text-align: left;">920ff5b412adb411c6648948f2212fb9</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 style="text-align: left;">示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">return_code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">响应码:SUCCESS成功,FAIL失败,响应码仅代表通信或参数</td>
<td style="text-align: left;">SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">result_code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">业务结果:PAY_SUCCESS 支付成功 ,PAY_IN_PROCESS 支付中 ,PAY_FAIL 支付失败,只有在return_code为SUCCESS时才会返回。</td>
<td style="text-align: left;">PAY_SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">return_msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">返回信息提示,“支付成功”,“支付中”,“参数不合法” 等</td>
<td style="text-align: left;">支付成功</td>
</tr>
<tr>
<td style="text-align: left;">pay_type</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">支付类型:300支付宝,400微信,600云闪付</td>
<td style="text-align: left;">300</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">商户号</td>
<td style="text-align: left;">851811130002</td>
</tr>
<tr>
<td style="text-align: left;">mch_name</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">商户名称</td>
<td style="text-align: left;">小猫生活</td>
</tr>
<tr>
<td style="text-align: left;">shop_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">门店号</td>
<td style="text-align: left;">86000033007</td>
</tr>
<tr>
<td style="text-align: left;">shop_name</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">门店名称</td>
<td style="text-align: left;">小猫生活</td>
</tr>
<tr>
<td style="text-align: left;">pay_trace_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">支付请求流水号(必须在商户系统内唯一)</td>
<td style="text-align: left;">51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">pay_time</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">请求交易时间,格式yyyyMMddHHmmss</td>
<td style="text-align: left;">20181116155621</td>
</tr>
<tr>
<td style="text-align: left;">total_amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">支付金额,单位:分</td>
<td style="text-align: left;">100</td>
</tr>
<tr>
<td style="text-align: left;">trade_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">订单号</td>
<td style="text-align: left;">20000002814118090716435200001</td>
</tr>
<tr>
<td style="text-align: left;">qrcode</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">二维码地址</td>
<td style="text-align: left;"><a href="https://qr.alipay.com/bax07160g89r6xbvnkz05588">https://qr.alipay.com/bax07160g89r6xbvnkz05588</a></td>
</tr>
<tr>
<td style="text-align: left;">attach</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">自定义参数,原样返回</td>
<td style="text-align: left;">1234</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">签名</td>
<td style="text-align: left;">336437c53711dd466154c4162cbe1c52</td>
</tr>
</tbody>
</table>
<p><strong>支付宝示例——请求参数</strong></p>
<pre><code> {
&quot;inst_no&quot;: 60000001,
&quot;mch_no&quot;: &quot;Y52212200002&quot;,
&quot;pay_type&quot;: &quot;300&quot;,
&quot;pay_trace_no&quot;: &quot;1903267777555544433001&quot;,
&quot;pay_time&quot;: &quot;20230410085837&quot;,
&quot;total_amount&quot;: &quot;1&quot;,
&quot;notify_url&quot;: &quot;http://xipay.xiangma365.com/api/openpay/common/test/notify&quot;,
&quot;attach&quot;: &quot;二维码支付&quot;,
&quot;sign&quot;: &quot;9fbf36bd6d69e5844fda3a984f2f0ec4&quot;
}</code></pre>
<p><strong>支付宝示例——响应参数</strong></p>
<pre><code>{
&quot;return_code&quot;: &quot;SUCCESS&quot;,
&quot;return_msg&quot;: &quot;下单成功&quot;,
&quot;result_code&quot;: &quot;PAY_SUCCESS&quot;,
&quot;pay_type&quot;: &quot;300&quot;,
&quot;mch_name&quot;: &quot;佛山市创造者网络科技有限公司20&quot;,
&quot;shop_name&quot;: &quot;&quot;,
&quot;mch_no&quot;: &quot;Y52212200002&quot;,
&quot;shop_no&quot;: &quot;&quot;,
&quot;pay_trace_no&quot;: &quot;1903267777555544433001&quot;,
&quot;pay_time&quot;: &quot;20230410085837&quot;,
&quot;total_amount&quot;: &quot;1&quot;,
&quot;qrcode&quot;: &quot;https://qr.alipay.com/bax07160g89r6xbvnkz05588&quot;,
&quot;trade_no&quot;: &quot;200001104IF3223041008585710001&quot;,
&quot;attach&quot;: &quot;二维码支付&quot;,
&quot;sign&quot;: &quot;4376bd83823de4795853db7d1b6ff429&quot;
}</code></pre>
<p><strong>微信示例——请求参数</strong></p>
<pre><code>{
&quot;inst_no&quot;: 60000001,
&quot;mch_no&quot;: &quot;851808290003&quot;,
&quot;pay_type&quot;: &quot;300&quot;,
&quot;pay_trace_no&quot;: &quot;113332313422343002&quot;,
&quot;pay_time&quot;: &quot;20480776150904&quot;,
&quot;total_amount&quot;: &quot;2&quot;,
&quot;order_body&quot;: &quot;测试&quot;,
&quot;attach&quot;: &quot;888&quot;,
&quot;sign&quot;: &quot;6e461f5c95c055b3aed017b8fcb8a1a9&quot;
}</code></pre>
<p><strong>微信示例——响应参数</strong></p>
<pre><code>{
&quot;return_code&quot;:&quot;SUCCESS&quot;,
&quot;return_msg&quot;:&quot;下单成功&quot;,
&quot;result_code&quot;:&quot;PAY_SUCCESS&quot;,
&quot;pay_type&quot;:&quot;400&quot;,
&quot;mch_name&quot;:&quot;小白盒周康宝岛牛肉饭&quot;,
&quot;shop_name&quot;:&quot;&quot;,
&quot;mch_no&quot;:&quot;851808290003&quot;,
&quot;shop_no&quot;:&quot;&quot;,
&quot;pay_trace_no&quot;:&quot;113332313422343002&quot;,
&quot;pay_time&quot;:&quot;20480776150904&quot;,
&quot;total_amount&quot;:&quot;2&quot;,
&quot;qrcode&quot;:&quot;weixin://wxpay/bizpayurl?pr=euHwoZ6&quot;,
&quot;trade_no&quot;:&quot;20000002824118090717365400002&quot;,
&quot;attach&quot;:&quot;888&quot;,
&quot;sign&quot;:&quot;d1119b3992bf63351f111b707c4bca5c&quot;
}</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 style="text-align: left;">示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">return_code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">响应码:SUCCESS成功,FAIL失败,响应码仅代表通信或参数</td>
<td style="text-align: left;">SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">result_code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">业务结果:PAY_SUCCESS 支付成功 ,PAY_IN_PROCESS 支付中 ,PAY_FAIL 支付失败,只有在return_code为SUCCESS时才会返回。</td>
<td style="text-align: left;">PAY_SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">return_msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">返回信息提示,“支付成功”,“支付中”,“参数不合法” 等</td>
<td style="text-align: left;">支付成功</td>
</tr>
<tr>
<td style="text-align: left;">pay_type</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">支付类型:300支付宝,400微信,600云闪付</td>
<td style="text-align: left;">300</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">商户号</td>
<td style="text-align: left;">851811130002</td>
</tr>
<tr>
<td style="text-align: left;">mch_name</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">商户名称</td>
<td style="text-align: left;">小猫生活</td>
</tr>
<tr>
<td style="text-align: left;">shop_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">门店号</td>
<td style="text-align: left;">86000033007</td>
</tr>
<tr>
<td style="text-align: left;">shop_name</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">门店名称</td>
<td style="text-align: left;">小猫生活</td>
</tr>
<tr>
<td style="text-align: left;">pay_trace_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">支付请求流水号(必须在商户系统内唯一)</td>
<td style="text-align: left;">51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">pay_time</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">请求交易时间,格式yyyyMMddHHmmss</td>
<td style="text-align: left;">20181116155621</td>
</tr>
<tr>
<td style="text-align: left;">total_amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">支付金额,单位:分</td>
<td style="text-align: left;">100</td>
</tr>
<tr>
<td style="text-align: left;">trade_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">订单号</td>
<td style="text-align: left;">20000002814118090716435200001</td>
</tr>
<tr>
<td style="text-align: left;">qrcode</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">二维码地址</td>
<td style="text-align: left;">weixin://wxpay/bizpayurl?pr=euHwoZ6</td>
</tr>
<tr>
<td style="text-align: left;">attach</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">自定义参数,原样返回</td>
<td style="text-align: left;">1234</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">签名</td>
<td style="text-align: left;">336437c53711dd466154c4162cbe1c52</td>
</tr>
</tbody>
</table>