授权通知参数说明 -凯发app官方网站

接入准备

接入业务

通过模板开发小程序

代开发小程序

step-4：商家创建&授权小程序

step-5：商家开通产品

step-6：代开发&提审小程序

开发接入扩展

faq

代开发网页/移动应用

更新时间：2024-07-16 16:32:57

订阅更新

我的文档

设置

当商家的应用成功授权给第三方应用时，第三方应用开发设置所配置的应用网关会收到授权通知，服务商可解析该通知，获取授权应用与 app_auth_token 的对应关系。

有关授权的常见问题，可查看

。

说明：

●

服务商向商家发送授权链接（或授权二维码）的授权方式不会触发授权通知，商家订购模板服务时授权、服务商协助商家创建小程序时授权或商家签约即授权等场景，会触发授权通知。

●

授权通知是 post 请求，参数在 post body 中。

授权通知示例

isv_gateway_url?****&data={"headers":{"user-agent":"mozilla/4.0","content-type":"application/x-www-form-urlencoded; charset=utf-8"},"data":{"notify_type":"open_app_auth_notify","charset":"utf-8","biz_content":"{\\"notify_context\\":{\\"trigger\\":\\"appstore\\"},\\"detail\\":{\\"app_auth_token\\":\\"202004bb9d3901a7d39d4350a49fb00000000001\\",\\"user_id\\":\\"20881200000000002\\",\\"re_expires_in\\":32140800,\\"auth_time\\":1587573752655,\\"app_refresh_token\\":\\"202004bb81e2730b7ecc4295a551e00000000001\\",\\"auth_app_id\\":\\"20210000002\\",\\"app_id\\":\\"20190000000\\",\\"expires_in\\":31536000,\\"app_auth_code\\":\\"fa861f9d7032404bae53f54247000001\\"},\\"error\\":{}}","notify_time":"2020-04-23 00:42:32","sign":"****","auth_app_id":"2021000000000002","app_id":"2019000000000000","version":"1.0","sign_type":"rsa2","notify_id":"2020042300222004232009800000000007","status":"execute_auth"},"method":"post","pid":"2088500000000002","url":"https://*****/gateway.do","timeout":16000}

整理

data

参数，按行显示如下：

"data":

{"notify_type":"open_app_auth_notify",

"charset":"utf-8",

"biz_content":"{

\\"notify_context\\":{\\"trigger\\":\\"appstore\\"},

\\"detail\\":{

\\"app_auth_token\\":\\"202004bb9d3901a7d39d4350a49fb00000000001\\",

\\"user_id\\":\\"20881200000000002\\",

\\"re_expires_in\\":32140800,

\\"auth_time\\":1587573752655,

\\"app_refresh_token\\":\\"202004bb81e2730b7ecc4295a551e00000000001\\",

\\"auth_app_id\\":\\"20210000002\\",

\\"app_id\\":\\"20190000000\\",

\\"expires_in\\":31536000,

\\"app_auth_code\\":\\"fa861f9d7032404bae53f54247000001\\"

\\"error\\":{}

}",

"notify_time":"2020-04-23 00:42:32",

"sign":"****",

"auth_app_id":"2021000000000002",

"app_id":"2019000000000000",

"version":"1.0",

"sign_type":"rsa2",

"notify_id":"2020042300222004232009800000000007",

"status":"execute_auth"

}

授权通知字段详解

公共通知字段

若 notify_type=open_app_auth_notify 且 status=execute_auth 表示开放平台应用授权发生了重新授权。

字段名	字段说明	是否必传	备注
notify_id	通知校验 id，唯一标识一笔通知	是	相同 notify_id 称之为同一笔通知。
notify_type	通知类型	是	授权变更时的notify_type值为：open_app_auth_notify。
status	业务状态	否	授权变更时的status值为：execute_auth。
notify_time	通知发送时间	是	通知发送时间 utc 8，格式为yyyy-mm-dd hh:mm:ss。若为其它时区的服务器时间请自行转换。
charset	字符集	是	该字符集和支付宝发送http报文的content-type的字符集一致，所有涉及字符集的地方均会用于做urldecode，签名验签。
version	版本号	是	目前固定为1.0，商家仅应该识别version参数为空或者version=1.0的通知报文，其它应该拒绝
app_id	第三方应用的 appid	是	appid 是通知接收方（不一定对应业务方）。
auth_app_id	授权小程序的 appid	否	主动通知的场景下不会有该参数
sign	签名	是	支付宝对发出的通知进行的 rsa 签名。
sign_type	签名类型	是	目前支持rsa2（推荐使用）和rsa，该参数不参与签名。
biz_content	该笔通知的业务内容	是	针对应用授权变更通知，应用授权变更通知的内容参考以下表格。

biz_content

detail：授权详情

字段名	字段说明	是否必传	示例
app_id	被授权方应用 id（一般指第三方应用的 appid）	是	20190000000
auth_app_id	授权方的应用 id（一般指商家小程序应用的 appid）	是	20210000002
auth_time	授权发生时间，通知接受方需要根据auth_time 做令牌幂等	是	1491746302568
app_auth_code	应用授权码（兼容用），该参数提供给通知接收方用于复用之前的换码逻辑，新接入方推荐直接使用报文中的 app_auth_token 即可	是	252a889e49af4e6cbtests17ae053x80
app_auth_token	应用授权令牌	是	201603bb6e8df928test473d9d4c94d57d5c0x00
expires_in	应用授权令牌失效时间，单位到秒	是	123456
app_refresh_token	刷新令牌	是	201603bbdeb7d0ab1testbe898432a6490dfbx00
re_expires_in	刷新令牌失效时间，单位到秒	是	123456
user_id	授权商家的 user_id	是	20881200000000002

notify_context：授权通知上下文信息

字段名	字段说明	是否必传	示例
trigger	授权触发者	是	比如服务市场的服务订购通知，trigger 为 appstore。
trigger_context	授权触发者相关联的上下文，具体取值和 trigger 有关。	否	目前值为空。

error：相关的业务错误提示

字段名	字段说明	是否必传	示例
appstore_online_pay	若服务商签约了特殊的产品，且该产品的授权前置条件不满足则会有该值。目前仅有签约了口碑的“在线购买/口碑商品”产品的服务商可能会收到该错误码。	否	lack_face_to_face

appstore_online_pay 的错误码

错误码	说明	凯发app官方网站的解决方案
fail	系统错误，由于未知原因导致的系统错误	建议系统服务商联系并引导商家重新授权解决来解决。
unexpected_certify_grade	商家的个人认证等级不够	通知联系引导商家完成实名认证，再重新授权。说明：个人用户完成个人实名认证，企业用户完成企业实名认证，可查看支付宝账号注册认证。
merchant_discard	商家已经被清退；被清退的商家无法进行签约和发布商品	-
lack_face_to_face	商家未签约当面付	建议联系引导商家完成口碑开店流程之后，再重新授权。

相关问题