Dokumentasi pembangun platform awam WeChat / 微信认证事件推送

微信认证事件推送

微信认证事件推送

为了帮助公众号开发者获取公众号的认证状态,也为了第三方平台开发者获知旗下公众号的认证状态,微信公众平台提供了公众号认证过程中各个阶段的事件推送。

事件推送到哪里?

1、事件推送将会推送给公众号在公众平台官网开发者中心设置的服务地址中
2、如果公众号已将帐号管理权限集(因为该接口权限从属于帐号管理权限集)授权给第三方平台,那么将由第三方平台代公众号接收事件推送,具体是推送到第三方平台的公众号消息与事件接收URL

1474940890958483.jpg

请注意:

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有效期 (整形),指的是时间戳,表示已于该时间戳认证过期,需要重新发起微信认证