查询微工卡授权关系

更新时间：2024.11.18

查询商户和微信支付用户的微工卡授权关系

接口说明

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

请求方式：【GET】/v3/payroll-card/relations/{openid}

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

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

请求参数

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

path 路径参数

openid 　必填 string(64)

【用户OpenID】微信用户OpenID

query 查询参数

sub_mchid 　必填 string(32)

【特约商户号】特约商户号

appid 　选填 string(32)

【服务商AppID】当输入服务商AppID时会校验其与服务商商户号绑定关系。
服务商AppID和特约商户AppID至少输入一个。

sub_appid 　选填 string(32)

【特约商户AppID】当输入特约商户AppID时会校验其与特约商户号关系。
特约商户AppID和服务商AppID至少输入一个。

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/payroll-card/relations/onqOjjmo8wmTOOtSKwXtGjg9Gb58?sub_mchid=1111111&appid=wxa1111111&sub_appid=wxa1111111 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json"

应答参数

200 OK

openid 　必填 string(64)

【用户OpenID】用户OpenID

mchid 　必填 string(32)

【商户号】商户号

sub_mchid 　必填 string(32)

【特约商户号】特约商户号

authorize_state 　必填 string(32)

【授权状态】授权状态：UNAUTHORIZED：未授权 AUTHORIZED：已授权 DEAUTHORIZED：已取消授权

authorize_time 　选填 string(32)

【授权时间】授权时间

deauthorize_time 　选填 string(32)

【取消授权时间】取消授权时间，遵循RFC3339标准格式，格式为yyyy-MM-DDThh:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。

register_state 　必填 string

【开通状态】微工卡的开通状态：UNREGISTERED：未开通；REGISTERED：已开通；CLOSED：已关闭

可选取值：

UNDEFINED: 未定义状态

UNREGISTERED: 未开通

REGISTERED: 已开通

CLOSED: 已关闭

register_time 　选填 string(32)

【开通时间】开通时间，未开通时不返回。遵循RFC3339标准格式，格式为yyyy-MM-DDThh:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。

close_time 　选填 string(32)

【关闭时间】关闭时间，仅当开通状态是已关闭时返回。遵循RFC3339标准格式，格式为yyyy-MM-DDThh:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。

应答示例

200 OK

1{
2  "openid" : "onqOjjmo8wmTOOtSKwXtGjg9Gb58",
3  "mchid" : "1111111",
4  "sub_mchid" : "1111111",
5  "authorize_state" : "UNAUTHORIZED",
6  "authorize_time" : "2015-05-20T13:29:35+08:00",
7  "deauthorize_time" : "2015-05-20T13:29:35+08:00",
8  "register_state" : "UNDEFINED",
9  "register_time" : "2015-05-20T13:29:35+08:00",
10  "close_time" : "2015-05-22T13:29:35+08:00"
11}
12

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
400	PARAM_MISSING	参数缺失	参考API文档要求输入参数（AppID和sub_appid必填一个）
400	PARAM_ILLEGAL	参数值不合法	参考API文档要求输入参数
401	MCH_TICKET_ILLEGAL	服务商票据校验失败	参考API文档要求输入正确服务商或特约商户
400	AUTH_ERROR	校验身份或者产品权限失败	参考API文档要求输入参数，MA关系必须匹配，服务商需有产品受理权限
403	MERCHANT_INFO_ERROR	获取商户信息失败	获取商户信息失败，请重试
403	AUTH_INFO_ERROR	获取授权信息失败	获取授权信息失败，请重试

文档是否有帮助

更多支持

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