② 散户扫脸(实人认证)
散户入驻第一步:调本接口拿到工行扫脸认证页,散户本人刷脸 + 活体检测。页面类:POST 进 → 拿 pageUrl → 跳过去。下面是工行全部字段,原样传;标「中台填」的开灵自动补。
接口
POST https://openapi.kailingteck.com/api/v1/icbc/receiver/face-auth
鉴权:X-App-Key + X-Sign + X-Timestamp。
请求参数(工行全字段 · 原样传)
| 工行字段 | 必填 | 大白话说明 |
|---|---|---|
appId | 中台填 | 平台编号(开灵自动填,你不用传) |
outUserId | 必填 | 散户在你们系统的唯一编号 |
transNo | 必填 | 本次认证的流水号(你们自己生成、唯一;查结果时要用它) |
custName | 必填 | 散户姓名 |
certNo | 必填 | 身份证号(目前仅支持身份证) |
mobile | 必填 | 手机号(认证过程中发验证短信) |
callbackUrl | 中台填 | 认证结果通知地址(开灵自动填成回调口) |
jumpUrl | 必填 | 认证通过后跳回你们页面的地址 |
failJumpUrl | 必填 | 认证失败后跳回你们页面的地址(用于重新发起) |
authScene | 选填 | 认证场景:01-反向开票 / 13-灵活用工首次注册 / 14-灵活用工结算 |
扫脸是散户本人自己刷脸,不用登录电子税务局(那是企业授权的事)。transNo 记好,③ 查结果时要用同一个。
返回
{ "code": "CYT_00000", "data": { "pageUrl": "https://…/redirect/rxxx", "mock": false } }页面类:前端 location.href = pageUrl 跳工行扫脸页;结果用 ③ 查扫脸结果 接口确认。