小程序拉起品牌会员入会组件

更新时间：2025.06.22

品牌通过品牌预授权接口获取授权的必要参数token后，可在小程序内使用微信支付提供的小程序方法调起品牌会员入会组件，引导用户完成入会流程。

接口说明

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

兼容性表现说明

小程序版本库 >= 2.28.1 为最佳体验；最低版本为 2.6.0，低版本无法打开组件，需提示用户升级微信版本。
iOS 兼容性表现：若微信版本>=7.0.3，开发者可以通过此 openSDK 接口拉起品牌会员入会组件；若微信版本 < 7.0.3，需提示用户升级微信版本。
Android 兼容性表现：若微信版本>=7.0.3，开发者可以通过此 openSDK 接口拉起品牌会员入会组件；若微信版本 < 7.0.3，需提示用户升级微信版本。

接口名称: wx.openBusinessView

字段说明

请求参数

businessType 必填 string(32)

【跳转类型】固定值，请传入 wxpayCardMember

queryString 必填 string(2048)

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

属性

success 选填 Function

【调用成功的回调函数】接口调用成功的回调函数

fail 选填 Function

【调用失败的回调函数】接口调用失败的回调函数

complete 选填 Function

【调用结束的回调函数】接口调用结束的回调函数（调用成功、失败都会执行）

wx.openBusinessView 请求示例

1if (wx.openBusinessView) {
2  wx.openBusinessView({
3    businessType: 'wxpayCardMember',
4    queryString: 'token=EhhEF0Jt0uDLPK6Cr70KCrJmkTtfPPE2',
5    success() {
6      // dosomething
7    },
8    fail() {
9      // dosomething
10    },
11    complete(e) {
12	  console.log('openBusinessView complete', `回调：${e.extraData}`);
13    }
14  });
15} else {
16  // 引导用户升级微信版本
17}

返回参数

触发场景: 用户从品牌会员入会组件页返回到品牌小程序页面。

回调方法:

请求参数中的 complete 回调函数中可获取到数据
品牌小程序可在 App.onShow 中获取到数据，具体参考框架接口-小程序App

注意：

前端回调参数无法判断用户是否授权成功，具体状态需以查询用户会员卡信息和会员卡事件通知返回的结果为准。
只有用户点击入会组件页面内返回按钮时，才会带上返回参数；如果用户点击小程序页面左上角的返回图标按钮，或左滑退出则不会带上返回参数。

extraData 必填 Object

【业务参数】回传商家小程序的业务数据

属性

返回品牌侧小程序请求示例

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

文档是否有帮助

更多支持

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