小程序下单
<p><strong>使用场景:</strong> </p>
<ul>
<li>用户在自己订单系统下单,获取了订单信息后,将相关参数传入通企付小程序,通企付小程序负责渠道下单支付,并返回结果。</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;">mchNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户号</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>应用ID</td>
</tr>
<tr>
<td style="text-align: left;">reqTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>请求时间,13位时间戳</td>
</tr>
<tr>
<td style="text-align: left;">version</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>版本(默认为1.0)</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>签名</td>
</tr>
<tr>
<td style="text-align: left;">signType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>签名类型(MD5/RSA/SM2)</td>
</tr>
<tr>
<td style="text-align: left;">mchOrderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户订单号</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>金额(单位:分)</td>
</tr>
<tr>
<td style="text-align: left;">body</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商品描述</td>
</tr>
<tr>
<td style="text-align: left;">orgId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>服务商id,用于服务商代发起交易</td>
</tr>
<tr>
<td style="text-align: left;">goodsInfo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>商品备注,为List<goodsInfo>的JSON字符串,使用B2B订单支付时必填</td>
</tr>
<tr>
<td style="text-align: left;">notifyUrl</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>通知地址</td>
</tr>
<tr>
<td style="text-align: left;">expiredTime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>订单失效时间,单位秒,默认1小时.订单在(创建时 间+失效时间)后失效</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>订单备注</td>
</tr>
<tr>
<td style="text-align: left;">channelExtra</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>渠道参数,JSON字符串,特定渠道发起的额外参数,例:收银宝子商户号cusid,集团商户号orgid,微信appid即subAppid</td>
</tr>
<tr>
<td style="text-align: left;">payTypeInfo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>收银台展示的付款方式,以逗号(,)隔开;<strong>注释</strong>:WX_PAY(微信),ALI_PAY(支付宝),C_PAY(个人银行卡),B_PAY(企业网银),LOAN_PAY(信用支付);</td>
</tr>
<tr>
<td style="text-align: left;">directPayType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>直接支付的支付方式(填入该参数则自动使用该支付方式下单并拉起支付,当前支持WX_LITE:微信小程序支付;SFT_HRJ:通联汇入金;ALI_QR:支付宝支付;ALI_CREDIT:花呗分期;SYB_B2C_WECHAT:微信小程序收银台支付)</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">goodsInfo参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">goodsnm</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商品简称</td>
</tr>
<tr>
<td style="text-align: left;">goodsamt</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>商品金额(单位:元)</td>
</tr>
<tr>
<td style="text-align: left;">goodsnum</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>商品数量</td>
</tr>
</tbody>
</table>
<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;">code</td>
<td style="text-align: left;">string</td>
<td>success:支付成功;cancel:取消支付;fail:支付失败</td>
</tr>
<tr>
<td style="text-align: left;">errmsg</td>
<td style="text-align: left;">string</td>
<td>响应内容(当code为cancel、fail有值)</td>
</tr>
</tbody>
</table>
<p><strong>调用示例,示例仅展示部分字段,具体字段自行根据业务需求填写:</strong> </p>
<p>小程序收银台原始 ID:gh_4fa331e708fb
小程序收银台 appId:wxe48aedff31caaf2d</p>
<p>小程序调起收银台小程序:</p>
<pre><code> wx.openEmbeddedMiniProgram({
appId: &quot;wxe48aedff31caaf2d&quot;,
path:&quot;pages/index/index&quot;,
extraData:{
拼写请求参数
},
success: function (res) {
console.log(&quot;成功回调返回的res:&quot; + JSON.stringify(res))
},
fail: function (res) {
console.log(&quot;失败回调返回的res:&quot; + JSON.stringify(res))
},
complete: function () {
console.log(&quot;完成调用&quot;)
}
})</code></pre>
<p>通过上述方法会调起收银台半屏小程序,在收银台中完成支付后,会回调支付结果,具体结果可以在小程序生命周期Page.onShow中通过以下方式获取:</p>
<pre><code>onShow: function () {
let options = wx.getEnterOptionsSync();
if (options.scene == '1038' &amp;&amp;
options.referrerInfo.appId=='wxe48aedff31caaf2d') {
// 代表从收银台小程序返回
let extraData = options.referrerInfo.extraData;
if (!extraData) {
// &quot;当前通过物理按键返回,未接收到返参,建议自行查询交易结果&quot;;
} else {
if (extraData.code == 'success') {
// &quot;支付成功&quot;;
} else if (extraData.code == 'cancel') {
// &quot;支付已取消&quot;;
} else {
// &quot;支付失败:&quot; + extraData.errmsg;
}
}
}
},</code></pre>
<p><strong>APP调起小程序收银台</strong></p>
<p>Android开发示例:</p>
<p><a href="https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/Android_Development_example.html">https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/Android_Development_example.html</a></p>
<p>iOS开发示例:</p>
<p><a href="https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/iOS_Development_example.html">https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/iOS_Development_example.html</a></p>
<p>调起方式如上文档,这里展示部分字段,具体字段自行根据业务需求填写</p>
<p>path=pages/index/index?mchNo=平台分配的商户号&appId=平台分配的应用ID&reqTime=请求时间&version=1.0&sign=签名&signType=MD5&mchOrderNo=商户唯一订单号&amount=金额&expiredTime=失效时间&body=描述</p>
<p><strong>微信环境H5调起通企付小程序收银台</strong></p>
<p>微信环境前端h5拉起小程序的能力可以参考微信官方文档:
<a href="https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_Open_Tag.html">https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_Open_Tag.html</a>
JS-SDK引入的初始化步骤详见上诉文档,具体下单业务字段根据业务需求填写在extraData中</p>
<p>appId: "wxe48aedff31caaf2d",
path=pages/index/index;
<span style="color:red">//注意extraData字段为json字符串</span>
extraData={
下单参数
}</p>