- ·上一篇文章:微信卡券事件推送
- ·下一篇文章:微信平台会员卡专区(二)
微信平台会员卡专区(一)
卡激活后呈现的信息类目,目前支持积分、余额、等级、优惠券、里程、印花、成就、折扣等类型,微信6.2以上版本显示会员信息类目的上限为3个,即创建时类目字段supply_bonus 、supply_balance、 custom_field1、custom_field2 、custom_field3最多选择三项填写。3.创建卡券时,开发者填入的时间戳须注意时间戳溢出时间,设置的时间戳须早于2038年1月19日,若要设置更久的有效期,可以选择永久有效类型的有效期。4.2 获取会员卡审核结果 调用接口成功创建会员卡后,会由系统自动提交审核,审核结果将在三个工作日内以事件形式告知开发者,同时支持调用接口主动查询卡券状态。审核事件推送 生成的卡券通过审核时,微信会把这个事件推送到开发者填写的URL,详情见:审核事件推送,会员卡审核通过后可以正式投放会员卡。 4.3 设置测试白名单接口 若会员卡暂时未审核通,开发者可以将测试人员的微信号设置成白名单,领取未审核通过的卡券。白名单状态领取的卡信息不随卡券实时更新,请开发者注意。5 投放会员卡接口详情 目前微信会员卡支持通过扫描二维码、在网页直接点击(参考JS-SDK网页接口)、卡券货架、公众号群发以及公众号被动回复消息领取,开发者可以选择一种或者多种。请参考以下各种投放方式详情。特别注意1. 开发者调用接口投放的会员卡为无会员信息的“卡套”,会员卡编号、积分、余额等信息需在用户领取会员卡后调用激活/绑定会员卡接口更新上。2. 调用激活/绑定会员卡接口的凭证为Code码及card_id,开发者需在调用投放会员卡时通过接口或领取卡券事件记录code码与会员OpenID的关系。5.1 创建二维码接口 创建会员卡二维码,打印后置于店内,顾客扫码领取会员卡,扫描下方二维码体验领取,若已领取可扫码快速打开会员卡。接口详情见:创建二维码接口5.2 网页内单张/批量添加卡券接口 微信提供addCard接口供商户前端网页调用,用于将一张或多张卡券添加到用户卡包。详情见批量添加卡券接口 (微信扫一扫>微信卡券接口>addcard接口)5.3 通过卡券货架投放会员卡卡券货架简介 卡券货架支持开发者通过调用接口生成一个卡券领取H5页面,并获取页面链接,进行卡券投放动作。5.4 公众号消息投放会员卡 开发者也可以通过公众号群发消息或者客服消息为用户发送一张会员卡。5.5 记录用户领卡行为 用户领取会员卡后,微信会给开发者服务器推送领取会员卡事件通知,以便开发者记录用户OpenID与会员卡code的关联关系,并可以通过事件内的参数区分领取渠道(见1.5)。5.6 统计投放渠道数据 为方便开发者统计各渠道的卡券投放数据,新增字段outer_id。将不同设值的outer_id填入card_ext的JSON结构中,当用户领取卡券时会将相应设值的outer_id带入领取事件推送中,推送至开发者服务器。示例: 在二维码投放方式中设置outer_id为1{ "action_name": "QR_CARD", "action_info": { "card": { "card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc", "code": "198374613512", "openid": "oFS7Fjl0WsZ9AMZqrI80nbIq8xrA", "expire_seconds": 1800, "is_unique_code": false, "outer_id": 1 } }}领取事件XML文件<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <FriendUserName><![CDATA[FriendUser]]></FriendUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[user_get_card]]></Event> <CardId><![CDATA[cardid]]></CardId> <IsGiveByFriend>1</IsGiveByFriend> <UserCardCode><![CDATA[12312312]]></UserCardCode> <OuterId>1</OuterId></xml>6 激活会员卡 当用户领取会员卡“卡套”后,支持调用该接口对会员卡进行激活,并设置会员信息的初始值,如积分、余额、等级、会员卡编号等会员信息。目前,微信会员卡支持三种激活方式,分别是接口激活、一键激活和自动激活。开发者注意事项1.开发者可以根据业务场景需要选择合适的激活流程。三种激活流方法只能选择一种;2.激活会员卡需传入用户领取时获取的Code码,将该Code码对应设置会员卡编号membership_number。6.1 接口激活激活方式说明 接口激活通常需要开发者开发用户填写资料的网页。通常有两种激活流程: 1. 用户必须在填写资料后才能领卡,领卡后开发者调用激活接口为用户激活会员卡; 2. 是用户可以先领取会员卡,点击激活会员卡跳转至开发者设置的资料填写页面,填写完成后开发者调用激活接口为用户激活会员卡。接口详情接口调用请求说明HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/membercard/activate?access_token=TOKEN参数说明参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 JSON数据 { "init_bonus": 100, "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"}参数名 必填 类型 描述 membership_number 是 string(20) 会员卡编号,由开发者填入,作为序列号显示在用户的卡包里。可与Code码保持等值。 code 是 string(20) 创建会员卡时获取的初始code。 card_id否 string(32) 卡券ID,自定义code卡券必填background_pic_url 否 string(128) 商家自定义会员卡背景图,须 先调用上传图片接口将背景图上传至CDN,否则报错,卡面设计请遵循微信会员卡自定义背景设计规范 activate_begin_time 否 unsigned int 激活后的有效起始时间。若不填写默认以创建时的 data_info 为准。Unix时间戳格式。 activate_end_time 否 unsigned int 激活后的有效截至时间。若不填写默认以创建时的 data_info 为准。Unix时间戳格式。 init_bonus 否 int 初始积分,不填为0。 init_balance 否 int 初始余额,不填为0。 init_custom_field_value1 否 string(12) 创建时字段custom_field1定义类型的初始值,限制为4个汉字,12字节。 init_custom_field_value2 否 string(12) 创建时字段custom_field2定义类
微信平台会员卡专区(一)