小程序卡券事件自动推送

目录小程序领取优惠券场景

商户在小程序中开展营销活动时，可以向用户发放卡券作为奖品和优惠券兑换券。 用户收到卡包后，可快速出示使用，核对后核销。

同时，一些票务小程序还可以将用户购买的门票添加到卡包中供用户出示和使用。

步骤 开发者必须拥有具有优惠券权限的公众号和经过认证的小程序账号； 开发者须申请开放平台账号，并将小程序与公众号绑定在同一个开放平台账号下。 开放平台介绍请参考：微信开放平台； 、用户收到的代码，以及； 处理领取优惠券事件，记录用户公众号，以及用户收到的code。 接口说明

wx。 接口请参考：wx.

注意事项 wx. 接口中涉及到的签名必须传入，创建所获得的卡券的公众号； 用户收到优惠券后，会向开发者服务器推送领取优惠券事件，需要开发者处理。 详情请参阅优惠券活动通知； 开发者可以判断用户优惠券的来源； 该功能仅支持基础库版本1.1。优惠券场景介绍请在小程序中查看

开发者可以调用该接口，让用户在小程序中查看并展示自己的微信优惠券。

步

1、开发者必须获取用户进入小程序时收到的优惠券和代码（实码）； 2. 调用wx. 开通用户的某张优惠券供用户查看和使用。

接口说明

wx。 接口请参考：wx.

注意事项 目前，收到卡券后会自动返回小程序页面。 如果开发者在收到卡片后鼓励用户在卡片表面进行下一步，wx. 必须在wx的函数回调中调用； wx.之后返回的参数中的代码 是一个加密字段，在调用 wx. 之前必须对其进行解密。

开发者可以在小程序中开发自己的会员模块，并将开卡链接嵌入其中。 微信优惠券提供“开卡组件功能”，供会员在小程序中开卡。

当用户在小程序中输入开卡组件时，可以快速拉取用户开微信卡之前填写的信息并进行预填，用户可以实现“一键开卡”。

对于商户来说，开卡组件集成了“开卡注册”和“添加卡包”，可以在快速开卡的同时省去手机验证等环节，提高开卡率。

目前，卡牌激活组件分为跳跃式卡牌激活组件和非跳跃式卡牌激活组件。

注意：

公众号必须具备微信优惠券功能，才能调用小程序中的开卡组件。 详情请参考：微信优惠券说明。 开发者在调用之前首先要了解优惠券开发的基础知识。 详情请参考：微信优惠券接口说明。 步骤

跳跃式一键开卡步骤

创建一张会员卡会员卡，选择“”:true,“bmit”:true作为会员卡的激活方式，并在ass中传入激活小程序页面的相关信息，并获取。 详情参见：创建会员卡接口； 获取用户的卡信息并激活用户的会员卡；

具体流程如图所示：

无跳一键开卡步骤

创建一张会员卡会员卡，会员卡的激活方式选择“”：true，“bmit”：false，获取。 详情请参见：创建会员卡接口，设置用户开卡时填写的卡激活字段，分为必填字段和可选字段。 详情参见：设置卡激活字段接口，获取卡激活组件所需的参数； 确定是否调用新老用户的卡激活插件接口，以及客户端版本；

接口说明 接口1：获取卡激活插件参数

接口说明

开发者可以通过该接口获取调用开卡插件所需的参数。

请求参数说明

参数 参数说明

创建该卡公众号的token

JSON

请求数据

网址

{ "card_id" : "pbLatji6o5g7hJh8Otuvux4y1ty0", "outer_str" : "123" }

是否必填参数 参数说明

是的

会员卡

不

通道值，用于统计本次接收到的通道参数

{   "errcode": 0,   "errmsg": "ok",   "url": "https://mp.weixin.qq.com/bizmall/activatemembercard?    action=preshow&&enxxxxxxx=MjM5Mzc0OTEwMA%3D%3D#wechat_redirect" }

返回参数说明

参数 参数说明

错误代码

错误信息，用于定位错误原因

网址

返回的url包含调用开卡插件所需的参数

注1、该接口返回的参数必须完整填写在开卡插件接口中，并且必须执行操作；

接口2：在小程序中打开开卡插件的接口

接口说明

1、通过该接口，开发者可以在自己的小程序中打开开卡插件；

2、该界面为小程序界面。 开发者首先要了解小程序接口的调用方法：具体参见：优惠券事件通知；

3.基础库1.3.0开始支持，低版本需要兼容

4、iOS微信客户端6.5.9版本开始支持，客户端即将开始支持6.5.10版本，请先使用iOS客户端调试

打开同一个公众号关联的另一个小程序。

参数说明：

参数名称 类型 必填 描述

应用程序ID

是的

要打开的官方插件的appid是固定的，不能更改

不

需要传递给目标小程序的数据，目标小程序可以在App.()、App.()中获取这些数据。

不

接口调用成功的回调函数

失败

不

接口调用失败回调函数

不

接口调用结束的回调函数（调用会执行成功或失败）

返回参数说明：

参数名称 类型 描述 调用结果

示例代码：

wx.navigateToMiniProgram({   appId: ‘wxeb490c6f9b154ef9’, // 固定为此appid，不可改动   extraData: data, // 包括encrypt_card_id outer_str biz三个字段，须从step3中获得的链接中获取参数   success: function() {    },   fail: function() {   },   complete: function() {   } })

退货说明

判断App内会员卡开卡小程序返回的数据。

判断data..appId是否为开卡小程序appId''，如果不是，则停止判断是否有数据..是否有数据，如果没有，说明用户尚未激活，直接左滑/点击返回按钮返回，或者用户已激活。 如果用户激活成功，可以从data..中获取code参数进行下一步操作

Bug & ：在开发者工具上调用该API实际上不会跳转到另一个小程序，但开发者工具会验证调用跳转是否成功。 提示：开发者工具支持“重定向小程序处理接收到的参数”的调试

接口3：获取用户开卡时提交的信息（跳转式开卡组件）

接口说明

开发者可以通过该接口获取用户开卡时填写的字段值。

请求参数说明

参数 参数说明

创建该卡公众号的token

JSON

请求数据

网址

{     "activate_ticket" : "abcdefg"         }

是否必填参数 参数说明

是的

跳转式卡牌激活组件激活后回调中的激活票可用于获取用户的卡牌激活信息

{
     "errcode": 0,
     "errmsg": "ok",
     "info": {
         "common_field_list": [
             {
                 "name": "USER_FORM_INFO_FLAG_MOBILE",
                 "value": "15*****518"
             },
             {
                 "name": "USER_FORM_INFO_FLAG_NAME",
                 "value": "HK"
             },
             {
                 "name": "USER_FORM_INFO_FLAG_EDUCATION_BACKGROUND",
                 "value": "研究生"
             }
         ],
         "custom_field_list": []
     } 
}

返回参数说明

类型描述

参数名称

阐明

错误码，0为正常

错误信息

信息

会员信息

开发者设置的会员卡会员信息的类别，如兴趣爱好等。

姓名

会员信息类别名称

价值

会员卡信息类别值，如等级值等。

项目为多项选择时填写回车

项目为多项选择时填写回车

官方定义的信息类别

，允许开发者使用以下选项类型

参数说明

电话号码

性别

性别

姓名

姓名

生日

身份证

电子邮件

邮件

地址

教育背景

行业

收入

习惯

爱好

接口4：获取用户开卡时提交的信息（非跳卡开卡组件）

接口说明

开发者可以通过该接口获取用户开卡时填写的字段值。

请求参数说明

参数 参数说明

创建该卡公众号的token

JSON

请求数据

网址

{     "card_id" : "abcdefg",     "code" : "abcdefg"         }

是否必填参数 参数说明

不

优惠券id，非自定义code类型会员卡无需填写

代码

是的

会员卡代码

{
     "errcode": 0,
     "errmsg": "ok",
     "openid": "obLatjjwDxxxxdoGIdwNqRXw",
     "nickname": "Fourier",
     "membership_number": "316510891298",
     "bonus": 460,
     "sex": "MALE",
     "user_info": {
         "common_field_list": [
             {
                 "name": "USER_FORM_INFO_FLAG_MOBILE",
                 "value": "1552xxxx8888"
             },
             {
                 "name": "USER_FORM_INFO_FLAG_NAME",
                 "value": "微信"
             }
         ],
         "custom_field_list": []
     },
     "user_card_status": "NORMAL" 
}

参数名称 说明

错误码，0为正常

错误信息

用户在该公众号中的唯一识别码

用户昵称

奖金

积分信息

余额信息

性别

用户性别

会员信息

开发者设置的会员卡会员信息的类别，如兴趣爱好等。

官方定义的信息类别，例如积分。

姓名

会员信息类别名称

价值

会员卡信息类别值，如等级值等。

当前用户会员卡的状态，正常已过期、转账成功、转账已过期、超时已删除、已过期

，允许开发者使用以下选项类型

参数说明

电话号码

性别

性别

姓名

姓名

生日

身份证

电子邮件

邮件

地址

教育背景

行业

收入

习惯

爱好

接口5：激活用户收到的会员卡（跳跃式开卡组件）

接口说明

开发者可以通过该接口获取用户开卡时填写的字段值。

请求参数说明

参数 参数说明

创建该卡公众号的token

JSON

请求数据

网址

{
     "init_bonus": 100,
     "init_bonus_record":"旧积分同步",
     "init_balance": 200,
     "membership_number": "AAA00000001",
     "code": "12312313",
     "card_id": "xxxx_card_id",
     "background_pic_url": "https://mmbiz.qlogo.cn/mmbiz/0?wx_fmt=jpeg",
     "init_custom_field_value1": "xxxxx" 
}

参数是否必填 类型说明

是的

(20)

会员卡号由开发者填写，并以序列号的形式显示在用户的卡包中。 它可以保持与Code代码相同的值。

代码

是的

(20)

收到会员卡的用户获得的代码

不

(32)

需要优惠券ID、自定义代码优惠券

不

(128)

自定义会员卡背景图，商户必须先调用上传图片接口将背景图上传到CDN，否则会报错，卡面设计需遵循微信会员卡定制背景设计规范

不

整数

激活后的有效开始时间。 如果不填写，则以创建时的默认值为准。 Unix 时间戳格式。

不

整数

激活后有效失效时间。 如果不填写，则以创建时的默认值为准。 Unix 时间戳格式。

不

整数

初始分数，若不填则填0。

不

整数

初始余额，若不填则填0。

卢埃1

不

(12)

创建时字段定义类型的初始值，限制为4个汉字、12个字节。

卢埃2

不

(12)

创建时字段定义类型的初始值，限制为4个汉字、12个字节。

卢埃3

不

(12)

创建时字段定义类型的初始值，限制为4个汉字、12个字节。

返回数据

{
     "init_bonus": 100,
     "init_bonus_record":"旧积分同步",
     "init_balance": 200,
     "membership_number": "AAA00000001",
     "code": "12312313",
     "card_id": "xxxx_card_id",
     "background_pic_url": "https://mmbiz.qlogo.cn/mmbiz/0?wx_fmt=jpeg",
     "init_custom_field_value1": "xxxxx" 
}

参数名称 说明

错误码，0为正常

错误信息

注意

商户创建优惠券时，可以在卡或优惠券中设置服务入口，进入小程序服务。

步骤 开发者必须将小程序与公众号绑定。 绑定说明请参考创建优惠券，将卡片中的单元格设置为小程序对应的路径； 处理跳转到小程序时得到的信息； 接口说明

{ "card": {
     "card_type": "MEMBER_CARD",
     "member_card": {
         "base_info": {
             "custom_url_name": "立即使用",
             "custom_url": "http://www.qq.com",
             "custom_app_brand_user_name": "gh_86a091e50ad4@app",
             "custom_app_brand_pass":"API/cardPage",
             "custom_url_sub_title": "6个汉字tips",
             "promotion_url_name": "更多优惠",
           "promotion_url": "http://www.qq.com",
             "promotion_app_brand_user_name": "gh_86a091e50ad4@app",
             "promotion_app_brand_pass":"API/cardPage"
        }
         } 
}

字段名称 字段描述 字段示例

自定义入口跳转小程序的使用，格式为原来的id+@app

@应用程序

的s

自定义门户小程序的页面地址

应用程序接口/

小程序

@应用程序

的s

自定义居中使用页面地址

应用程序接口/

小程序

@应用程序

经过

自定义营销入口小程序的页面地址

应用程序接口/

小程序，

@应用程序

屁股

激活小程序页面地址

应用程序接口/

,

会员卡顶部的信息类别字段，包括以下两个字段

自定义信息类别小程序，格式为原始id+@app

@应用程序

自定义信息类别小程序的页面路径

应用程序接口/

,

会员卡自定义录入，包括以下两个字段

自定义入口小程序，格式为原始id+@app

@应用程序

自定义 页面路径

应用程序接口/

_姓名

积分信息类别对应的小程序，格式为原始id+@app

@应用程序

积分入口小程序的页面路径

应用程序接口/

余额信息类别对应的小程序，格式为原始id+@app

@应用程序

SS

余额录入小程序的页面路径

应用程序接口/

*需要调用卡券更新接口将对应的小程序页面更新为对应的跳转外链结构，保留原来的跳转H5字段。

从优惠券跳转到小程序后，开发者可以通过查询获取用户的公众号以及发起跳转的用户，开发者必须调用解码代码接口将其解码为真实的代码。

TAG标签：会员系统小程序