生成授权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
【微信支付平台证书序列号】 请求参数中的敏感字段，需要使用微信支付平台证书公钥加密。请设置为该证书的证书序列号。详见敏感信息加解密

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

应答参数

200OK
openid 必填 string(64)
【微信用户OpenID】 微信用户OpenID
mchid 必填 string(32)
【商户号】 商户号
sub_mchid 必填 string(32)
【特约商户号】 特约商户号
token 必填 string(1024)
【token值】 token值
expires_in 必填 integer
【token有效时间】 token有效时间，单位秒

应答示例

200 OK

错误码

公共错误码

状态码	错误码	描述	解决方案
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	获取授权信息失败	获取授权信息失败，请重试