- ·上一篇文章:微信卡券事件推送
- ·下一篇文章:微信平台会员卡专区(二)
微信平台会员卡专区(一)
分等信息或者调用拉取会员信息接口获取会员信息。步骤五:拉取会员信息接口接口说明 支持开发者根据CardID和Code查询会员信息。接口调用请求说明HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/membercard/userinfo/get?access_token=TOKEN参数说明参数 是否必须 说明 POST数据 是 JSON数据 access_token 是 调用接口凭证 POST数据{ "card_id": "pbLatjtZ7v1BG_ZnTjbW85GYc_E8", "code": "916679873278"}返回数据{ "errcode": 0, "errmsg": "ok", "openid": "obLatjjwDolFj******wNqRXw", "nickname": "*******", "membership_number": "658*****445", "bonus": 995, "sex": "MALE", "user_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": [] }, "user_card_status": "NORMAL", "has_active": false}参数名 说明 errcode 错误码,0为正常 errmsg 错误信息 openid 用户在本公众号内唯一识别码 nickname 用户昵称 bonus 积分信息 balance 余额信息 sex 用户性别 user_info 会员信息 custom_field_list 开发者设置的会员卡会员信息类目,如等级。 name 会员信息类目名称 value 会员卡信息类目值,比如等级值等 user_card_status 当前用户的会员卡状态,NORMAL 正常 EXPIRE 已过期 GIFTING 转赠中 GIFT_SUCC 转赠成功 GIFT_TIMEOUT 转赠超时 DELETE 已删除,UNAVAILABLE 已失效 has_active该卡是否已经被激活,true表示已经被激活,false表示未被激活6.2.2 跳转型一键激活 跳转型一键激活支持用户在提交会员开卡资料后跳转至商户自定义的网页。不同于普通一键激活,跳转型一键激活的激活会员卡动作由商户完成,商户可以在跳转到的网页内做激活、激活奖励、开卡条件判断等逻辑,同时也保证了开卡的实时性,适合使用自定义卡号的商户使用。 步骤一:在创建/更新接口填入跳转型一键激活相关字段 若商户设置用户激活后跳转自己的网页,需要在创建或更新接口传入以下参数。{ "card": { "member_card": { ························ ························ "wx_activate": true, "wx_activate_after_submit" : true, //是否设置跳转型一键激活 "wx_activate_after_submit_url" : "http://qq.com" //用户提交信息后跳转的网页 } } }参数名 必填 类型 描述 member_card 是 JSON接口 会员卡结构体 wx_activate 否 bool 是否支持一键激活,填true或lse wx_activate_after_submit 否 bool 是否支持跳转型一键激活,填true或lse wx_activate_after_submit_url 否 bool 跳转型一键激活跳转的地址链接 步骤二:设置开卡字段接口 步骤三:获取用户提交资料 用户填写并提交开卡资料后,会跳转到商户的网页,商户可以在网页内获取用户已填写的信息并进行开卡资质判断,信息确认等动作。具体方式如下: 用户点击提交后,微信会在商户的url后面拼接获取用户填写信息的参数:activate_ticket、openid、card_id和加密code-encrypt_code,如商户填写的wx_activate_after_submit_url为 www.qq.com,则拼接后的url为www.qq.com&card_id=pbLatjvFdsLDUMoN8JqcsGeiMHKk&encrypt_code=Bupk8bb9xxxxxx3rdXV6fClBVtkHQplYohdzGvgDl4%3D&outer_str=&openid=obLatjjwDxxxxxxxoGIdwNqRXw&activate_ticket=fDZv9eMQAFfrNr3XBoqhb%2F%2BMSDM0yjDF6CdiUhC%2BOlEaxb0clsUxxxxxxxxxxxd6yQsjRMRu4kAcKTibYLN5tmHBdll1b6zQRsLF53MpKjGU%3D。 开发者可以根据activate_ticket获取到用户填写的信息,用于开发者页面的逻辑判断。 接口说明 支持开发者根据activate_ticket获取到用户填写的信息。接口调用请求说明HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/membercard/activatetempinfo/get?access_token=TOKEN参数说明参数 是否必须 说明 POST数据 是 JSON数据 access_token 是 调用接口凭证 POST数据 { "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": [] }} 步骤四:调用接口激活会员卡 开发者可以在接收到事件通知后调用激活接口,传入会员卡号、初始积分等信息或者调用拉取会员信息接口获取会员信息。6.3 自动激活接口说明 设置会员卡自动激活功能,需在创建会员卡时填入指定字段,base_info中增加"auto_activate": true,获取card_id。 值得注意的是,传入自动激活字段auto_activate之后,一键开卡设置和接口激活设置的激活url均不再显示,用户领取卡片之后,系统自动帮用户激活,积分、储值等自定义显示信息均为0,开发者可以通过更新会员信息接口更新用户会员数据。参数说明参数 是否必须 说明 member_card auto_activate 否 填写true or false 7 更新会员信息 当会员持卡消费后,支持开发者调用该接口更新会员信息。会员卡交易后的每次信息变更需通过该接口通知微信,便于后续消息通知及其他扩展功能。接口调用请求说明HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/membercard/updateuser?access_token=TOKEN参数说明参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 JSON数据 { "code": "12312313", "card_id": "p1Pj9jr90_SQRaVqYI239Ka1erkI", "back
微信平台会员卡专区(一)