微工卡人脸核身

更新时间：2025.02.19

通过小程序拉起微工卡人脸核身。

注意

微工卡不需要用户确认即可跳转。

wx.navigateToMiniProgram

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

接口名称： wx.navigateToMiniProgram，详见小程序跳转API文档

工卡appid：wxd24d9057cd83d47a

path路径：/pages/card/authenticate

接口参数

PAth 路径参数

mchid 必填 string(32)

【服务商商户号】微信服务商商户的商户号，由微信支付生成并下发。

sub_mchid 必填 string(32)

【子商户号】微信服务商下特约商户的商户号，由微信支付生成并下发。

appid 选填 string(32)

【服务商应用ID】与服务商商户号有绑定关系的appid。应用ID和子商户应用ID其中必须有一个与当前小程序appid一致。

sub_appid 选填 string(32)

【子商户应用ID】与子商户商户号有绑定关系的appid。应用ID和子商户应用ID其中必须有一个与当前小程序appid一致。

openid 必填 string(64)

【用户标识】用户在商户对应appid下的唯一标识。

token 必填 string(64)

【预下单token】通过接口生成的预授权token。

authenticate_number 必填 string(64)

【商户单号】同核身预下单接口提交的商户系统内部的商家核身单号。

示例代码：

1wx.navigateToMiniProgram({
2  appId: 'wxd24d9057cd83d47a',
3  path: '/pages/card/authenticate?mchid=123456&sub_mchid=666666&appid=wx1234567889999&sub_appid=wx1234567000000&openid=o17o88-JPyaisuNH-8RXGwcfb4zE&token=qfq-34ewq257w_1re4re&authenticate_number=abcdefghijklmn',
4  success(res) {
5    // 打开成功
6  }
7})

核身成功返回结果

核身成功结果通过小程序带参返回上一个小程序的extraData 传递，具体参数如下：

msg_type 必填 string(64)

【消息类型】标识本次返回结果的消息类型，此处为人脸核身的消息，为： AUTHENTICATE。

authenticate_state 选填 string(64)

【核身状态】核身状态，核身成功时返回，此字段固定为 AUTHENTICATE_SUCCESS：核身成功。

authenticate_time 选填 uint64

【核身时间】核身时间（时间戳），核身成功时返回。

获取返回结果示例：

通过在 app.js 中调用 App 方法注册小程序实例时，绑定 onShow 函数获取返回结果。

详细的参数含义和使用请参考 App参考文档。

示例代码：

1App({
2    onShow (options) {
3        // 场景数值为1038（从其他小程序跳回），跳回的小程序appid为wxd24d9057cd83d47a
4        if (options.scene === 1038 && options.referrerInfo && options.referrerInfo.appId === 'wxd24d9057cd83d47a') {
5            const resp = options.referrerInfo.extraData || {};
6            if (resp.msg_type === 'AUTHENTICATE' && resp.authenticate_time) {
7                // TODO 处理人脸核身成功返回结果
8            }
9        }
10    },
11})

错误码

错误码	描述	解决方案
1001	mchid不合法	传入正确的服务商商户号
1002	appid不合法	appid和sub_appid至少传入一个
1003	小程序来源不合法	appid和sub_appid其中必须有一个与当前小程序appid一致
1004	openid不合法	传入正确的openid
1005	预下单token不合法	传入正确的预下单token
1006	authenticate_number不合法	传入与预下单时一致且未达终态的authenticate_number

文档是否有帮助

更多支持

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