JSAPI调起支付分-确认订单

更新时间：2024.11.18

简介

商户通过调用确认订单接口打开微信支付分小程序，引导用户确认订单（Web端）

接口名称： openBusinessView

接口兼容：此接口引用 JSAPI版本1.5.0，引用地址：https://res.wx.qq.com/open/js/jweixin-1.5.0.js 。

支持商户：【普通服务商】

接口参数

Object

businessType 必填 string(16)

【跳转类型】
固定配置：wxpayScoreDetail。

queryString 必填 string(2048)

【业务参数】
使用URL的query string方式传递参数，格式为key=value&key2=value2，其中value，value2需要进行UrlEncode处理。

属性

package 必填 string(1024)

【扩展字符串】
可在【创建支付分订单】接口的返回字段package中获取。

返回参数

Object

err_code 必填 string(32)

【返回码】
返回码，由于iOS和Android实现的差异，err_code类型可能为Number或string，所以在判断支付分是否成功返回商户的H5时，需要对err_code做整型化处理。

err_msg 必填 string(128)

【返回信息】
返回信息

extraData 选填 Object

【业务参数】
当err_code为0时，extraData才返回；反之，则不返回。

属性

query_id 必填 string(64)

【单据查询ID】
单据查询ID，对应【查询支付分订单】接口中入参query_id。

appid 必填 string(32)

【应用ID】
支付分公众账号ID。

注意

只有用户点支付分页面内返回按钮时，才会带上返回参数；如果用户左滑返回或者点击页面左上角的返回图标返回，则不会带上返回参数。所以推荐在【查询支付分订单】接口使用out_order_no作为入参。另外商户侧后台在创建支付分订单时需向前端返回out_order_no，同时前端需缓存out_order_no，以便在接口回调中查询订单状态。

query示例

1package=XXXXXXXX

示例代码

1let wechatInfo = navigator.userAgent.match(/MicroMessenger\/([\d\.]+)/i);
2let wechatVersion = wechatInfo[1];
3
4if (compareVersion(wechatVersion, '7.0.5') >= 0) {
5   goToWXScore();
6} else {
7   // 提示用户升级微信客户端版本
8   window.href = 'https://support.weixin.qq.com/cgi-bin/readtemplate?t=page/common_page__upgrade&
9   text=text005&btn_text=btn_text_0'
10}
11
12/**
13 * 跳转微信支付分
14 */
15function goToWXScore() {
16    wx.checkJsApi({
17        jsApiList: ['openBusinessView'], // 需要检测的JS接口列表
18        success: function (res) {
19        // 以键值对的形式返回，可用的api值true，不可用为false
20        // 如：{"checkResult":{"openBusinessView":true},"errMsg":"checkJsApi:ok"}
21        if (res.checkResult.openBusinessView) {
22            wx.invoke(
23                'openBusinessView', {
24                    businessType: 'wxpayScoreUse',
25                    queryString: 'package=xxxxx'
26                },
27                function (res) {
28                // 从支付分返回时会执行这个回调函数
29                    if (parseint(res.err_code) === 0) {
30                    // 返回成功 
31                    } else {
32                    // 返回失败
33                    }
34                });
35            }
36        }
37    });
38 }
39
40 /**
41  * 版本号比较
42  * @param {string
43} v1 
44  * @param {string
45} v2 
46  */
47function compareVersion(v1, v2) {
48    v1 = v1.split('.')
49    v2 = v2.split('.')
50    const len = Math.max(v1.length, v2.length)
51  
52    while (v1.length < len) {
53      v1.push('0')
54    }
55    while (v2.length < len) {
56      v2.push('0')
57    }
58  
59    for (let i = 0; i < len; i++) {
60      const num1 = parseint(v1[i])
61      const num2 = parseint(v2[i])
62  
63      if (num1 > num2) {
64        return 1
65      } else if (num1 < num2) {
66        return -1
67      }
68    }
69    return 0
70 }

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服