人脸核身

提交姓名与身份证号即可获取核身链接,由用户完成活体检测与人像比对, 比对结果通过回调返回给业务系统。支持腾讯云慧眼与支付宝两个核身渠道。

什么是人脸核身

用「证件信息 + 活体人脸」确认操作人是本人,常用于注册、签约、支付等高风险环节

人脸核身会把用户填写的姓名、身份证号提交给核身渠道,由渠道生成一条核身链接。 用户打开链接后按提示完成活体检测(眨眼、转头等动作)并进行人像比对, 渠道判定为同一人后返回结果。整个过程用户不需要下载 App,在手机浏览器内即可完成。 比对通过后,系统会按你提交的单号把结果回调到指定地址,业务侧据此放行或拒绝。

1

提交身份信息

业务系统调用接口,传入姓名与身份证号

2

获取核身链接

接口返回一条 H5 链接,有效期由渠道控制

3

用户完成核验

用户在链接内完成活体检测与人像比对

4

接收结果回调

结果按你提交的单号 POST 回回调地址

核心能力

两个核身渠道可选,结果留痕可查

腾讯云慧眼渠道

接入腾讯云慧眼 H5 核身,返回核身链接与核身流水号,适合在微信、浏览器等场景使用。

支付宝核身渠道

接入支付宝人脸认证(FACE 认证),同样返回核身链接,可按业务场景二选一。

活体检测与人像比对

由核身渠道完成活体检测,并将现场采集的人像与证件照片比对,判断是否本人。

身份证格式校验

接口提交前会校验身份证号格式(18 位,末位可为 X),格式不合法直接返回错误,不消耗次数。

H5 链接接入

接口只返回一条 H5 核身链接,业务侧跳转即可,无需集成 SDK,也无需自行采集人脸数据。

核身记录留痕

每次核身都记录渠道、单号、姓名、身份证与状态(待核验 / 通过 / 未通过),便于对账与排查。

接口说明

提交身份信息获取核身链接,核身完成后结果回调通知

POST /api/index/realname
// 请求(表单方式提交)
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 即为核身链接,跳转到该地址后由用户完成核验。 回调中的 status1 表示通过、-1 表示未通过。

计费与套餐

接口按次计费,调用前需保证次数包有余额

计费方式

1 次 / 次调用

每发起一次核身消耗 1 次额度

额度来源

次数包

购买套餐后充入账户次数包

额度不足

200001

返回错误码,不发起核身、不扣费

人脸核身基础型

¥120.00

含 100 次核身

人脸核身普及型

¥580.00

含 500 次核身

人脸核身企业型

¥1100.00

含 1000 次核身

每次调用前会检查次数包余额,余额大于 0 才扣减并发起核身;余额不足时直接返回错误码 200001,不会产生任何费用。

常见问题

接入前常被问到的几个问题

支持哪些核身渠道?
目前支持两个渠道:腾讯云慧眼(tencentrealname)与支付宝人脸认证(alirealname),通过 channel 参数指定。两个渠道都是 H5 方式,用户在手机浏览器内完成核验,无需安装 App。
用户必须本人操作吗?
是的。核身链接打开后需要本人完成活体检测,并把现场人像与证件照片进行比对,只有比对通过才算核验成功。这也是人脸核身与单纯「姓名 + 身份证号」校验的主要区别。
怎么知道核验结果?
核身完成后结果会 POST 到你提交的 notify_url,字段为 orderNo(你传入的业务单号)与 status(1 通过 / -1 未通过)。同时每一次核身在系统中都有记录,包含渠道、单号与状态,可用于对账。
次数不够会怎样?
次数包余额为 0 时,接口会直接返回错误码 200001,不会发起核身、也不会产生费用。购买套餐后额度会充入次数包,再次调用即可正常使用。
身份证号填错了会扣次数吗?
不会。接口会先校验身份证号格式(18 位,末位可为 X),格式不合法时直接返回「身份证号码格式错误」,不会发起核身请求,也不会扣减次数。

接入咨询

需要接口账户、签名密钥或联调协助,都可以联系我们

咨询热线

400-028-5578

电子邮箱

admin@onezon.cn

在线沟通

工作日 9:00 - 18:00