生成授权token

更新时间：2025.01.09

生成授权token信息

接口说明

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

请求方式：【POST】/v3/payroll-card/tokens

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

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

请求参数

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

Wechatpay-Serial 　必填　string

【微信支付公钥ID】或【微信支付平台证书序列号】请求参数中的敏感字段，需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引

body 包体参数

openid 　必填 string(64)

【用户OpenID】用户OpenID

appid 　选填 string(32)

【服务商AppID】当输入服务商AppID时，会校验其与服务商商户号的绑定关系。
服务商AppID和与特约商户AppID至少输入一个，且必须要有拉起微工卡小程序时使用的AppID。

sub_mchid 　必填 string(32)

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

sub_appid 　选填 string(32)

【特约商户AppID】当输入特约商户AppID时，会校验其与特约商户号的绑定关系。
服务商AppID和与特约商户AppID至少输入一个，且必须要有拉起微工卡小程序时使用的AppID。

user_name 　必填 string(1024)

【用户实名】用户实名信息，按照APIV3标准加密该字段

id_card_number 　必填 string(1024)

【用户证件号】用户证件号，按照APIV3标准加密该字段

employment_type 　选填 string

【用工类型】微工卡服务仅支持用于与商户有用工关系的用户，需明确用工类型；参考值：长期用工：LONG_TERM_EMPLOYMENT，短期用工：SHORT_TERM_EMPLOYMENT，合作关系：COOPERATION_EMPLOYMENT

可选取值：

LONG_TERM_EMPLOYMENT: 长期用工：有劳务合同关系的长期用工

SHORT_TERM_EMPLOYMENT: 短期用工：有劳务合同关系的短期用工

COOPERATION_EMPLOYMENT: 合作关系：有业务服务、合作关系的人员

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/payroll-card/tokens \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "openid" : "onqOjjmo8wmTOOtSKwXtGjg9Gb58",
9    "appid" : "wxa1111111",
10    "sub_mchid" : "1111111",
11    "sub_appid" : "wxa1111111",
12    "user_name" : "LP7bT4hQXUsOZCEvK2YrSiqFsnP0oRMfeoLN0vBg",
13    "id_card_number" : "7FzH5XksJG3a8HLLsaaUV6K54y1OnPMY5",
14    "employment_type" : "LONG_TERM_EMPLOYMENT"
15  }'

应答参数

200 OK

openid 　必填 string(64)

【微信用户OpenID】微信用户OpenID

mchid 　必填 string(32)

【商户号】商户号

sub_mchid 　必填 string(32)

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

token 　必填 string(1024)

【token值】token值

expires_in 　必填 integer

【token有效时间】token有效时间，单位秒

应答示例

200 OK

1{
2  "openid" : "onqOjjmo8wmTOOtSKwXtGjg9Gb58",
3  "mchid" : "1111111",
4  "sub_mchid" : "1111111",
5  "token" : "abcdefghijklmn",
6  "expires_in" : 1800
7}

错误码

公共错误码

状态码	错误码	描述	解决方案
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	GEN_TOKEN_ERROR	生成token失败	生成token操作失败，请重试
403	MERCHANT_INFO_ERROR	获取商户信息失败	获取商户信息失败，请重试
403	AUTH_INFO_ERROR	获取授权信息失败	获取授权信息失败，请重试

文档是否有帮助

更多支持

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