Push d'événement de carte et de coupon

1.Mise à jour du journal

Numéro de version	Contenu de mise à jour	Heure de mise à jour
V1.0	S'il s'agit d'un téléphone mobile, l'événement de radiation sera ajouté Assistant règles de radiation L'openid du souscripteur peut être poussé.	2015-8-31
V1.1	De nouveaux champs liés au bon de commande, le numéro de commande du commerçant et le numéro de commande de transaction de paiement WeChat sont ajoutés à l'événement de radiation.	2015-9-8
V1.2	Un nouvel événement d'alarme d'inventaire sera déclenché lorsque l'utilisateur recevra la meilleure carte	2015- 9-8
V1.3	Un nouvel événement de mise à jour du contenu de la carte de membre de la bibliothèque est ajouté pour informer les développeurs des points et des changements de solde via des événements	2015-10-28
V1.4	Nouveau interface de transfert de cartes de membre	2016-9-19

2. Push d'événement de carte et de coupon

Le push d'événement sera déclenché lorsque la carte et le coupon réussissent l'examen, la carte et le coupon sont collectés par l'utilisateur, la carte et le coupon sont supprimés par l'utilisateur, le la carte et le coupon sont annulés par le commerçant, et le compte officiel est saisi à partir de la carte et du coupon, l'événement sera envoyé à l'URL renseignée par le développeur (connectez-vous à la plateforme publique et entrez [Paramètres du Centre de développement]). . Les développeurs peuvent compléter les statistiques de données, l'identification des utilisateurs et d'autres opérations via le push d'événements.

Si le serveur WeChat ne reçoit pas de réponse dans les cinq secondes, il se déconnectera et relancera la demande, en réessayant trois fois au total. Concernant la nouvelle tentative de duplication des messages, il est recommandé d'utiliser FromUserName + CreateTime pour dédupliquer les messages. Si le serveur ne peut pas garantir le traitement et la réponse dans les cinq secondes, vous pouvez répondre directement avec une chaîne vide. Le serveur WeChat ne fera rien avec cela et ne lancera pas de nouvelle tentative.

2.1 Poussée de l'événement d'examen

Lorsque le coupon généré passe l'examen, WeChat transmettra cet événement à l'URL renseignée par le développeur.

<xml> 
  <ToUserName><![CDATA[toUser]]></ToUserName>  
  <FromUserName><![CDATA[FromUser]]></FromUserName>  
  <CreateTime>123456789</CreateTime>  
  <MsgType><![CDATA[event]]></MsgType>  
  <Event><![CDATA[card_pass_check]]></Event> //不通过为card_not_pass_check 
  <CardId><![CDATA[cardid]]></CardId>  
  <RefuseReason><![CDATA[非法代制]]></RefuseReason> 
</xml>

Description du paramètre :

Paramètre	Description
ToUserName	ID WeChat du développeur
FromUserName	Compte expéditeur (un OpenID)
CreateTime	Durée de création du message (entier)
MsgType	type d'événement, événement
Event	type d'événement, card_pass_check (Carte et examen du coupon-pass), card_not_pass_check (Le la carte n'a pas réussi l'examen)
CardId	ID du coupon de carte
RefuseReason	Raison de l'échec de l'examen

Utilisez l'outil de débogage Web pour déboguer l'interface

2.2 Recevoir un événement push

Lorsque l'utilisateur reçoit le coupon, WeChat transmettra cet événement à l'URL renseignée par le développeur. Exemple de package de données XML Push :

<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>  
  <UserCardCode> <![CDATA[226009850808]]> </UserCardCode>  
  <FriendUserName> <![CDATA[]]> </FriendUserName>  
  <OuterId>0</OuterId>  
  <OldUserCardCode> <![CDATA[]]> </OldUserCardCode>  
  <OuterStr> <![CDATA[12b]]> </OuterStr>  
  <IsRestoreMemberCard>0</IsRestoreMemberCard>  
  <IsRecommendByFriend>0</IsRecommendByFriend> 
</xml>

Description du paramètre :

Paramètres	Description
ToUserName	Identifiant WeChat du développeur.
FromUserName	Compte du destinataire du coupon (un OpenID).
CreateTime	Durée de création du message (entier).
MsgType	type de message, événement
Event	type d'événement, user_get_card (l'utilisateur reçoit un coupon de carte).
CardId	Identifiant de la carte.
IsGiveByFriend	Qu'il s'agisse d'un transfert à recevoir, 1 signifie oui, 0 signifie non.
FriendUserName	Le champ renseigné lorsque IsGiveByFriend est 1, indiquant le numéro de série openid
UserCardCode	code de l'utilisateur qui a initié le transfert.
OldUserCardCode	Pour garantir la sécurité, WeChat modifiera le numéro de code de la carte après le transfert. Ce champ indique le code avant le transfert.
OuterStr	Recevoir la valeur de la scène, qui est utilisée pour recevoir les statistiques des données du canal. La valeur de chaîne de ce champ peut être personnalisée dans l'interface de génération de code QR et l'interface Addcard.
IsRestoreMemberCard	L'utilisateur peut à nouveau récupérer la carte de membre après l'avoir supprimée. Lorsque l'opération de l'utilisateur consiste à la récupérer, la valeur est 1, sinon elle est 0

Utilisez des outils de débogage Web pour déboguer cette interface

2.3 Transfert d'événement push

Lorsqu'un utilisateur transfère une carte-cadeau ou un coupon, WeChat transmettra cet événement à l'URL renseignée par le développeur. Exemple de package de données XML Push :

<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>  
  <FriendUserName><![CDATA[obLatjlNerkb62HtSdQUx66C4NTU]]></FriendUserName>  
  <IsChatRoom>0</IsChatRoom> 
</xml>

Description du paramètre :

Paramètres	Description
ToUserName	Identifiant WeChat du développeur.
FromUserName	Compte du destinataire du coupon (un OpenID).
CreateTime	Durée de création du message (entier).
MsgType	Type de message, événement
Event	Type d'événement, user_gifting_card (l'utilisateur transfère le coupon de carte-cadeau).
CardId	Identifiant de la carte.
FriendUserName	Recevez le numéro de série openid
UserCardCode	code de l'utilisateur de la carte.
IsReturnBack	Que ce soit le retourner en cadeau, 0 signifie non, 1 signifie oui.
IsChatRoom	Est-ce un cadeau de groupe

Utilisez des outils de débogage Web pour déboguer cette interface

2.4 Supprimer l'événement push

Lorsque l'utilisateur supprime la carte, WeChat transmettra cet événement à l'URL renseignée par le développeur. Exemple de package de données XML Push :

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

Description du paramètre :

Paramètres	Description
ToUserName	Identifiant WeChat du développeur.
FromUserName	Compte expéditeur (un OpenID)
CreateTime	Durée de création du message (entier).
MsgType	Type de message, événement
Event	Type d'événement, user_del_card (l'utilisateur supprime la carte)
CardId	Identifiant de la carte.
UserCardCode	numéro de série du code. Le push d'événement est pris en charge une fois que les cartes et les coupons avec des codes personnalisés et des codes non personnalisés ont été collectés.

Utilisez des outils de débogage Web pour déboguer cette interface

2.5 Push d'événement d'annulation

Lorsque le coupon est radié, WeChat transmettra cet événement à l'URL renseignée par le développeur. Exemple de paquet Push 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>

Paramètre	Description
ToUserName	Identifiant WeChat du développeur.
FromUserName	Compte expéditeur (un OpenID).
CreateTime	Durée de création du message (entier).
MsgType	Type de message, événement.
Event	Type d'événement, user_consume_card (événement d'annulation)
CardId	ID de coupon de carte.
UserCardCode	Code de la carte.
ConsumeSource	ConsumeSource. Prend en charge l'annulation de l'API des statistiques du développeur (FROM_API), l'annulation de la plate-forme publique (FROM_MP), l'annulation de l'assistant marchand de cartes et de coupons (FROM_MOBILE_HELPER) (compte WeChat vérificateur)
LocationName	nom du magasin, nom actuel du magasin Le nom du magasin où la carte et le coupon sont vérifiés (ce champ n'apparaîtra que lors de la vérification via le libre-service et les bons de commande)
StaffOpenId	L'openid de la personne qui vérifie le carte et coupon (uniquement via la vérification de la carte et du coupon. Il n'apparaîtra que lorsque l'assistant marchand vérifiera)
VerifyCode	Le code de vérification saisi par l'utilisateur lors de la radiation en libre-service
RemarkAmount	Le montant de la remarque saisi par l'utilisateur lors de la radiation en libre-service
OuterStr	Initié par les développeurs Paramètres personnalisés transmis lors de la radiation, utilisés pour les statistiques du canal de radiation

Utilisez l'outil de débogage Web pour déboguer l'interface

2.6 Push d'événement d'achat

Une fois le paiement WeChat terminé, WeChat poussera cet événement vers l'URL renseignée par le développeur. Exemple de paquet Push 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>

Paramètre

Description

ToUserName

Identifiant WeChat du développeur.

FromUserName

Compte expéditeur (un OpenID).

CreateTime

Durée de création du message (entier).

MsgType

Type de message, événement.

Event

Type d'événement, User_pay_from_pay_cell (événement payant WeChat)

CardId

ID de carte.

UserCardCode

Code de la carte.

TransId

Numéro de commande de transaction de paiement WeChat (seules les cartes et les coupons vérifiés à l'aide de la fonction d'achat apparaîtront)

LocationId

ID du magasin, la vérification actuelle de la carte et du coupon Identifiant du magasin (n'apparaît que lors de la vérification via l'assistant marchand de la carte et le bon de commande) c'est des centimes

Utilisez l'outil de débogage Web pour déboguer l'interface

2.7 Entrez le push de l'événement de la carte de membre

Lorsque l'utilisateur entre la carte de membre, WeChat poussera cet événement vers l'URL renseignée par le développeur.

oblige les développeurs à remplir le champ need_push_on_view et à le définir sur true lors de la création d'une carte de membre. Les développeurs doivent tenir compte du nombre de titulaires de cartes et de la pression du serveur pour décider d'accepter ou non cet événement.

Exemple de package de données Push 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>

Description du paramètre :

Paramètres	Description
ToUserName	Identifiant WeChat du développeur.
FromUserName	Compte expéditeur (un OpenID).
CreateTime	Durée de création du message (entier).
MsgType	Type de message, événement.
Event	Type d'événement, user_view_card (l'utilisateur clique sur la carte de membre)
CardId	ID de coupon de carte.
UserCardCode	Valeur du code personnalisé du marchand. Le code non personnalisé est poussé sous forme de chaîne vide.
OuterStr	Paramètres de canal de code QR définis par le commerçant, utilisés pour identifier le code QR à partir duquel la carte de membre ouverte en scannant le code provient d'une certaine valeur de canal

Utilisez l'outil de débogage Web pour déboguer l'interface

2.8 Entrez l'événement de session de compte officiel à partir du coupon de la carte

L'utilisateur clique dans le card coupon Voir le compte public Lors de l'entrée dans la session (l'utilisateur doit avoir suivi le compte officiel), WeChat poussera cet événement vers l'URL renseignée par le développeur. Les développeurs peuvent identifier les utilisateurs qui accèdent au compte officiel à partir de cartes et de coupons. Exemple de package de données XML Push :

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

Description du paramètre :

Utilisez l'outil de débogage Web pour déboguer l'interface

2.9 Événement de mise à jour du contenu de la carte de membre

Lorsque l'utilisateur Modifications du solde des points de la carte de membre, WeChat le fera Informer les développeurs des événements push. Exemple de package de données XML Push :

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

Description du paramètre :

Paramètres	Description
ToUserName	Identifiant WeChat du développeur.
FromUserName	Compte expéditeur (un OpenID)
CreateTime	Durée de création du message (entier)."Type de message, événement"
CardId	Identifiant du coupon.
UserCardCode	Code de code.

Paramètres	Description
ToUserName	Identifiant WeChat du développeur.
FromUserName	Compte expéditeur (un OpenID)
CreateTime	Durée de création du message (entier).
MsgType	Type de message, événement
Event	Type d'événement, update_member_card (mise à jour du contenu de la carte de membre)
CardId	Identifiant de la carte.
UserCardCode	Code de code.
ModifyBonus	La valeur changeante des points.
ModifyBalance	La valeur du solde modifié.

具 Utilisez l'outil de débogage de page Web pour déboguer cette interface

2.10 Incident d'alarme d'inventaire Lorsque l'inventaire initial d'un Card_id est supérieur à 200 et que l'inventaire actuel est inférieur à 100, l'inventaire actuel. l'inventaire est inférieur à 100 et l'inventaire actuel Lorsqu'un utilisateur tente de recevoir un coupon, un événement sera envoyé au commerçant. L'événement sera envoyé toutes les 12 heures.

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

Description du paramètre :

Paramètre	Description
ToUserName	ID WeChat du développeur
FromUserName	Expéditeur, WeChat
CreateTime	Heure de création du message (entier)
MsgType	Type de message, événement
Event	Type d'événement, card_sku_remind alarme d'inventaire
ID de carte	ID du coupon
Détail	Détails de l'alarme

Utilisez l'outil de débogage Web pour déboguer l'interface

2.11 Coupon Point Détails Détails un message au serveur marchand.

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

Description du paramètre :

Utilisez l'outil de débogage Web pour déboguer l'interface

2.12 Push de l'événement d'activation de la carte de membre

Lorsque l'utilisateur soumet des informations via l'activation en un clic et clique pour l'activer, le commerçant recevra le activation de l'utilisateur Événement push

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

Description du paramètre

Paramètre	Description
ToUserName	ID WeChat du développeur
FromUserName	Expéditeur, WeChat
CreateTime	Heure de création du message (entier)
MsgType	Type de message, événement
Event	Type d'événement, card_pay_order bon d'achat détails de l'événement
Numéro de commande	Le numéro de commande correspondant à ce push
Status	Le statut de ce numéro de commande, ORDER_STATUS_WAITING En attente de paiement ORDER_STATUS_SUCC Paiement réussi ORDER_STATUS_FINANCE_SUCC Ajout du token réussi ORDER_STATUS_QUANTITY_SUCC Inventaire ajouté avec succès ORDER_STATUS_HAS_REFUND Pièce remboursée ORDER_STATUS_REFUND_WAITING En attente de remboursement Confirmez que ORDER_STATUS_ROLLBACK a été annulé, le système a échoué ORDER_STATUS_HAS_RECEIPT La facture a été émise
CreateOrderTime	Lors de l'achat de points de coupon, le temps de génération du code QR de paiement
PayFinishTime	Lors de l'achat d'un coupon points, le moment où le paiement effectif est réussi
Desc	Le mode de paiement est généralement la recharge du paiement WeChat
FreeCoinCount	Le nombre de points de coupon gratuits restants
PayCoinCount	Nombre de points de coupon payés restants
RefundFreeCoinCountLe nombre de points de coupon gratuits pour ce changement Type de commande	ORDER_TYPE_SYS_ADD Points de coupon cadeau de la plateforme ORDER_TYPE_WXPAY Points de coupon de recharge ORDER_TYPE_REFUND Inventaire des points de coupon de remboursement inutilisés ORDER_TYPE_SYS_REDUCE Déduction de la plateforme
Memo	Remarques du système, expliquant la raison de cela changement, comme les récompenses d'activation du compte, les récompenses du magasin, radier les récompenses, les recharges et les déductions.
ReceiptInfo	Détails de la facture émise

Utiliser le débogage Web outil pour déboguer l'interface

Paramètres CreateTime (entier)
CardId Code promo

← Gérer les cartes et les coupons

Espace carte de membre (1) →

soumettre

Push d'événement de carte et de coupon