卡券事件推送
来自企业号开发者接口文档
领取事件推送
用户在领取卡券时,微信企业号后台会把这个事件推送到开发者填写的URL(注:目前仅支持第三方套件的回调)。 推送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>0</OuterId> </xml>
- 参数说明
参数 | 说明 |
---|---|
ToUserName | 开发者微信号 |
FromUserName | 领券方帐号(一个OpenID) |
FriendUserName | 赠送方账号(一个OpenID),"IsGiveByFriend”为1时填写该参数。 |
CreateTime | 消息创建时间 (整型) |
MsgType | 消息类型,event |
Event | 事件类型,user_get_card(用户领取卡券) |
CardId | 卡券ID |
IsGiveByFriend | 是否为转赠,1代表是,0代表否 |
UserCardCode | code序列号 |
OldUserCardCode | 转赠前的code序列号 |
OuterId | 领取场景值,用于领取渠道数据统计。可在生成二维码接口及添加JS API接口中自定义该字段的整型值 |
删除事件推送
用户在删除卡券时,微信企业号后台会把这个事件推送到开发者填写的URL(注:目前仅支持第三方套件的回调)。 推送XML数据包示例:
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[user_del_card]]></Event> <CardId><![CDATA[cardid]]></CardId> <UserCardCode><![CDATA[12312312]]></UserCardCode> </xml>
- 参数说明
参数 | 说明 |
---|---|
ToUserName | 开发者微信号 |
FromUserName | 领券方帐号(一个OpenID) |
CreateTime | 消息创建时间 (整型) |
MsgType | 消息类型,event |
Event | 事件类型,user_del_card(用户删除卡券) |
CardId | 卡券ID |
UserCardCode | code序列号 |
核销事件推送
卡券被核销时,微信企业号后台会把这个事件推送到开发者填写的URL(注:目前仅支持第三方套件的回调)。 推送XML数据包示例:
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[user_consume_card]]></Event> <CardId><![CDATA[cardid]]></CardId> <UserCardCode><![CDATA[12312312]]></UserCardCode> <IsMember><![CDATA[1]]></IsMember> <UserId><![CDATA[zangshan]]></UserId> </xml>
- 参数说明
参数 | 说明 |
---|---|
ToUserName | 开发者微信号 |
FromUserName | 领券方帐号(一个OpenID) |
CreateTime | 消息创建时间 (整型) |
MsgType | 消息类型,event |
Event | 事件类型,user_consume_card(核销事件) |
CardId | 卡券ID |
UserCardCode | code序列号 |
IsMember | 是否是企业内关注成员,1:企业内关注成员,0:非企业内关注成员 |
UserId | 如果IsMember为1,返回成员的userid,否则为空 |