JSAPI调起支付分-订单详情
更新时间:2023.08.23商户通过调用订单详情接口打开微信支付分小程序,引导用户查看订单详情(Web端)。
# 接口说明
适用对象: 【从业机构(支付机构)】
接口名称: openBusinessView
此接口引用 JSAPI版本1.5.0,引用地址:https://res.wx.qq.com/open/js/jweixin-1.5.0.js。 (opens new window)
要求用户微信版本>=7.0.5
在JSAPI调起支付分相关接口前,需详细阅读JS-SDK说明文档并进行相应配置。
JS-SDK配置为链接:https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JS-SDK.html (opens new window)
# 接口参数
# Object
- businessType 必填固定配置:wxpayScoreUse。
- queryString 必填使用URL的query string方式传递参数,格式为key=value&key2=value2,其中value,value2需要进行UrlEncode处理。
- 属性
请求示例
1let wechatInfo = navigator.userAgent.match(/MicroMessenger\/([\d\.]+)/i);2let wechatVersion = wechatInfo[1];34if (compareVersion(wechatVersion, '7.0.5') >= 0) {5 goToWXScore();6} else {7 // 提示用户升级微信客户端版本8 window.href = 'https://support.weixin.qq.com/cgi-bin/readtemplate?t=page/9 common_page__upgrade&text=text005&btn_text=btn_text_0'10}1112/**13 * 跳转微信支付分14 */15function goToWXScore() {16 wx.checkJsApi({17 jsApiList: ['openBusinessView'], // 需要检测的JS接口列表18 success: function (res) {19 // 以键值对的形式返回,可用的api值true,不可用为false20 // 如:{"checkResult":{"openBusinessView":true},"errMsg":"checkJsApi:ok"}21 if (res.checkResult.openBusinessView) {22 wx.invoke(23 'openBusinessView', {24 businessType: 'wxpayScoreEnable',25 queryString: 'DJIOSQPYWDxsjdldeuwhdodwxasd_dDiodnwjh9we'26 },27 function (res) {28 // 从微信侧小程序返回时会执行这个回调函数29 if (parseint(res.err_code) === 0) {30 // 返回成功 31 } else {32 // 返回失败33 }34 });35 }36 }37 });38 }3940 /**41 * 版本号比较42 * @param {string} v1 43 * @param {string} v2 44 */45function compareVersion(v1, v2) {46 v1 = v1.split('.')47 v2 = v2.split('.')48 const len = Math.max(v1.length, v2.length)49 50 while (v1.length < len) {51 v1.push('0')52 }53 while (v2.length < len) {54 v2.push('0')55 }56 57 for (let i = 0; i < len; i++) {58 const num1 = parseint(v1[i])59 const num2 = parseint(v2[i])60 61 if (num1 > num2) {62 return 163 } else if (num1 < num2) {64 return -165 }66 }67 68 return 069 }
# 返回参数
# Object res
- err_code 必填返回码,由于iOS和Android实现的差异,err_code类型可能为Number或string,所以在判断支付分是否成功返回商户的H5时,需要对err_code做整型化处理。
- err_msg 必填返回信息
- extraData 选填当err_code为0时,extraData才返回;反之,则不返回。
- 属性
注意
只有用户点支付分页面内返回按钮时,才会带上返回参数;如果用户左滑返回或者点击页面左上角的返回图标返回,则不会带上返回参数。所以推荐在查询订单接口使用 out_order_no 作为入参。另外商户侧后台在创建支付分订单时需向前端返回 out_order_no,同时前端需缓存out_order_no,以便在接口回调中查询订单状态。
返回示例
示例代码
文档是否有帮助