小程序支付接口
<p><strong>接口描述：</strong> </p>
<ul>
<li>用于微信、支付宝在小程序的环境下，唤起支付功能的支付场景</li>
</ul>
<p><strong>接口URL：</strong> </p>
<ul>
<li><code>https://open.51shoubei.com/openpay/v3/minipay</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>请求头部：</strong></p>
<table>
<thead>
<tr>
<th>标签</th>
<th>必填</th>
<th>内容</th>
</tr>
</thead>
<tbody>
<tr>
<td>Content-Type</td>
<td>是</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: center;">类型</th>
<th style="text-align: center;">必填</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: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">机构号 ，收呗分配</td>
<td>900024</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">商户号</td>
<td>851811130002</td>
</tr>
<tr>
<td style="text-align: left;">shop_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">否</td>
<td style="text-align: left;">门店号</td>
<td>86000033007</td>
</tr>
<tr>
<td style="text-align: left;">terminal_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">否</td>
<td style="text-align: left;">收呗终端号或设备SN</td>
<td>70020283</td>
</tr>
<tr>
<td style="text-align: left;">pay_type</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">支付类型：300支付宝，400微信，600云闪付，1200微企付</td>
<td>300</td>
</tr>
<tr>
<td style="text-align: left;">pay_trace_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">请求流水号（在商户系统内唯一）</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">pay_time</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</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: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">支付金额，单位：分</td>
<td>100</td>
</tr>
<tr>
<td style="text-align: left;">open_id</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">用户标识（微信openid/支付宝userid）</td>
<td>orxYXv8u8H4i2K0uB6RVXZ</td>
</tr>
<tr>
<td style="text-align: left;">appid</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">微信小程序的appid（此处取值优先于后台配置）</td>
<td>wxbca6c935a45dcdc5</td>
</tr>
<tr>
<td style="text-align: left;">order_body</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">订单描述</td>
<td>苹果笔记本</td>
</tr>
<tr>
<td style="text-align: left;">attach</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">自定义参数，原样返回</td>
<td>1234</td>
</tr>
<tr>
<td style="text-align: left;">notify_url</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">回调地址（以http或https开头的完整url地址）</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">food_order_type</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">点餐场景类型（针对小程序扫码点餐专用）</td>
<td>qr_order（店内扫码点餐），pre_order（预点到店自提），home_delivery （外送到家），direct_payment（直接付款），other（其他）</td>
</tr>
<tr>
<td style="text-align: left;">goods_detail</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">详情内容，json格式的字符串</td>
<td>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: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">分账类型：0.不分账，1.同步分账，2.异步分账，不传默认0</td>
<td>0</td>
</tr>
<tr>
<td style="text-align: left;">share_effect_time</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">异步分账有效时间（单位：天），share_type="2"时必传，小于1取1，大于30取30，不传默认30</td>
<td>15</td>
</tr>
<tr>
<td style="text-align: left;">share_detail</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">分账详情，share_type="1"时有效，json格式的字符串</td>
<td>"{\"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;">edu_school_id</td>
<td style="text-align: center;">string(30)</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">支付宝学校ID/校区ID(支付宝校园场景edu_school_id和edu_scene不能同时为空)</td>
<td>2088200341082590</td>
</tr>
<tr>
<td style="text-align: left;">edu_scene</td>
<td style="text-align: center;">string(30)</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">支付宝校园内服务场景(支付宝校园场景edu_school_id和edu_scene不能同时为空)</td>
<td>SCHOOL_CANTEEN</td>
</tr>
<tr>
<td style="text-align: left;">undiscount_amount</td>
<td style="text-align: center;">string(8)</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">不打折金额，单位：分（仅支付宝有效）</td>
<td>100</td>
</tr>
<tr>
<td style="text-align: left;">invoice_entry</td>
<td style="text-align: center;">string(256)</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">商户开发票链接</td>
<td>开发票连接地址</td>
</tr>
<tr>
<td style="text-align: left;">ali_product_code</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">直连通道支付宝产品码：JSAPI_PAY（小程序场景支付），不传默认为当面付</td>
<td>JSAPI_PAY</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">签名字符串,拼装所有值不为空（为null不参与，空字符串参与）</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
</tbody>
</table>
<p><strong>goods_detail描述</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;">goods_id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">商品编号</td>
<td>8005</td>
</tr>
<tr>
<td style="text-align: left;">goods_name</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">商品名称</td>
<td>苹果</td>
</tr>
<tr>
<td style="text-align: left;">goods_quantity</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">商品数量</td>
<td>1</td>
</tr>
<tr>
<td style="text-align: left;">goods_price</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">商品单价，单位：分</td>
<td>100</td>
</tr>
</tbody>
</table>
<p><strong>share_detail描述</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;">share_count</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">分账条目数</td>
<td>2</td>
</tr>
<tr>
<td style="text-align: left;">share_fee_mch</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">承担手续费的通道商户号</td>
<td>11111</td>
</tr>
<tr>
<td style="text-align: left;">share_fee_sb_mch</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">承担手续费的收呗商户号 （与手续费承担通道商户号二选一）（仅部分通道支持收呗商户号，具体请咨询收呗运营及技术）</td>
<td>8600112266</td>
</tr>
<tr>
<td style="text-align: left;">share_array</td>
<td style="text-align: left;">JSONArray</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">分账数组，json数组</td>
<td>[\”share_mch\”:\”通道商户号2\”,\”share_amount\”:\”122\”},{\”share_mch\”:\”通道商户号3\”,\”share_amount\”:\”322\”}]</td>
</tr>
</tbody>
</table>
<p><strong>share_array描述</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;">share_mch</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">通道商户号</td>
<td>22222</td>
</tr>
<tr>
<td style="text-align: left;">share_sb_mch</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">收呗商户号(与通道商户号二选一) （仅部分通道支持收呗商户号，具体请咨询收呗运营及技术）</td>
<td>8600112266</td>
</tr>
<tr>
<td style="text-align: left;">share_amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">分账金额，单位：分</td>
<td>122</td>
</tr>
</tbody>
</table>
<p><code>备注：</code> sign 字段传递参数按照字典序用&符号连接最后拼接机构key，UTF-8编码，32位md5加密转换， 示例：a=1&b=1&c=1&d=1&key=51c7d68424e5492199cf7f4734a2b977，详细见 [接入指引](<a href="https://www.showdoc.cc/shoubei?page_id=2361130764227691">https://www.showdoc.cc/shoubei?page_id=2361130764227691</a> "接入指引")</p>
<p><strong>请求示例：</strong></p>
<pre><code class="language-json">{
&quot;inst_no&quot;: 60000001,
&quot;mch_no&quot;: &quot;851808290003&quot;,
&quot;pay_type&quot;: &quot;400&quot;,
&quot;pay_trace_no&quot;: &quot;113332313422343002&quot;,
&quot;pay_time&quot;: &quot;20480776150904&quot;,
&quot;total_amount&quot;: &quot;2&quot;,
&quot;openid&quot;: &quot;afcdasdasdasd3213dxdasdad&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>
<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</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</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</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;">mch_no</td>
<td style="text-align: left;">string</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</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</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</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">门店名称</td>
<td>1号店</td>
</tr>
<tr>
<td style="text-align: left;">pay_type</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">支付类型：300支付宝，400微信，600云闪付</td>
<td>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;">是</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</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</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">支付金额，单位：分</td>
<td>100</td>
</tr>
<tr>
<td style="text-align: left;">trade_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">收呗订单号</td>
<td>20000002814118090716435200001</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>1234</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">微信小程序支付返回字段，小程序appId</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">timeStamp</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">微信小程序支付返回字段，时间戳，部分系统取到的值为毫秒级，需要转换成秒(10位数字)。</td>
<td>1414561699</td>
</tr>
<tr>
<td style="text-align: left;">nonceStr</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">微信小程序支付返回字段，随机字符串</td>
<td>1234</td>
</tr>
<tr>
<td style="text-align: left;">packages</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">微信小程序支付返回字段，订单详情扩展字符串，统一下单接口返回的prepay_id参数值，提交格式：prepay_id=</td>
<td>prepay_id=123456789</td>
</tr>
<tr>
<td style="text-align: left;">signType</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">微信小程序支付返回字段，签名方式</td>
<td>MD5,RSA</td>
</tr>
<tr>
<td style="text-align: left;">paySign</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">微信小程序支付返回字段，签名</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">wqf_version</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">微企付小程序版本</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">wqf_user_name</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">微企付小程序用户名</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">code_url</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">直接跳转的支付url</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">ali_trade_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">支付宝小程序支付返回字段用于调起支付宝小程序支付控件</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">签名字符串，拼装所有传递参数，UTF-8编码，32位md5加密转换签名字符串</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<p>成功返回内容：无</p>