カードとクーポンのイベントプッシュ


カードとクーポンのイベントプッシュ

39f4e18a-0faa-389f-9755-1c5b108402ea.png

1.更新ログ

#2015-8-31##V1.1##V1.2 追加新しい在庫アラーム イベント。ユーザーが最高のカードとクーポンを受け取ると、在庫アラーム イベントがプッシュされます。#2015-9-8V1.3イベントを通じてポイントと残高の変更を開発者に通知するために、新しい図書館会員カードのコンテンツ更新イベントを追加します2015-10-28V1.4会員カードを移行するための新しいインターフェース2016-9-19

2. カードとクーポンのイベントプッシュ

#カードとクーポンがレビューに合格し、カードとクーポンがユーザーによって収集され、カードとクーポンが収集されますユーザーによって削除され、加盟店によってカードとクーポンがキャンセルされた場合、カードクーポンなどから公式アカウントを入力するとイベントプッシュがトリガーされ、開発者が入力したURL にイベントが送信されます(公式プラットフォームにログインし、[デベロッパー センターの設定] に入ります) 。開発者は、イベント プッシュを通じてデータ統計、ユーザー識別、その他の操作を完了できます。

WeChat サーバーが 5 秒以内に応答を受信しない場合、接続を切断してリクエストを再開始し、合計 3 回再試行します。メッセージの重複の再試行に関しては、FromUserName CreateTime を使用してメッセージの重複を排除することをお勧めします。サーバーが 5 秒以内に処理して応答することを保証できない場合は、空の文字列で直接応答できますが、WeChat サーバーはこれに対して何もせず、再試行も開始しません。

2.1 レビュー イベント プッシュ

#生成されたクーポンがレビューに合格すると、WeChat はこのイベントを開発者の入力済みのユーザーにプッシュします。 URLで。 

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

パラメータの説明:

#バージョン番号更新内容更新時間
V1.0 消込イ​​ベントにより、新しい消込ストアが追加されます (モバイル アシスタントの償却 引受業者の openid をプッシュできます。
新規注文書、販売者注文番号、WeChat 支払い取引注文番号に関連するフィールドが消込イベントに追加されます。#2015-9-8
##ToUserName開発者 WeChat IDFromUserName送信者アカウント (1 つの OpenID)#CreateTimeMsgType##イベント審査に失敗した理由

Web デバッグ ツールを使用してこのインターフェイスをデバッグします

2.2 イベント プッシュを受信する

ユーザーがカードやクーポンを受け取ると、WeChat開発者が入力した 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>  
  <UserCardCode> <![CDATA[226009850808]]> </UserCardCode>  
  <FriendUserName> <![CDATA[]]> </FriendUserName>  
  <OuterId>0</OuterId>  
  <OldUserCardCode> <![CDATA[]]> </OldUserCardCode>  
  <OuterStr> <![CDATA[12b]]> </OuterStr>  
  <IsRestoreMemberCard>0</IsRestoreMemberCard>  
  <IsRecommendByFriend>0</IsRecommendByFriend> 
</xml>

パラメータの説明:

#パラメータ説明
メッセージ作成時間 (整数)
メッセージ タイプ、イベント
イベント タイプ、card_pass_check (カードとクーポンが審査に合格)、card_not_pass_check (カードとクーポンが審査に合格しなかった)
#CardIdカード ID
# #RefuseReason

Web デバッグ ツールを使用してこのインターフェイスをデバッグします


##2.3 転送イベント プッシュ

#ユーザーがギフトカードまたはクーポンを転送すると、WeChat は開発者が入力した 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>  
  <FriendUserName><![CDATA[obLatjlNerkb62HtSdQUx66C4NTU]]></FriendUserName>  
  <IsChatRoom>0</IsChatRoom> 
</xml>

パラメーターの説明:

#パラメータ説明
ToUserName開発者の WeChat ID。
FromUserNameクーポン アカウント番号 (OpenID)。
CreateTimeメッセージの作成時間 (整数)。
MsgTypeメッセージ タイプ、イベント
Event#イベント タイプ、user_get_card (ユーザーはカードとクーポンを受け取ります)。
CardIdカード ID。
IsGiveByFriend受信する転送であるかどうか、1 ははい、0 はいいえを意味します。
FriendUserNameIsGiveByFriend が 1 の場合に入力されるフィールドで、転送を開始したユーザーの openid を示します。
UserCardCodeコードのシリアル番号。
OldUserCardCode安全性を確保するため、WeChat は転送後にカードのコード番号を変更します。フィールドには転送前のコードが表示されます。
#OuterStr
チャネル データ統計を受信するために使用される受信シーン値。このフィールドの文字列値は、QR コード生成インターフェイスおよび Addcard インターフェイスでカスタマイズできます。
IsRestoreMemberCardユーザーが会員カードを削除した後、再度取得することができます。ユーザーの現在の操作取得する場合は値は 1、それ以外の場合は 0
##ToUserName開発者の WeChat ID。 FromUserNameクーポン受信者のアカウント番号 (OpenID)。 CreateTimeメッセージの作成時間 (整数)。 MsgTypeメッセージ タイプ、イベントEventイベント タイプ、user_gifting_card (ユーザーがギフト カード クーポンを転送)。 CardIdカード ID。#ChatRoom です
#パラメータ説明
#FriendUserNameクーポンを受け取るユーザーの openid
UserCardCodeコードのシリアル番号。
#IsReturnBack

##ギフトとして返品するかどうか、0いいえを意味し、1 ははいを表します。

#グループ転送ですか

Web デバッグ ツールを使用してこのインターフェイスをデバッグします

2.4 イベント プッシュの削除

ユーザーがカードまたはクーポンを削除したとき, WeChat は、開発者が入力した 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>

パラメータの説明:

#FromUserName送信者アカウント (OpenID)CreateTimeメッセージの作成時間 (整数)。
#パラメータ説明
ToUserName開発者の WeChat ID。
MsgTypeメッセージ タイプ、イベント
Eventイベント タイプ、user_del_card (ユーザーがカードを削除)
CardId カード クーポン ID。
UserCardCodeコードのシリアル番号。イベント プッシュは、カスタム コードおよび非カスタム コードを含むカードとクーポンが収集された後にサポートされます。

Web デバッグ ツールを使用してこのインターフェイスをデバッグします

2.5 消込イベント プッシュ

カードとクーポンがWeChat このイベントは、開発者が入力した 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>
##RemarkAmount#セルフサービス消込中にユーザーが入力した注釈金額OuterStr ##開発者によって開始され、消込中に渡されるカスタム パラメータ。消込チャネル統計に使用されます。##

Web デバッグ ツールを使用してこのインターフェイスをデバッグします

2.6 購入イベントをプッシュします

WeChat 購入が完了したとき, WeChat はこれを送信します イベントは開発者が入力した 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>
パラメータ説明
ToUserName 開発者の WeChat ID。
FromUserName送信者アカウント (OpenID)。
CreateTimeメッセージの作成時間 (整数)。
MsgTypeメッセージ タイプ、イベント。
イベントイベント タイプ、user_consume_card (消込イベント)
CardIdカード ID。
UserCardCodeカード コード。
#ConsumeSource確認ソース。開発者統計 API の消込 (FROM_API)、パブリック プラットフォームの消込 (FROM_MP)、カードおよびクーポンのマーチャント アシスタント消込 (FROM_MOBILE_HELPER) (検証者 WeChat アカウント) をサポート
LocationName店舗名、現在のカードとクーポンが検証されている店舗の名前 (このフィールドはセルフサービス検証および注文書の検証でのみ表示されます)
StaffOpenIdカードとクーポンを検証した人の openid (検証が完了した場合にのみ表示されます)カードおよびクーポン販売アシスタント経由)

VerifyCode

##セルフサービス検証中にユーザーが入力した検証コード

##イベント タイプ、User_pay_from_pay_cell (WeChat 支払いイベント)##CardIdUserCardCodeTransId
パラメータ説明
ToUserName 開発者の WeChat ID。
FromUserName送信者アカウント (OpenID)。
CreateTimeメッセージの作成時間 (整数)。
MsgTypeメッセージ タイプ、イベント。
イベント
カード ID。
カード コード。
WeChat 支払いトランザクション注文番号 (購入機能を使用して確認されたカードとクーポンのみが表示されます) ) #LocationId
店舗 ID、現在のカードの店舗 ID、およびクーポンの確認 (カード経由のみ)およびクーポン販売アシスタントと、注文書が帳消しになる場合にのみ表示されます) 料金
実際の金額支払い済み (セント単位)OriginalFee
#支払われる金額 (セント単位)##

Web デバッグ ツールを使用してこのインターフェイスをデバッグします

2.7 メンバーシップ カード イベント プッシュの入力

ユーザーがメンバーシップに入るときカードを使用すると、WeChat はこのイベントを開発者が入力した 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>

パラメータの説明:

##ToUserName開発者の WeChat ID。 FromUserName送信者アカウント (OpenID)。 CreateTimeメッセージの作成時間 (整数)。 MsgTypeメッセージ タイプ、イベント。

Web デバッグ ツールを使用してこのインターフェイスをデバッグします


##2.8 カード クーポンから公式アカウント セッション イベント プッシュを入力します

##ユーザーがカード クーポンをクリックして表示します公式アカウントを使用してセッションに参加すると (ユーザーは公式アカウントをフォローしている必要があります)、WeChat は開発者が入力した 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>

パラメータの説明:

#パラメータ説明
#イベントイベント タイプ、user_view_card (ユーザーがメンバーシップ カードをクリック)
CardIdカード ID。
UserCardCode販売者が定義したコード値。カスタマイズされていないコードは空の文字列としてプッシュされます。
OuterStr加盟店定義の QR コード チャネル パラメータは、会員カードを開くためのこのスキャン コードを識別するために使用されます。ソースは特定のチャネル値の QR コードから取得されます
#FromUserName送信者アカウント (OpenID)CreateTimeメッセージの作成時間 (整数)。
#パラメータ説明
ToUserName開発者の WeChat ID。
MsgTypeメッセージ タイプ、イベント
Eventイベント タイプ、user_enter_session_from_card (ユーザーはカード クーポンから公式アカウント セッションに参加します)
#CardIdカード ID。
UserCardCodeコード コード。

Web デバッグ ツールを使用してこのインターフェイスをデバッグします


##2.9 会員カードのコンテンツ更新イベント

#ユーザーの会員カードのポイント残高が変更されると、WeChat はイベント通知をプッシュします。開発者。プッシュ 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>

パラメーターの説明:

#FromUserName送信者アカウント (OpenID)CreateTimeメッセージの作成時間 (整数)。
#パラメータ説明
ToUserName開発者の WeChat ID。
MsgTypeメッセージ タイプ、イベント
Eventイベント タイプ、update_member_card (会員カードのコンテンツ更新)
CardIdカード クーポン ID。
UserCardCodeコード コード。
ボーナスの変更ポイント値を変更しました。
ModifyBalance変更されたバランス値。

Web デバッグ ツールを使用してこのインターフェイスをデバッグします

##2.10 インベントリ アラーム イベント

#card_id の初期インベントリが 200 を超え、現在のインベントリが 100 以下の場合、ユーザーはクーポンを受信しようとすると、送信イベントがトリガーされます。販売者には、イベントが 12 時間ごとに送信されます。 

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

パラメータの説明:

##ToUserName開発者 WeChat ID##FromUserNameCreateTime MsgTypeイベントCardId

Web デバッグ ツールを使用してこのインターフェイスをデバッグします

##2.11 クーポン ポイント トランザクションの詳細イベント

#販売者の友人のクーポン ポイントが変更されると、WeChat サーバーはメッセージを販売者サーバーにプッシュします。 

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

パラメータの説明:

#パラメータ説明
送信者、WeChat
メッセージ作成時間 (整数)
メッセージ タイプ、イベント
イベント タイプ、card_sku_remind 在庫アラーム
#カードクーポンID
詳細アラーム詳細
##FromUserName送信者、WeChat#CreateTimeMsgTypeイベントOrderId##PayCoinCount##引かれる注文タイプメモ
#パラメータ説明
ToUserName開発者 WeChat ID
メッセージ作成時間 (整数)
メッセージ タイプ、イベント
イベントtype、card_pay_order クーポン ポイント取引詳細イベント
このプッシュに対応する注文番号
ステータスこの注文番号のステータス、ORDER_STATUS_WAITING 支払い待ち ORDER_STATUS_SUCC 支払い成功 ORDER_STATUS_FINANCE_SUCC トークン追加成功 ORDER_STATUS_QUANTITY_SUCC 在庫追加成功 ORDER_STATUS_HAS_REFUND コイン返金 ORDER_STATUS_REFUND_WAITING コイン返金確認待ち ORDER_STATUS_ROLLBACK 返金ed、システム障害 ORDER_STATUS_HAS_RECEIPT 請求書発行
CreateOrderTimeクーポンポイント購入時の決済用QRコード生成時間
##PayFinishTime クーポンポイント購入時、実際に決済が成功した時間
説明 支払い方法、通常は WeChat Pay のリチャージ
FreeCoinCount残りの無料クーポン ポイントの数
##残りの有料クーポンポイント数 #返金フリーコイン数この変更による無料クーポン ポイントの数
RefundPayCoinCountこれ時間 有料クーポンポイント数の変更
##OrderType# #ORDER_TYPE_SYS_ADD プラットフォーム ギフト クーポン ポイント ORDER_TYPE_WXPAY リチャージ クーポン ポイント ORDER_TYPE_REFUND 在庫未使用の返金クーポン ポイント ORDER_TYPE_REDUCE クーポン ポイントを在庫と交換 ORDER_TYPE_SYS_REDUCE プラットフォーム控除

システム ノートでは、口座開設報酬、ストア報酬、償却報酬、リチャージと控除など、この変更の理由が説明されています。 #ReceiptInfo
発行された請求書の詳細

Web デバッグ ツールを使用してこのインターフェイスをデバッグします

2.12 メンバーシップ カードのアクティベーション イベント プッシュ

ユーザーがワンクリックアクティベーションを通じて情報を送信し、クリックしてアクティベートすると、マーチャントはユーザーによってアクティベートされたイベントプッシュを受け取ります#

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


パラメータの説明

##開発者 WeChat ID OpenID 以降) CreateTime メッセージ作成時間 (整数) MsgType メッセージ タイプ、イベント
## パラメータ
CardId カード クーポン コード
Web デバッグ ツールを使用してインターフェイスをデバッグします

←
→

PHP中国語ウェブサイト

ホームページホームページコースコース記事記事に質問に質問辞書辞書マニュアルマニュアルダウンロードダウンロード検索検索APPダウンロード APPダウンロード