微信公号卡券事件转化规则

OAC转化微信公号卡券事件消息的规则#

微信公号文档：卡券事件

23. 卡券领取事件推送#

用户在领取卡券时，微信会把这个事件推送到开发者填写的URL。

推送XML数据包示例：#

<xml>
   <ToUserName> <![CDATA[gh_fc0a06a20993]]> </ToUserName>
    <FromUserName> <![CDATA[oZI8Fj040-be6rlDohc6gkoPOQTQ]]> </FromUserName>
    <CreateTime>1472551036</CreateTime>
    <MsgType> <![CDATA[event]]> </MsgType>
    <Event> <![CDATA[user_get_card]]> </Event>
    <CardId> <![CDATA[pZI8Fjwsy5fVPRBeD78J4RmqVvBc]]> </CardId>
    <IsGiveByFriend>0</IsGiveByFriend>//是否为转赠领取，1代表是，0代表否。
    <UserCardCode> <![CDATA[226009850808]]> </UserCardCode>
    <FriendUserName> <![CDATA[]]> </FriendUserName>//当IsGiveByFriend为1时填入的字段，表示发起转赠用户的openid
    <OuterId>0</OuterId>
    <OldUserCardCode> <![CDATA[]]> </OldUserCardCode>
    <OuterStr> <![CDATA[12b]]> </OuterStr>
    <IsRestoreMemberCard>0</IsRestoreMemberCard>
    <IsRecommendByFriend>0</IsRecommendByFriend>
    <UnionId>o6_bmasdasdsad6_2sgVt7hMZOPfL</UnionId>
</xml>

事件说明：#

OA Connector把此XML转化为事件$oa_coupon_got
当Event等于user_get_card的时候才产生该事件

属性说明：#

CardId转化为属性$coupon_card_id，值是[CardId]
UserCardCode转化为属性$coupon_user_card_code，值是[UserCardCode]
IsGiveByFriend转化为属性$coupon_is_give_by_friend，值是[IsGiveByFriend]
FriendUserName转化为属性$coupon_friend_user_name，值是[FriendUserName]
OuterId转化为属性$coupon_outer_id，值是[OuterId]。（微信文档里没有说明，照样处理）
OldUserCardCode转化为属性$coupon_old_user_card_code，值是[OldUserCardCode]
OuterStr转化为属性$coupon_outer_str，值是[OuterStr]
IsRestoreMemberCard转化为属性$coupon_is_restore_member_card，值是[IsRestoreMemberCard]
IsRecommendByFriend转化为属性$coupon_is_recommend_by_friend，值是[IsRecommendByFriend]
UnionId转化为属性$coupon_user_unionid，值是[UnionId]

24.卡券转赠事件推送#

用户在转赠卡券时，微信会把这个事件推送到开发者填写的URL。

推送XML数据包示例：#

<xml>
  <ToUserName><![CDATA[gh_3fcea188bf78]]></ToUserName>  
  <FromUserName><![CDATA[obLatjjwDolFjRRd3doGIdwNqRXw]]></FromUserName>  
  <CreateTime>1474181868</CreateTime>  
  <MsgType><![CDATA[event]]></MsgType>  
  <Event><![CDATA[user_gifting_card]]></Event>  
  <CardId><![CDATA[pbLatjhU-3pik3d4PsbVzvBxZvJc]]></CardId>  
  <UserCardCode><![CDATA[297466945104]]></UserCardCode>  
  <IsReturnBack>0</IsReturnBack>  //是否转赠退回，0代表不是，1代表是。
  <FriendUserName><![CDATA[obLatjlNerkb62HtSdQUx66C4NTU]]></FriendUserName>  //收到卡券转赠用户openid
  <IsChatRoom>0</IsChatRoom> //是否是群转赠
</xml>

事件说明：#

OA Connector把此XML转化为事件$oa_coupon_shared
当Event等于user_gifting_card的时候才产生该事件

属性说明：#

CardId转化为属性$coupon_card_id，值是[CardId]
UserCardCode转化为属性$coupon_user_card_code，值是[UserCardCode]
IsReturnBack转化为属性$coupon_is_return_back，值是[IsReturnBack]
FriendUserName转化为属性$coupon_friend_user_name，值是[FriendUserName]
IsChatRoom转化为属性$coupon_is_chat_room，值是[IsChatRoom]

25. 卡券删除事件推送#

用户在删除卡券时，微信会把这个事件推送到开发者填写的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>

事件说明：#

OA Connector把此XML转化为事件$oa_coupon_deleted
当Event等于user_del_card的时候才产生该事件

属性说明：#

CardId转化为属性$coupon_card_id，值是[CardId]
UserCardCode转化为属性$coupon_user_card_code，值是[UserCardCode]

26. 卡券核销事件推送#

卡券被核销时，微信会把这个事件推送到开发者填写的URL。

推送XML数据包示例：#

<xml>
    <ToUserName> <![CDATA[gh_fc0a06a20993]]> </ToUserName>
    <FromUserName> <![CDATA[oZI8Fj040-be6rlDohc6gkoPOQTQ]]> </FromUserName>
    <CreateTime>1472549042</CreateTime>
    <MsgType> <![CDATA[event]]> </MsgType>
    <Event> <![CDATA[user_consume_card]]> </Event>
    <CardId> <![CDATA[pZI8Fj8y-E8hpvho2d1ZvpGwQBvA]]> </CardId>
    <UserCardCode> <![CDATA[452998530302]]> </UserCardCode>
    <ConsumeSource> <![CDATA[FROM_API]]> </ConsumeSource>
    <LocationName> <![CDATA[]]> </LocationName>
    <StaffOpenId> <![CDATA[oZ********nJ3bPJu_Rtjkw4c]]> </StaffOpenId>
    <VerifyCode> <![CDATA[]]> </VerifyCode>
    <RemarkAmount> <![CDATA[]]> </RemarkAmount>
    <OuterStr> <![CDATA[xxxxx]]> </OuterStr> 
</xml>

事件说明：#

OA Connector把此XML转化为事件$oa_coupon_used
当Event等于user_consume_card的时候才产生该事件

属性说明：#

CardId转化为属性$coupon_card_id，值是[CardId]
UserCardCode转化为属性$coupon_user_card_code，值是[UserCardCode]
ConsumeSource转化为属性$coupon_consume_source，值是[ConsumeSource]
LocationName转化为属性$coupon_location_name，值是[LocationName]
StaffOpenId转化为属性$coupon_staff_openid，值是[StaffOpenId]
VerifyCode转化为属性$coupon_verify_code，值是[VerifyCode]
RemarkAmount转化为属性$coupon_remark_amount，值是[RemarkAmount]
OuterStr转化为属性$coupon_outer_str，值是[OuterStr]

27. 卡券买单事件推送#

微信买单完成时，微信会把这个事件推送到开发者填写的URL。

推送XML数据包示例：#

<xml>
    <ToUserName><![CDATA[gh_e2243xxxxxxx]]></ToUserName>
    <FromUserName><![CDATA[oo2VNuOUuZGMxxxxxxxx]]></FromUserName>
    <CreateTime>1442390947</CreateTime>
    <MsgType><![CDATA[event]]></MsgType>
    <Event><![CDATA[user_pay_from_pay_cell]]></Event>
    <CardId><![CDATA[po2VNuCuRo-8sxxxxxxxxxxx]]></CardId>
    <UserCardCode><![CDATA[38050000000]]></UserCardCode>
    <TransId><![CDATA[10022403432015000000000]]></TransId>
    <LocationId>291710000</LocationId>
    <Fee><![CDATA[10000]]></Fee>
    <OriginalFee><![CDATA[10000]]> </OriginalFee> 
</xml>

事件说明：#

OA Connector把此XML转化为事件$oa_coupon_paid_from_pay_cell
当Event等于user_pay_from_pay_cell的时候才产生该事件

属性说明：#

CardId转化为属性$coupon_card_id，值是[CardId]
UserCardCode转化为属性$coupon_user_card_code，值是[UserCardCode]
TransId转化为属性$coupon_transid，值是[TransId]
LocationId转化为属性$coupon_location_id，值是[LocationId]
Fee转化为属性$coupon_fee，值是[Fee]
OriginalFee转化为属性$coupon_original_fee，值是[OriginalFee]

28.查看微信卡券，卡券进入会员卡事件推送#

用户在进入会员卡时，微信会把这个事件推送到开发者填写的URL。需要开发者在首页时填入need_push_on_view 字段并设置为true。开发者须综合考虑领卡人数和服务器压力，决定是否接收该事件。

推送XML数据包示例：#

<xml>
    <ToUserName> <![CDATA[gh_fcxxxx6a20993]]> </ToUserName>
    <FromUserName> <![CDATA[oZI8Fj040-xxxxx6gkoPOQTQ]]> </FromUserName>
    <CreateTime>1467811138</CreateTime>
    <MsgType> <![CDATA[event]]> </MsgType>
    <Event> <![CDATA[user_view_card]]> </Event>
    <CardId> <![CDATA[pZI8Fj2ezBbxxxxxT2UbiiWLb7Bg]]> </CardId>
    <UserCardCode> <![CDATA[4xxxxxxxx8558]]> </UserCardCode>
    <OuterStr> <![CDATA[12b]]> </OuterStr> 
</xml>

事件说明：#

OA Connector把此XML转化为事件$oa_coupon_viewed
当Event等于user_view_card的时候才产生该事件

属性说明：#

CardId转化为属性$coupon_card_id，值是[CardId]
UserCardCode转化为属性$coupon_user_card_code，值是[UserCardCode]
OuterStr转化为属性$coupon_outer_str，值是[OuterStr]

29. 从卡券进入公众号会话事件推送#

用户在卡券里点击查看公众号进入会话时（需要用户已经关注公众号），微信会把这个事件推送到开发者填写的URL。开发者可识别从卡券进入公众号的用户身份。

推送XML数据包示例：#

<xml>
   <ToUserName><![CDATA[toUser]]></ToUserName>
    <FromUserName><![CDATA[FromUser]]></FromUserName>
    <CreateTime>123456789</CreateTime>
    <MsgType><![CDATA[event]]></MsgType>
    <Event><![CDATA[user_enter_session_from_card]]></Event>
    <CardId><![CDATA[cardid]]></CardId>
    <UserCardCode><![CDATA[12312312]]></UserCardCode> 
</xml>

事件说明：#

OA Connector把此XML转化为事件$oa_coupon_entered_oa
当Event等于user_enter_session_from_card的时候才产生该事件

属性说明：#

CardId转化为属性$coupon_card_id，值是[CardId]
UserCardCode转化为属性$coupon_user_card_code，值是[UserCardCode]

30.会员卡内容更新事件#

当用户的会员卡积分余额发生变动时，微信会推送事件告知开发者。

推送XML数据包示例：#

<xml>
  <ToUserName><![CDATA[gh_9e1765b5568e]]></ToUserName>
    <FromUserName><![CDATA[ojZ8YtyVyr30HheH3CM73y7h4jJE]]></FromUserName>
    <CreateTime>1445507140</CreateTime>
    <MsgType><![CDATA[event]]></MsgType>
    <Event><![CDATA[update_member_card]]></Event>
    <CardId><![CDATA[pjZ8Ytx-nwvpCRyQneH3Ncmh6N94]]></CardId>
    <UserCardCode><![CDATA[485027611252]]></UserCardCode>
    <ModifyBonus>3</ModifyBonus>
    <ModifyBalance>0</ModifyBalance> 
</xml>

事件说明：#

OA Connector把此XML转化为事件$oa_coupon_updated
当Event等于update_member_card的时候才产生该事件

属性说明：#

CardId转化为属性$coupon_card_id，值是[CardId]
UserCardCode转化为属性$coupon_user_card_code，值是[UserCardCode]
ModifyBonus转化为属性$coupon_modify_bonus，值是[ModifyBonus]
ModifyBalance转化为属性$coupon_modify_balance，值是[ModifyBalance]

31.会员卡激活事件推送#

当用户通过一键激活的方式提交信息并点击激活或者用户修改会员卡信息后，商户会收到用户激活的事件推送

推送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>

事件说明：#

OA Connector把此XML转化为事件$oa_coupon_activated
当Event等于submit_membercard_user_info的时候才产生该事件

属性说明：#

CardId转化为属性$coupon_card_id，值是[CardId]
UserCardCode转化为属性$coupon_user_card_code，值是[UserCardCode]

32.库存报警事件#

当某个card_id的初始库存数大于200且当前库存小于等于100时，用户尝试领券会触发发送事件给商户，事件每隔12h发送一次。

推送XML数据包示例：#

<xml>
   <ToUserName><![CDATA[gh_2d62d*****0]]></ToUserName>
    <FromUserName><![CDATA[oa3LFuBvWb7*********]]></FromUserName>
    <CreateTime>1443838506</CreateTime>
    <MsgType><![CDATA[event]]></MsgType>
    <Event><![CDATA[card_sku_remind]]></Event>
    <CardId><![CDATA[pa3LFuAh2P65**********]]></CardId>
    <Detail><![CDATA[the card's quantity is equal to 0]]></Detail>
</xml>

事件说明：#

OA Connector把此XML转化为事件$oa_coupon_card_sku_remind
当Event等于card_sku_remind的时候才产生该事件

属性说明：#

CardId转化为属性$coupon_card_id，值是[CardId]
Detail转化为属性$coupon_detail，值是[Detail]

券点流水详情事件(本事件暂不处理，因为它属于朋友的券)#

当商户朋友的券券点发生变动时，微信服务器会推送消息给商户服务器。

<xml>
   <ToUserName><![CDATA[gh_7223c83d4be5]]></ToUserName>
    <FromUserName><![CDATA[ob5E7s-HoN9tslQY3-0I4qmgluHk]]></FromUserName>
    <CreateTime>1453295737</CreateTime>
    <MsgType><![CDATA[event]]></MsgType>
    <Event><![CDATA[card_pay_order]]></Event>
    <OrderId><![CDATA[404091456]]></OrderId>//本次推送对应的订单号
    <Status><![CDATA[ORDER_STATUS_FINANCE_SUCC]]></Status>//本次订单号的状态
    <CreateOrderTime>1453295737</CreateOrderTime>//购买券点时，支付二维码的生成时间
    <PayFinishTime>0</PayFinishTime>//购买券点时，实际支付成功的时间
    <Desc><![CDATA[]]></Desc>//支付方式，一般为微信支付充值
    <FreeCoinCount><![CDATA[200]]></FreeCoinCount>//剩余免费券点数量
    <PayCoinCount><![CDATA[0]]></PayCoinCount>//剩余付费券点数量
    <RefundFreeCoinCount><![CDATA[0]]></RefundFreeCoinCount>//本次变动的免费券点数量
    <RefundPayCoinCount><![CDATA[0]]></RefundPayCoinCount>//本次变动的付费券点数量
    <OrderType><![CDATA[ORDER_TYPE_SYS_ADD]]></OrderType>//所要拉取的订单类型 
    <Memo><![CDATA[开通账户奖励]]></Memo>//系统备注，说明此次变动的缘由，如开通账户奖励、门店奖励、核销奖励以及充值、扣减
    <ReceiptInfo><![CDATA[]]></ReceiptInfo>//所开发票的详情
</xml>

事件说明：#

OA Connector把此XML转化为事件$oa_coupon_card_pay_order
当Event等于card_pay_order的时候才产生该事件

属性说明：#

CardId转化为属性$coupon_card_id，值是[CardId]//没有这个属性