- ·上一篇文章:微信卡券事件推送
- ·下一篇文章:微信平台会员卡专区(二)
微信平台会员卡专区(一)
型的初始值,限制为4个汉字,12字节。 init_custom_field_value3 否 string(12) 创建时字段custom_field3定义类型的初始值,限制为4个汉字,12字节。 返回说明数据示例:{ "errcode":0, "errmsg":"ok" }参数名 描述 errcode 错误码,0为正常。 errmsg 错误信息。 6.2 一键激活 6.2.1 普通一键激活 一键激活是微信提供的快速便捷的激活方案,用户领取后点击“激活会员卡”会跳转至官方的资料填写页面,微信会自动拉取该用户之前填写过的开卡信息,用户无需重复填写, 同时避免了手机号验证的过程,从而实现一键激活的目的,提高了开卡率。具体流程如下图:步骤一:在创建接口填入wx_activate字段接口说明 设置微信一键开卡功能,现支持在创建会员卡时填入指定字段指定要一键激活,member_card中增加"wx_activate": true。 若商户使用了自定义卡号,开发者可以设置用户填写信息后跳转至商户的网页,并由开发者进行激活。参数说明参数 是否必须 说明 member_card wx_activate 否 填写true or false POST数据示例:{ "card": { ························ ························ "member_card": { "wx_activate": true } }}开发者注意事项1.填入了自动激活auto_activate字段,激活链接activate_url和一键开卡接口设置都会失效;2.若同时传入了activate_url,则一键开卡接口设置会失效;3.建议开发者activate_url、auto_activate和wx_activate只填写一项。步骤二:设置开卡字段接口 开发者在创建时填入wx_activate字段后,需要调用该接口设置用户激活时需要填写的选项,否则一键开卡设置不生效。接口调用请求说明HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/membercard/activateuserform/set?access_token=TOKEN参数说明参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 JSON数据 { "card_id": "pbLatjnrwUUdZI641gKdTMJzHGfc", "service_statement": { "name": "会员守则", "url": "www.qq.com" }, "bind_old_card": { "name": "老会员绑定", "url": "www.weixin.qq.com" }, "required_form": { "can_modify":false, "rich_field_list": [ { "type": "FORM_FIELD_RADIO", "name": "兴趣", "values": [ "钢琴", "舞蹈", "足球" ] }, { "type": "FORM_FIELD_SELECT", "name": "喜好", "values": [ "郭敬明", "韩寒", "南派三叔" ] }, { "type": "FORM_FIELD_CHECK_BOX", "name": "职业", "values": [ "赛车手", "旅行家" ] } ], "common_field_id_list": [ "USER_FORM_INFO_FLAG_MOBILE" ] }, "optional_form": { "can_modify":false, "common_field_id_list": [ "USER_FORM_INFO_FLAG_LOCATION", "USER_FORM_INFO_FLAG_BIRTHDAY" ], "custom_field_list": [ "喜欢的电影" ] }}参数名 必填 类型 描述 card_id 是 string(32) 卡券ID。 required_form 否 JSON结构 会员卡激活时的必填选项。 optional_form 否 JSON结构 会员卡激活时的选填项。 can_modify否bool当前结构(required_form或者optional_form )内的字段是否允许用户激活后再次修改,商户设置为true时,需要接收相应事件通知处理修改事件common_field_id_list 否 arry 微信格式化的选项类型。见以下列表。 custom_field_list 否 arry 自定义选项名称。 rich_field_list 否 arry 自定义富文本类型,包含以下三个字段 type 否 string(32) 富文本类型 FORM_FIELD_RADIO 自定义单选 FORM_FIELD_SELECT 自定义选择项 FORM_FIELD_CHECK_BOX 自定义多选 name 否 string(32) 字段名 values 否 arry 选择项 service_statement 否 JSON结构 服务声明,用于放置商户会员卡守 则 name 否 string(32) 会员声明字段名称 url 否 string(128) 自定义url bind_old_card 否 JSON结构 绑定老会员链接 name 否 string(32) 链接名称 url 否 string(128) 自定义url common_field_id_list,支持开发者使用以下选项类型字段值 描述 USER_FORM_INFO_FLAG_MOBILE 手机号 USER_FORM_INFO_FLAG_SEX性别USER_FORM_INFO_FLAG_NAME 姓名 USER_FORM_INFO_FLAG_BIRTHDAY 生日 USER_FORM_INFO_FLAG_IDCARD 身份证 USER_FORM_INFO_FLAG_EMAIL 邮箱 USER_FORM_INFO_FLAG_LOCATION 详细地址 USER_FORM_INFO_FLAG_EDUCATION_BACKGRO 教育背景 USER_FORM_INFO_FLAG_CAREER 职业 USER_FORM_INFO_FLAG_INDUSTRY 行业 USER_FORM_INFO_FLAG_INCOME 收入 USER_FORM_INFO_FLAG_HABIT 兴趣爱好 步骤三:接收会员信息事件通知 用户填写、提交资料后,会有事件推送给商家,开发者可以在接收到事件通知后调用激活接口,传入会员卡号、初始积分等信息或者调用拉取会员信息接口获取会员信息,进行会员管理。推送XML数据包示例<xml> <ToUserName> <![CDATA[gh_3fcea188bf78]]></ToUserName> <FromUserName><![CDATA[obLatjlaNQKb8FqOvt1M1x1lIBFE]]></FromUserName> <CreateTime>1432668700</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[submit_membercard_user_info]]></Event> <CardId><![CDATA[pbLatjtZ7v1BG_ZnTjbW85GYc_E8]]></CardId> <UserCardCode><![CDATA[018255396048]]></UserCardCode> </xml>参数说明参数 说明 ToUserName 开发者微信号 FromUserName 发送方帐号(一个OpenID) CreateTime 消息创建时间 (整型) MsgType 消息类型,event CardId 卡券ID UserCardCode 卡券Code码 步骤四:同步会员数据 开发者可以在接收到事件通知后调用激活接口,传入会员卡号、初始积
微信平台会员卡专区(一)