⓪ 实人认证(独立刷脸核验)

不涉及开票的纯身份核验:发一个链接给本人,现场人脸与公安基准照比对 + 手机号短信验证码,两项都过才算通过。司机打卡、领料签收、现场确认这类「每次都要一个独立核验结果」的场景用它。★与②散户入驻的区别:入驻一个人只做一次、拿的是入驻状态;这里每次都是一次新的、独立的核验结果。被认证人不需要有工商银行卡、也不需要在工行开过户。

属「工商银行 · 业务型接口」——底层编排乐企直联原子接口,你只调这一个。

发起认证

接口 · 发起认证(页面类)

POST  https://openapi.kailingteck.com/api/v1/rinv/face/start

鉴权:X-App-Key + X-Timestamp + X-Sign(= sha256(appKey + 时间戳 + 报文 + appSecret))。

请求参数

字段	必填	大白话说明
`outUserId`	必填	被认证人在你方的唯一编号(同一个人请长期保持同一个编号,工行以它识别人)
`custName`	必填	姓名
`certNo`	必填	身份证号(工行目前仅支持身份证)
`mobile`	必填	本人手机号——认证过程中工行会往这个号发短信验证码,填错就做不完
`jumpUrl`	必填	认证成功后页面「确认」按钮的回跳地址(可以带参数,便于你识别是哪次打卡)
`failJumpUrl`	选填	认证失败后的回跳地址;不传则与 jumpUrl 相同
`transNo`	选填	本次认证流水号。★工行要求全局唯一、不可重复;不传则平台自动生成一个,建议你自己传业务单号方便对账
`callbackUrl`	选填	你方接收认证结果通知的地址。传了平台就把工行的结果转发给你;不传则只能靠主动查询
`authScene`	选填	工行认证场景字典,不传默认 01

请求示例

{
  "outUserId": "DRIVER001",
  "custName": "张三",
  "certNo": "500101199001011234",
  "mobile": "13800001234",
  "jumpUrl": "https://你的系统/checkin/done?id=8899",
  "transNo": "CHECKIN20260923001",
  "callbackUrl": "https://你的系统/notify/face"
}

所有接口都用同一层信封:code／msg／requestId／timestamp／data。业务字段都在 data 里,下表列的就是 data 的内容。code 为 CYT_00000 表示调用成功。

返回参数(data)

字段	大白话说明
`pageUrl`	★把这个地址交给本人在手机上打开,直接 location.href 过去即可——工行的签名和表单由平台代办,你不用处理
`transNo`	本次认证流水号,查结果、对回调都用它
`outUserId`	回显

返回示例(成功)

{
  "code": "CYT_00000",
  "msg": "success",
  "data": {
    "transNo": "CHECKIN20260923001",
    "outUserId": "DRIVER001",
    "pageUrl": "https://openapi.kailingteck.com/api/v1/icbc/redirect/rxxxx",
    "mock": false
  }
}

异常与报错

情形	含义与处理
transNo 已被使用过	工行要求每次认证流水号全局唯一,换一个新的
页面打不开摄像头	让本人用手机浏览器或微信打开并允许摄像头权限;链接必须整行完整转发,断行丢参数会报错

前端怎么用

const r = await post('/api/v1/rinv/face/start', body);
location.href = r.data.pageUrl;   // 或把 pageUrl 转成二维码让本人扫

★pageUrl 即用即取:链接里含工行签名的时间戳,有时效,别提前很久生成放着。★transNo 重复会被工行直接拒绝,平台也会先帮你拦一道(返回 400 提示已使用过)。

查认证结果

接口 · 查认证结果(数据类)

POST  https://openapi.kailingteck.com/api/v1/rinv/face/status