| 版本号 | 更新内容 | 更新时间 |
|---|---|---|
| V1.0 | 核销事件新增核销门店，如果为手机助手核销则可以推送核销员openid。 | 2015-8-31 |
| V1.1 | 核销事件新增买单相关字段，商户订单号和微信支付交易订单号。 | 2015-9-8 |
| V1.2 | 新增库存报警事件，当用户领取到最好一张卡券的时候推送库存报警事件 | 2015-9-8 |
| V1.3 | 新增库会员卡内容更新事件，通过事件告知开发者积分和余额变动情况 | 2015-10-28 |
| V1.4 | 新增转赠会员卡接口 | 2016-9-19 |
卡券通过审核、卡券被用户领取、卡券被用户删除、卡券被商户核销、从卡券进入公众号等情况均会触发事件推送，该事件将发送至开发者填写的URL（登录公众平台进入【开发者中心设置】）。 开发者可通过事件推送完成数据统计、用户身份识别等操作。
微信服务器在五秒内收不到响应会断掉连接，并且重新发起请求，总共重试三次。关于重试的消息排重，推荐使用FromUserName + CreateTime 排重。假如服务器无法保证在五秒内处理并回复，可以直接回复空串，微信服务器不会对此作任何处理，并且不会发起重试。
2.1 审核事件推送
生成的卡券通过审核时，微信会把这个事件推送到开发者填写的URL。
123456789 //不通过为card_not_pass_check
参数说明：
| 参数 | 说明 |
|---|---|
| ToUserName | 开发者微信号 |
| FromUserName | 发送方帐号（一个OpenID） |
| CreateTime | 消息创建时间 （整型） |
| MsgType | 消息类型，event |
| Event | 事件类型，card_pass_check(卡券通过审核)、card_not_pass_check（卡券未通过审核） |
| CardId | 卡券ID |
RefuseReason | 审核不通过原因 |
使用网页调试工具调试该接口
2.2 领取事件推送
用户在领取卡券时，微信会把这个事件推送到开发者填写的URL。 推送XML数据包示例：
1472551036 0 0 0 0
参数说明：
| 参数 | 说明 |
|---|---|
| ToUserName | 开发者微信号。 |
| FromUserName | 领券方帐号（一个OpenID）。 |
| CreateTime | 消息创建时间 （整型）。 |
| MsgType | 消息类型，event |
| Event | 事件类型，user_get_card(用户领取卡券)。 |
| CardId | 卡券ID。 |
| IsGiveByFriend | 是否为转赠领取，1代表是，0代表否。 |
| FriendUserName | 当IsGiveByFriend为1时填入的字段，表示发起转赠用户的openid |
| UserCardCode | code序列号。 |
| OldUserCardCode | 为保证安全，微信会在转赠发生后变更该卡券的code号，该字段表示转赠前的code。 |
| OuterStr | 领取场景值，用于领取渠道数据统计。可在生成二维码接口及添加Addcard接口中自定义该字段的字符串值。 |
| IsRestoreMemberCard | 用户删除会员卡后可重新找回，当用户本次操作为找回时，该值为1，否则为0 |
使用网页调试工具调试该接口
用户在转赠卡券时，微信会把这个事件推送到开发者填写的URL。 推送XML数据包示例：
1474181868 0 0
参数说明：
| 参数 | 说明 |
|---|---|
| ToUserName | 开发者微信号。 |
| FromUserName | 领券方帐号（一个OpenID）。 |
| CreateTime | 消息创建时间 （整型）。 |
| MsgType | 消息类型，event |
| Event | 事件类型，user_gifting_card(用户转赠卡券)。 |
| CardId | 卡券ID。 |
| FriendUserName | 接收卡券用户的openid |
| UserCardCode | code序列号。 |
IsReturnBack | 是否转赠退回，0代表不是，1代表是。 |
IsChatRoom | 是否是群转赠 |
使用网页调试工具调试该接口
2.4 删除事件推送
用户在删除卡券时，微信会把这个事件推送到开发者填写的URL。 推送XML数据包示例：
123456789
参数说明：
| 参数 | 说明 |
|---|---|
| ToUserName | 开发者微信号。 |
| FromUserName | 发送方帐号（一个OpenID） |
| CreateTime | 消息创建时间 （整型）。 |
| MsgType | 消息类型，event |
| Event | 事件类型，user_del_card(用户删除卡券) |
| CardId | 卡券ID。 |
| UserCardCode | code序列号。自定义code及非自定义code的卡券被领取后都支持事件推送。 |
使用网页调试工具调试该接口
2.5 核销事件推送
卡券被核销时，微信会把这个事件推送到开发者填写的URL。 推送XML数据包示例：
1472549042
| 参数 | 说明 |
|---|---|
| ToUserName | 开发者微信号。 |
| FromUserName | 发送方帐号（一个OpenID）。 |
| CreateTime | 消息创建时间 （整型）。 |
| MsgType | 消息类型，event。 |
| Event | 事件类型，user_consume_card(核销事件) |
| CardId | 卡券ID。 |
| UserCardCode | 卡券Code码。 |
| ConsumeSource | 核销来源。支持开发者统计API核销（FROM_API）、公众平台核销（FROM_MP）、卡券商户助手核销（FROM_MOBILE_HELPER）（核销员微信号） |
| LocationName | 门店名称，当前卡券核销的门店名称（只有通过自助核销和买单核销时才会出现该字段） |
| StaffOpenId | 核销该卡券核销员的openid（只有通过卡券商户助手核销时才会出现） |
VerifyCode | 自助核销时，用户输入的验证码 |
| RemarkAmount | 自助核销时，用户输入的备注金额 |
| OuterStr | 开发者发起核销时传入的自定义参数，用于进行核销渠道统计 |
使用网页调试工具调试该接口
2.6 买单事件推送
微信买单完成时，微信会把这个事件推送到开发者填写的URL。 推送XML数据包示例：
1442390947 291710000
| 参数 | 说明 |
|---|---|
| ToUserName | 开发者微信号。 |
| FromUserName | 发送方帐号（一个OpenID）。 |
| CreateTime | 消息创建时间 （整型）。 |
| MsgType | 消息类型，e
相关 视频 RELATED VIDEOS 科技资讯
精选课程 
PHP实战天龙八部之微信支付视频教程
共5课时 17.2万人学习 
PHP实战天龙八部之仿爱奇艺电影网站
共49课时 77万人学习 
前端入门_HTML5
共29课时 61.7万人学习 
CSS视频教程-玉女心经版
共25课时 39.3万人学习 
JavaScript极速入门_玉女心经系列
共43课时 70.9万人学习 
独孤九贱(1)_HTML5视频教程
共25课时 61.6万人学习 
独孤九贱(2)_CSS视频教程
共22课时 23万人学习 
独孤九贱(3)_JavaScript视频教程
共28课时 33.9万人学习 
独孤九贱(4)_PHP视频教程
共89课时 125万人学习 |
