H5拉起品牌会员入会组件
更新时间:2025.12.22||
品牌通过入会组件预授权接口获取授权的必要参数 token 后,可使用微信支付侧提供的 JS 调起品牌会员入会组件,引导用户完成入会流程(公众号端)。
接口说明
字段说明
请求参数
businessType 必填 string(32)
【跳转类型】固定值,请传入 wxpayCardMember
queryString 必填 string(2048)
【业务参数】需要传递给入会组件的数据。使用 URL 的 query string 方式传递参数,格式为key=value&key2=value2,其中 value、value2 需要进行 UrlEncode 处理。
 | 属性 |
| token 必填 string(32) 【预授权 token】调用品牌预授权接口返回的预授权 token (1 小时内有效)。
scene 必填 string(32) 【组件场景值】组件的应用场景值,固定为 CARD_MEMBER |
请求示例

1let wechatInfo = navigator.userAgent.match(/MicroMessenger\/([\d\.]+)/i);
2let wechatVersion = wechatInfo[1];
3
4if (compareVersion(wechatVersion, '7.0.5') >= 0) {
5 goToWXCardMember();
6} else {
7
8 window.location.href = 'https://support.weixin.qq.com/cgi-bin/readtemplate?t=page/common_page__upgrade&text=text005&btn_text=btn_text_0';
9}
10
11
12
13
14function goToWXCardMember() {
15 wx.checkJsApi({
16 jsApiList: ['openBusinessView'],
17 success: function (res) {
18
19
20 if (res.checkResult.openBusinessView) {
21 wx.invoke(
22 'openBusinessView', {
23 businessType: 'wxpayCardMember',
24 queryString: 'token=EhhEF0Jt0uDLPK6Cr70KCrJmkTtfPPE2&scene=CARD_MEMBER',
25 },
26 function (res) {
27
28 if (parseInt(res.extraData.errcode) === 0) {
29
30 } else {
31
32 }
33 });
34 }
35 }
36 });
37 }
38
39
40
41
42
43
44function compareVersion(v1, v2) {
45 v1 = v1.split('.')
46 v2 = v2.split('.')
47 const len = Math.max(v1.length, v2.length)
48
49 while (v1.length < len) {
50 v1.push('0')
51 }
52 while (v2.length < len) {
53 v2.push('0')
54 }
55
56 for (let i = 0; i < len; i++) {
57 const num1 = parseInt(v1[i])
58 const num2 = parseInt(v2[i])
59
60 if (num1 > num2) {
61 return 1
62 } else if (num1 < num2) {
63 return -1
64 }
65 }
66
67 return 0
68 }返回参数
触发场景: 用户从品牌会员入会组件页返回到品牌页面。
 | 属性 |
| errcode 必填 number/string(32) 【错误码】由于 iOS 和 Android 实现的差异,errcode 类型可能为 number 或 string
msg 必填 string(256) 【状态描述】状态描述
data 选填 Object 【详细信息】详细信息  | 属性 | | hasJoinCardMember 必填 boolean 【用户是否入会成功】表示用户入会是否成功 |
|