wx.openBusinessView

更新时间：2024.11.14

商户通过创建支付分订单接口获取确认订单的必要参数package后可使用微信支付提供的小程序方法调起微信支付分小程序，引导用户确认订单（小程序端）

接口说明

支持商户：【普通商户】

商户小程序跳转微信侧小程序建议使用wx.openBusinessView的调用方式，不占用小程序跳转其他小程序的数量名额。

兼容性表现说明

小程序版本库 >= 2.6.0，低版本需提示用户升级微信版本。
iOS兼容性表现：若微信版本>=7.0.3，开发者可以通过此openSDK接口跳转到微信支付分小程序；若微信版本< 7.0.3，开发者通过此openSDK接口可以跳转到微信，但不能跳转到微信支付分小程序，此时微信会提示用户可能由于应用的请求非法或者微信版本过低。
Android兼容性表现：若微信版本>=7.0.3，开发者可以通过此openSDK接口跳转到微信支付分小程序；若微信版本< 7.0.3，开发者通过此openSDK接口不能跳转到微信，此时开发者应提示用户更新微信版本。

接口名称: wx.openBusinessView

字段说明

请求参数

businessType 必填 string(32)

固定值，请传入wxpayScoreUse

extraData 必填 Object

需要传递给支付分的业务数据。

属性

wx.openBusinessView 请求示例

1if (wx.openBusinessView) {
2  wx.openBusinessView({
3    businessType: 'wxpayScoreUse',
4    extraData: {
5      mch_id: '1230000109',
6      package: 'AAQTnZoAAAABAAAAAAD8m2b8VRdZ2kVdKmHNZiAAAABcwQVtru-5k9MmEOZJ_Pv_Nq7Cw56dNKKN5Ej3Knt5jTHF-NdsP_McFW-iaU3iuJ0gWlNQeG9UihoKi0k2pv1t71M6mpk15X6L1545yNpmPD5uhi3poFV8e_5EdYwi_cbc6tXYVfa0AJUO4OzHGPhMdT4ZMwmFFhD0HQi9mRHQhFRKPwFai4NkkW7vm9mv1test',
7      timestamp: '1530097563',
8      nonce_str: 'zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2',
9      sign_type: 'HMAC-SHA256',
10      sign: '029B52F67573D7E3BE74904BF9AEA'
11    },
12    success() {
13      //dosomething
14    },
15    fail() {
16      //dosomething
17    },
18    complete() {
19      //dosomething
20    }
21  });
22} else {
23  //引导用户升级微信版本
24}

返回参数

触发场景: 用户从商户小程序页面进入到支付分后再返回到商户小程序页面。

返回参数获取说明: 商户小程序可在 App.onLaunch，App.onShow 中获取到这份数据。

query_id 必填 string(64)

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

提示

带有返回参数不代表订单确认成功，具体状态需以查询支付分订单接口返回的结果为准；
只有用户点击支付分页面内返回按钮时，才会带上返回参数；如果用户点击小程序页面左上角的返回图标按钮，则不会带上返回参数。

返回商家侧小程序请求示例

1// app.js
2onShow(res) {
3  if (res.scene === 1038) { // 场景值1038：从被打开的小程序返回
4    const { appId, extraData } = res.referrerInfo;
5    if (appId === miniprogram_appid) { // miniprogram_appid由【创建订单】返回，建议检查是否等于appId，不强制
6      let query_id = extraData.query_id;
7      let result = this.queryOrderStatus(query_id);
8      if (result) {
9        // 成功
10      } else {
11        // 失败
12      }
13    }
14  }
15}
16
17/**
18 * 查询订单状态函数
19 * 由商家后台服务提供
20 * @param query_id {string
21} 单据id，可以在接口【查询订单】进行单据查询
22 */
23queryOrderStatus: function(query_id) {
24  // 商家小程序向商家后台服务请求查询订单状态，
25  // 这里的前后端接口和数据协议由商家侧设计
26  // 函数返回查询结果，这里以布尔值true代表成功，布尔值false代表失败
27}

文档是否有帮助

更多支持

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