微信認證事件推送

為了幫助公眾號開發者獲取公眾號的認證狀態,也為了第三方平臺開發者獲知旗下公眾號的認證狀態,微信公眾平臺提供了公眾號認證過程中各個階段的事件推送。

事件推送到哪里?

1、事件推送將會推送給公眾號在公眾平臺官網開發者中心設置的服務地址中
2、如果公眾號已將帳號管理權限集(因為該接口權限從屬于帳號管理權限集)授權給第三方平臺,那么將由第三方平臺代公眾號接收事件推送,具體是推送到第三方平臺的公眾號消息與事件接收URL

微信資質認證

請注意:

1、資質認證成功后,公眾號就獲得了認證相關接口權限,資質認證成功一定發生在名稱認證成功之前
2、名稱認證成功后,公眾號才在微信客戶端中獲得打勾認證標識

目錄

1 資質認證成功(此時立即獲得接口權限)

2 資質認證失敗

3 名稱認證成功(即命名成功)

4 名稱認證失敗(這時雖然客戶端不打勾,但仍有接口權限)

5 年審通知

6 認證過期失效通知


資質認證成功(此時立即獲得接口權限)

推送XML數據包示例:

<xml><ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1442401156</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[qualification_verify_success]]></Event>
<ExpiredTime>1442401156</ExpiredTime>
</xml> 

參數說明

參數 描述
ToUserName 開發者微信號
FromUserName 發送方帳號(一個OpenID,此時發送方是系統帳號)
CreateTime 消息創建時間 (整型),時間戳
MsgType 消息類型,event
Event 事件類型 qualification_verify_success
ExpiredTime 有效期 (整形),指的是時間戳,將于該時間戳認證過期


   

資質認證失敗

推送XML數據包示例:

<xml><ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1442401156</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[qualification_verify_fail]]></Event>
<FailTime>1442401122</FailTime>
<FailReason><![CDATA[by time]]></FailReason>
</xml>

參數說明

參數 描述
ToUserName 開發者微信號
FromUserName 發送方帳號(一個OpenID,此時發送方是系統帳號)
CreateTime 消息創建時間 (整型),時間戳
MsgType 消息類型,event
Event 事件類型 qualification_verify_fail
FailTime 失敗發生時間 (整形),時間戳
FailReason 認證失敗的原因


    

名稱認證成功(即命名成功)

推送XML數據包示例:

<xml><ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1442401093</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[naming_verify_success]]></Event>
<ExpiredTime>1442401093</ExpiredTime>
</xml> 

參數說明

參數 描述
ToUserName 開發者微信號
FromUserName 發送方帳號(一個OpenID,此時發送方是系統帳號)
CreateTime 消息創建時間 (整型),時間戳
MsgType 消息類型,event
Event 事件類型 naming_verify_success
ExpiredTime 有效期 (整形),指的是時間戳,將于該時間戳認證過期

名稱認證失敗(這時雖然客戶端不打勾,但仍有接口權限)

推送XML數據包示例:

<xml><ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1442401061</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[naming_verify_fail]]></Event>
<FailTime>1442401061</FailTime>
<FailReason><![CDATA[by time]]></FailReason>
</xml>

參數說明

參數 描述
ToUserName 開發者微信號
FromUserName 發送方帳號(一個OpenID,此時發送方是系統帳號)
CreateTime 消息創建時間 (整型),時間戳
MsgType 消息類型,event
Event 事件類型 naming_verify_fail
FailTime 失敗發生時間 (整形),時間戳
FailReason 認證失敗的原因

年審通知

推送XML數據包示例:

<xml><ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1442401004</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[annual_renew]]></Event>
<ExpiredTime>1442401004</ExpiredTime>
</xml>

參數說明

參數 描述
ToUserName 開發者微信號
FromUserName 發送方帳號(一個OpenID,此時發送方是系統帳號)
CreateTime 消息創建時間 (整型),時間戳
MsgType 消息類型,event
Event 事件類型 annual_renew,提醒公眾號需要去年審了
ExpiredTime 有效期 (整形),指的是時間戳,將于該時間戳認證過期,需盡快年審

認證過期失效通知

推送XML數據包示例:

<xml><ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1442400900</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[verify_expired]]></Event>
<ExpiredTime>1442400900</ExpiredTime>
</xml>

參數說明

參數 描述
ToUserName 開發者微信號
FromUserName 發送方帳號(一個OpenID,此時發送方是系統帳號)
CreateTime 消息創建時間 (整型),時間戳
MsgType 消息類型,event
Event 事件類型 verify_expired
ExpiredTime 有效期 (整形),指的是時間戳,表示已于該時間戳認證過期,需要重新發起微信認證