什么是人脸核身
用「证件信息 + 活体人脸」确认操作人是本人,常用于注册、签约、支付等高风险环节
人脸核身会把用户填写的姓名、身份证号提交给核身渠道,由渠道生成一条核身链接。 用户打开链接后按提示完成活体检测(眨眼、转头等动作)并进行人像比对, 渠道判定为同一人后返回结果。整个过程用户不需要下载 App,在手机浏览器内即可完成。 比对通过后,系统会按你提交的单号把结果回调到指定地址,业务侧据此放行或拒绝。
提交身份信息
业务系统调用接口,传入姓名与身份证号
获取核身链接
接口返回一条 H5 链接,有效期由渠道控制
用户完成核验
用户在链接内完成活体检测与人像比对
接收结果回调
结果按你提交的单号 POST 回回调地址
核心能力
两个核身渠道可选,结果留痕可查
腾讯云慧眼渠道
接入腾讯云慧眼 H5 核身,返回核身链接与核身流水号,适合在微信、浏览器等场景使用。
支付宝核身渠道
接入支付宝人脸认证(FACE 认证),同样返回核身链接,可按业务场景二选一。
活体检测与人像比对
由核身渠道完成活体检测,并将现场采集的人像与证件照片比对,判断是否本人。
身份证格式校验
接口提交前会校验身份证号格式(18 位,末位可为 X),格式不合法直接返回错误,不消耗次数。
H5 链接接入
接口只返回一条 H5 核身链接,业务侧跳转即可,无需集成 SDK,也无需自行采集人脸数据。
核身记录留痕
每次核身都记录渠道、单号、姓名、身份证与状态(待核验 / 通过 / 未通过),便于对账与排查。
接口说明
提交身份信息获取核身链接,核身完成后结果回调通知
// 请求(表单方式提交) realname = 张三 idcard = 11010119900307123X channel = tencentrealname // 或 alirealname outer_order_no = ORDER20240916001 // 你的业务单号 notify_url = https://你的域名/callback apiid = 12345 timestamp = 1726416000 sign = <签名> // 返回 { "code": 1, "msg": "获取成功!", "data": { "type": "tencentrealname", "user_id": 12345, "url": "https://.../api/web/login?..." } } // 核身完成后回调 notify_url { "orderNo": "ORDER20240916001", "status": 1 }
请求参数
| 参数 | 说明 |
|---|---|
realname | 真实姓名 |
idcard | 身份证号,18 位,末位可为 X(格式错误会直接返回错误) |
channel | 核身渠道:tencentrealname(腾讯云慧眼)或 alirealname(支付宝) |
outer_order_no | 你的业务单号,回调时会原样带回,用于关联订单 |
notify_url | 核身结果回调地址,结果以 POST 方式提交 |
apiid | 接口账户 ID |
timestamp | 当前时间戳,用于签名与防重放 |
sign | 签名值;签名规则与密钥请联系我们获取 |
返回字段中 url
即为核身链接,跳转到该地址后由用户完成核验。
回调中的 status
为 1 表示通过、-1 表示未通过。
计费与套餐
接口按次计费,调用前需保证次数包有余额
计费方式
1 次 / 次调用
每发起一次核身消耗 1 次额度
额度来源
次数包
购买套餐后充入账户次数包
额度不足
200001
返回错误码,不发起核身、不扣费
人脸核身基础型
¥120.00
含 100 次核身
人脸核身普及型
¥580.00
含 500 次核身
人脸核身企业型
¥1100.00
含 1000 次核身
每次调用前会检查次数包余额,余额大于 0 才扣减并发起核身;余额不足时直接返回错误码 200001,不会产生任何费用。
常见问题
接入前常被问到的几个问题
支持哪些核身渠道?
channel 参数指定。两个渠道都是 H5 方式,用户在手机浏览器内完成核验,无需安装 App。
用户必须本人操作吗?
怎么知道核验结果?
notify_url,字段为 orderNo(你传入的业务单号)与 status(1 通过 / -1 未通过)。同时每一次核身在系统中都有记录,包含渠道、单号与状态,可用于对账。
次数不够会怎样?
身份证号填错了会扣次数吗?
接入咨询
需要接口账户、签名密钥或联调协助,都可以联系我们
咨询热线
400-028-5578
电子邮箱
admin@onezon.cn
在线沟通
工作日 9:00 - 18:00