微工卡核身预下单（流程中完成授权）

更新时间：2025.01.09

本接口适用于用户需同步完成服务开通、授权及身份核验的场景。在拉起微工卡前端服务为用户核身前，需调用本接口预下单，下单成功后才能进行核身。如此时用户未开通微工卡服务或未完成对商户的授权，则先完成开通、授权，同步完成身份核验，并提供可信的核验结果。

接口说明

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

请求方式：【POST】/v3/payroll-card/authentications/pre-order-with-auth

请求域名：【主域名】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。

authenticate_number 　必填 string(64)

【商家核身单号】商户系统内部的商家核身单号，要求此参数只能由数字、大小写字母组成，在服务商内部唯一

project_name 　必填 string(128)

【项目名称】该劳务活动的项目名称

employer_name 　必填 string(128)

【用工单位名称】该工人所属的用工企业

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: 合作关系：有业务服务、合作关系的人员

authenticate_type 　选填 string

【核身类型】核身类型

可选取值：

NORMAL: 普通核身类型，可用于用户注册认证等

SIGN_IN: 签到打卡类型，需要传项目信息

INSURANCE: 投保类型

CONTRACT: 签约类型

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/payroll-card/authentications/pre-order-with-auth \
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    "authenticate_number" : "mcdhehfgisdhfjghed39384564i83",
13    "project_name" : "某项目",
14    "employer_name" : "某用工企业",
15    "user_name" : "LP7bT4hQXUsOZCEvK2YrSiqFsnP0oRMfeoLN0vBg",
16    "id_card_number" : "7FzH5XksJG3a8HLLsaaUV6K54y1OnPMY5",
17    "employment_type" : "LONG_TERM_EMPLOYMENT",
18    "authenticate_type" : "NORMAL"
19  }'
20

应答参数

200 OK

authenticate_number 　必填 string(64)

【商家核身单号】商户系统内部的商家核身单号，要求此参数只能由数字、大小写字母组成，在服务商内部唯一

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  "authenticate_number" : "mcdhehfgisdhfjghed39384564i83",
3  "openid" : "onqOjjmo8wmTOOtSKwXtGjg9Gb58",
4  "mchid" : "1111111",
5  "sub_mchid" : "1111111",
6  "token" : "abcdefghijklmn",
7  "expires_in" : 300
8}

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	商家核身单号已使用，请调整后再试	请调整核身单号后重新请求
400	INVALID_REQUEST	该商户当日核身下单已超限额	同一用户在同一商户单日下单不可超过20次，请次日重试
400	INVALID_REQUEST	校验商户身份失败	请检查商户号、AppID、签名等相关参数是否正确
400	INVALID_REQUEST	校验商户身份或者产品权限失败	请检查商户号、AppID、签名等相关参数是否正确，并检查商户和产品授权关系是否正确
400	INVALID_REQUEST	下单用工类型与授权用工类型不匹配	请检查该用户预下单时所用的用工类型与授权时所用的用工类型是否一致，需保持一致才能校验通过
400	INVALID_REQUEST	核身下单过于频繁	请检查是否重复请求
400	PARAM_ERROR	参数值不正确，必填参数为空	请检查所传参数是否正确，是否有遗漏

文档是否有帮助

更多支持

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