企业商户查询企业员工开通授权状态

更新时间：2025.05.09

企业商户查询企业员工开通授权状态。该接口允许服务商查询指定出资子商户下特定员工的企业支付授权状态，包括授权状态、授权时间和解除授权时间等信息。服务商可通过此接口确认员工是否已开通企业支付功能，是后续发放额度卡的前提条件。

接口说明

支持商户：【普通服务商】

请求方式：【GET】/v3/webizpay/users/{user_id}/authorization-state

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

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

请求参数

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

path 路径参数

user_id 　必填 string(32)

【企业员工 ID】商户企业员工ID，由企业系统提供的唯一标识员工的ID。要求6-32个字符内，只能是数字、大小写字母_-|* 且在同一个商户号下唯一。

query 查询参数

sp_mchid 　必填 string(32)

【服务商商户号】是由微信支付系统生成并分配给每个服务商的唯一标识符，具体请参考服务商模式开发必要参数说明。

sub_mchid 　必填 string(32)

【出资子商户号】由服务商为子商户进件后获取，具体请参考服务商模式开发必要参数说明。

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/webizpay/users/123456/authorization-state?sp_mchid=12341234&sub_mchid=43214321 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

sp_mchid 　必填 string(32)

【服务商商户号】服务商商户号，具有企业支付服务商资质的微信支付商户号，由商户请求时传入

sub_mchid 　必填 string(32)

【出资子商户号】出资子商户号，企业支付的出资方商户号，由商户请求时传入

user_id 　必填 string(32)

【商户企业员工ID】商户企业员工ID，由企业系统提供的唯一标识员工的ID，由商户请求时传入

employee_list 　选填 array[object]

【微信授权关系列表】微信授权关系列表，包含该员工所有的微信企业支付授权关系，若此商户下，相同企业员工ID没有开通过企业支付，则数组长度为0

属性

employee_id 　必填 string(64)

【微信授权关系 ID】微信授权关系ID，微信支付平台生成的唯一标识授权关系的ID，用于后续额度卡发放、注销等操作
示例：WeBizPay_a968402a-73bb-43e2-9e1a-8371b0ca3d7c

authorization_state 　必填 string

【授权状态】授权状态，表示员工授权关系是否有效，包括已授权(AUTHORIZED)和已解除授权(REVOKED)两种状态

可选取值

AUTHORIZED: 已授权
REVOKED: 已解除授权

authorization_time 　必填 string

【授权时间】授权时间，员工完成授权操作的时间。
格式要求：
需遵循rfc3339标准格式：yyyy-MM-DDTHH:mm:ss+TIMEZONE。yyyy-MM-DD 表示年月日；T 字符用于分隔日期和时间部分；HH:mm:ss 表示具体的时分秒；TIMEZONE 表示时区（例如，+08:00 对应东八区时间，即北京时间）。
示例：2015-05-20T13:29:35+08:00 表示北京时间2015年5月20日13点29分35秒。

authorization_revoked_time 　必填 string

【解除授权时间】解除授权时间，员工或企业解除授权的时间。
格式要求：
需遵循rfc3339标准格式：yyyy-MM-DDTHH:mm:ss+TIMEZONE。yyyy-MM-DD 表示年月日；T 字符用于分隔日期和时间部分；HH:mm:ss 表示具体的时分秒；TIMEZONE 表示时区（例如，+08:00 对应东八区时间，即北京时间）。
示例：2015-05-20T13:29:35+08:00 表示北京时间2015年5月20日13点29分35秒。

应答示例

200 OK

1{
2  "sp_mchid" : "12341234",
3  "sub_mchid" : "43214321",
4  "user_id" : "employee123",
5  "employee_list" : [
6    {
7      "employee_id" : "WeBizPay_a968402a-73bb-43e2-9e1a-8371b0ca3d7c",
8      "authorization_state" : "AUTHORIZED",
9      "authorization_time" : "2018-06-08T10:34:56+08:00",
10      "authorization_revoked_time" : "2018-06-08T10:34:56+08:00"
11    }
12  ]
13}
14

错误码

公共错误码

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

文档是否有帮助

更多支持

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