wx.openBusinessView

更新时间：2024.10.15

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

# 接口说明

支持商户： 【普通商户】

商户小程序跳转微信侧小程序建议使用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)

固定值，请传入wxpayScoreEnable

extraData 必填 Object

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

属性

wx.openBusinessView 请求示例

1if (wx.openBusinessView) {
2  wx.openBusinessView({
3    businessType: 'wxpayScoreUse',
4    extraData: {
5      package: 'apply_permissions_token=AAQTnZoAAAABAAAAAAA-82Zwq2wMeohrOrWEZiAAAABcwQVtru-5k9MmEOZJ_Pv_Nq7Cw56dNKKN5EjZKnt5jf2ELJMexxwojyqA5EXan-WSwpRhLgBZYm-e9iZ7nLLhTzJLT4qakuzmTPoY64kYxO-8G7Frx8D3sScFf7QOZt8ZMnyXGF-jHx6TMjlGdWti6K0jqAYp_CyALFJxBrEbOvLlJ_vdllvc33W5XV8'
6    },
7    success() {
8      //dosomething
9    },
10    fail() {
11      //dosomething
12    },
13    complete() {
14      //dosomething
15    }
16  });
17} else {
18  //引导用户升级微信版本
19}

# 返回商户小程序

触发场景: 用户从支付分小程序授权页返回到商户小程序页面。

回调方法: App.onShow，具体参考框架接口-小程序App (opens new window)

提示

前端回调参数无法判断用户是否授权成功，具体状态需以查询授权和授权成功回调接口返回的结果为准。

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

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(固定wxd8f3793ea3b935b8)，建议检查是否等于来源appId(等于时代表从支付分小程序返回)，不强制
6      let result = this.queryAuthorizationStatus(authorization_code);
7      if (result) {
8        // 成功
9      } else {
10        // 失败
11      }
12    }
13  }
14}
15
16/**
17 * 查询用户授权状态函数
18 * 由商家后台服务提供
19 * @param authorization_code {string
20} 授权协议号，商户预授权时生成的授权单号，拉起授权前商户前端保存，用于后续查询授权结果
21 */
22queryAuthorizationStatus: function(authorization_code) {
23  // 商家小程序向商家后台服务请求查询用户授权状态，
24  // 这里的前后端接口和数据协议由商家侧设计
25  // 函数返回查询结果，这里以布尔值true代表成功，布尔值false代表失败
26}

文档是否有帮助

服务商文档

微信支付分参考文档

更多支持

开发者社区微信开放平台微信公众平台腾讯客服

wx.openBusinessView

# 接口说明

# 字段说明

# 请求参数

# 返回商户小程序

关于我们

服务支持

友情链接

客服帮助