查询与用户授权记录(授权协议号)API

最新更新时间:2020.09.14 版本说明


通过authorization_code,商户查询与用户授权关系

接口说明

适用对象:直连商户

请求URL:https://api.mch.weixin.qq.com/v3/payscore/permissions/authorization-code/{authorization_code}

请求方式:GET

接口规则:https://wechatpay-api.gitbook.io/wechatpay-api-v3


path 指该参数为路径参数

query 指该参数需在请求URL传参

body 指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
服务ID service_id string[1, 32] query 该服务ID有本接口对应产品的权限。 
示例值:500001
授权协议号 authorization_code string[1, 32] path预授权成功时的授权协议号
示例值:1234323JKHDFE1243252

请求示例


https://api.mch.weixin.qq.com/v3/payscore/permissions/authorization-code/{authorization_code}

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
服务id service_id string[1, 32] 该服务ID有本接口对应产品的权限。 
示例值:2002000000000558128851361561536
公众号id appid string[1, 32] 与授权成功时记录的商户号绑定的appid(返回用户最近一次授权成功时记录的appid,不受当前请求参数影响)
示例值:wxd678efh567hg6787
商户号 mchid string[1, 32] 商户号(返回用户最近一次授权成功时记录的mchid,不受当前请求参数影响)
示例值:1230000109
用户标识 openid string[1, 128] 微信用户在商户对应appid下的唯一标识。 
示例值:oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
授权协议号 authorization_code string[1,32] 预授权成功时的授权协议号。
示例值:1275342195190894594
授权状态 authorization_state string[1, 16] 标识用户授权服务情况。
UNAVAILABLE:用户未授权服务
AVAILABLE:用户已授权服务
UNBINDUSER:未绑定用户(已经预授权但未完成正式授权)
示例值:UNAVAILABLE
授权通知地址 notify_url string[1,255] 授权通知地址
示例值:https://www.weixin.com
最近一次解除授权时间 cancel_authorization_time string[1.32] 最近一次解除授权时间,遵循rfc3339标准格式,格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE,YYYY-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss.sss表示时分秒毫秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35.120+08:00表示北京时间2015年05月20日13点29分35秒
示例值:2015-05-20T13:29:35.120+08:00
最近一次授权成功时间 authorization_success_time string[1,32] 最近一次授权成功时间,遵循rfc3339标准格式,格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE,YYYY-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss.sss表示时分秒毫秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35.120+08:00表示北京时间2015年05月20日13点29分35秒
示例值:2015-05-20T13:29:35.120+08:00

返回示例


{
  "service_id": "2002000000000558128851361561536",
  "appid": "wxd678efh567hg6787",
  "mchid": "1230000109",
  "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
  "authorization_code": "1275342195190894594",
  "authorization_state": "UNAVAILABLE",
  "notify_url": "https://www.weixin.com",
  "cancel_authorization_time": "2015-05-20T13:29:35.120+08:00",
  "authorization_success_time": "2015-05-20T13:29:35.120+08:00"
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEM_ERROR 系统错误 5开头的状态码都为系统问题,请使用相同参数稍后重新调用
400 PARAM_ERROR 参数错误 根据错误提示,传入正确参数
403 NO_AUTH 商户信息不合法 登录商户平台核对,传入正确信息
429 FREQUENCY_LIMITED 频率超限 请求量不要超过接口调用频率限制
400 INVALID_REQUEST 请求参数符合参数格式,但不符合业务规则 请确认相同单号是否使用了不同的参数
404 ORDER_NOT_ EXIST 订单不存在 确认入参,传入正确单据
400 INVALID_ORDER_STATE 单据状态错误 确认操作是否符合流程
400 ORDER_CANCELED 单据已取消 当前状态无需操作
400 ORDER_DONE 订单已完成 当前状态无需操作



版本说明

关闭
V1.1
2020年09月14日
1. 返回参数authorization_code调整为必填;
3. appid、mchid增加描述:返回参数最近一次授权成功的记录,不受当前请求参数影响。
V1.0
2020年07月20
查询与用户授权记录(授权协议号)接口上线

技术咨询

反馈有奖