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

更新时间: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)

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

请求示例

curl
Java
Go

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+TIMEZONEyyyy-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+TIMEZONEyyyy-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

系统异常,请稍后重试

请稍后重试

 

反馈
目录
置顶