小程序拉起开卡组件

更新时间：2024.10.29

商家可以在小程序内拉起开卡组件，从而实现投放会员卡。无须提前将会员组件和商家小程序绑定至同一个公众号。

wx.navigateToMiniProgram

接口名称： wx.navigateToMiniProgram，详见小程序API文档

接口参数

Object object

appId 必填 string(32)

【开卡组件AppID】开卡组件AppID，固定配置：wxeb490c6f9b154ef9。

path 必填 string(64)

【开卡组件路径】固定配置：pages/card_open/card_open

extraData 必填 Object

【业务参数】

属性

create_card_appid 必填 string(32)

【商户AppID】商户的公众号AppID。
1、只能为服务号AppID，不支持App、小程序、订阅号的AppID。
2、该AppID用于获取会员OpenID及unionid。
3、会员相关（会员状态、权益、服务）消息将通过该服务号触达用户
4、该AppID需要与会员卡归属品牌有B-A关系

card_id 必填 string(32)

【会员卡ID】商户创建微信会员卡模板成功后系统返回的会员卡模板ID

card_code 选填 string(32)

【会员卡code】实时code传入模式填写此字段

outer_str 选填 string(128)

【自定义场景值】自定义场景值，商户可以用于标记投放场景，如门店／来源等。只能录入数字及中英文／半角标点
匹配正则表达式: ^[0-9a-zA-Z\u0000-\u00FF\u4e00-\u9fa5]+$

activate_type 必填 string(32)

【激活类型】激活类型
ACTIVATE_TYPE_NORMAL：一键激活
ACTIVATE_TYPE_JUMP：跳转激活

jump_url 选填 string(128)

【跳转激活的URL】用户开卡时，跳转到URL指定的页面。如果同时配置了URL和AppID/PATH，则优先跳转到小程序

jump_appid 选填 string(32)

【跳转激活的AppID】用户开卡时，跳转到小程序指定页面。如果同时配置了URL和AppID/PATH，则优先跳转到小程序

jump_path 选填 string(128)

【跳转激活的path】用户开卡时，跳转到小程序指定页面。如果同时配置了URL和AppID/PATH，则优先跳转到小程序

success 选填 Function

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

fail 选填 Function

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

complete 选填 Function

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

示例代码

1wx.navigateToMiniProgram({
2appId: 'wxeb490c6f9b154ef9', //固定为此 appId，不可改动
3path: 'pages/card_open/card_open',//固定为此path
4envVersion: 'release',//商家正式版小程序拉起正式版组件；若此时为商家体验版小程序拉起体验版组件，则envVersion传值trial（体验版拉起，需找微信支付产品单独开权限）
5extraData: {
6create_card_appid:"wxeb490c6f9bxxxxxx",
7card_id: "pbLatjrJPKXqCExjWV2An-su2dlE",   
8outer_str: "123",
9activate_type: "ACTIVATE_TYPE_JUMP",// 指定跳转激活
10jump_url: "https://www.qq.com"//跳转路径
11},  
12success: function() {
13},
14fail: function() {
15},
16complete: function() {
17}
18})

文档是否有帮助

更多支持

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