从业机构查询与用户授权记录（授权协议号）

更新时间：2024.11.18

从业机构通过调用该接口，使用authorization_code查询与用户授权关系

接口说明

支持商户：【从业机构（支付机构）】

请求方式：【GET】/v3/payscore/acquiringbank/permissions/authorization-code/{authorization_code}

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

path 路径参数

authorization_code 　必填 string(32)

【授权协议号】要求此参数只能由数字、大小写字母_-|*组成，且在同一个商户号下唯一

query 查询参数

service_id 　必填 string(32)

【服务ID】该服务ID有本接口对应产品的权限.

channel_id 　必填 string(32)

【渠道商商户号】渠道商商户号

sub_mchid 　必填 string(32)

【子商户商户号】子商户商户号

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/payscore/acquiringbank/permissions/authorization-code/1234323JKHDFE1243252?service_id=500001&channel_id=1230000109&sub_mchid=1230000109 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json"

应答参数

200 OK

service_id 　必填 string(32)

【服务ID】该服务ID有本接口对应产品的权限。

appid 　必填 string(32)

【公众号ID】微信公众平台分配的与传入的商户号建立了支付绑定关系的AppID，可在公众平台查看绑定关系，此参数需在本系统先进行配置。

mchid 　必填 string(32)

【商户号】调用接口提交的商户号

openid 　选填 string(128)

【用户标识】AppID下的用户标识

authorization_code 　选填 string(32)

【授权协议号】预授权成功时的授权协议号

authorization_state 　必填 string(16)

【授权状态】标识用户授权服务情况. UNAVAILABLE: 用户未授权服务, AVAILABLE: 用户已授权服务, UNBINDUSER: 未绑定用户

notify_url 　选填 string(255)

【授权通知地址】授权通知地址

cancel_authorization_time 　选填 string(64)

【最近一次解除授权时间】最近一次解除授权时间，遵循Rfc399标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。

authorization_success_time 　选填 string(64)

【最近一次授权成功时间】最近一次授权成功时间，遵循Rfc399标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。

sub_mchid 　选填 string(32)

【子商户商户号】子商户商户号

sub_appid 　选填 string(32)

【子商户的公众号ID】微信公众平台分配的与传入的子商户商户号建立了支付绑定关系的AppID，可在公众平台查看绑定关系，此参数需在本系统先进行配置。

sub_openid 　选填 string(128)

【子商户的用户标识】子商户的AppID下的用户标识

user_label 　选填 string(32)

【用户标签】用户标签，仅授权成功时返回（并且不保证一定返回）枚举值：A、B、C（其中A>B>C）

channel_id 　选填 string(32)

【渠道商商户号】渠道商商户号

user_risk_level 　选填 integer

【用户分层】用户分层，仅授权成功时返回，数值越高，用户风险越低

risk_level_version 　选填 integer

【分层版本】表示返回的“用户分层”归属于的数据版本

应答示例

200 OK

1{
2  "service_id" : "2002000000000558128851361561536",
3  "appid" : "wxd678efh567hg6787",
4  "mchid" : "1230000109",
5  "openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
6  "authorization_code" : "1275342195190894594",
7  "authorization_state" : "UNAVAILABLE",
8  "notify_url" : "https://www.weixin.com",
9  "cancel_authorization_time" : "2015-05-20T13:29:35+08:00",
10  "authorization_success_time" : "2015-05-20T13:29:35+08:00",
11  "sub_mchid" : "1230000109",
12  "sub_appid" : "wxd678efh567hg6787",
13  "sub_openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
14  "user_label" : "A",
15  "channel_id" : "1230000109",
16  "user_risk_level" : 1,
17  "risk_level_version" : 1
18}

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

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

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服