实名认证 / 人脸核身

实名认证 API
姓名 + 身份证 + 人脸核身，一次调用完成

为需要履行实名义务的业务提供身份核验能力：调用接口创建认证任务，把链接（或二维码）给到终端用户刷脸，认证结果通过异步回调或查询接口取回。按次计费，认证失败/过期自动退还。

免费注册并接入查看接口文档在线人脸测试

2 种通道

H5 刷脸 / 支付宝

异步回调

结果主动推送

失败退还

未通过不浪费

30 分钟

认证有效期

curl -X POST https://jh.fzywl.cn/api/id/verify/h5 \
 -H "Authorization: Bearer {API_KEY}" \
 -H "Content-Type: application/json" \
 -d '{"name":"张三","id_number":"110101199001011234",
    "callback_url":"https://你的域名/idverify/callback"}'

// 返回
{"code":0,"msg":"认证已创建","data":{
 "order_no":"202608151200001234",
 "verify_url":"https://jh.fzywl.cn/verify.html?orderNo=…"}}

认证流程

四步闭环：创建任务 → 用户扫脸 → 拿结果 → 落到你的业务里。

① 创建认证（传姓名 / 身份证）→ ② 把 verify_url 给用户（或转二维码）→ ③ 用户完成刷脸→ ④ 回调推送 / 接口查询结果

有效期 30 分钟：超时未完成扫脸的认证单会自动过期，期间冻结的额度会自动退还，不会白扣。

核心能力

身份证核验

姓名 + 身份证号一致性核验，由权威数据源比对。

人脸活体检测

H5 刷脸（金融级实人认证），有效拦截照片/视频等攻击。

支付宝通道

支付宝扫码刷脸，用户用本人实名支付宝完成核身，体验更顺。

异步回调结果

创建时带上回调地址，认证完成自动 POST 结果（order_no / status / passed / sub_code）。

状态全程可查

pending / processing / passed / failed / expired 五种状态，随时用 order_no 查询。

合规与隐私

两种通道共用一个 id_verify Key，按次计费，认证记录可在后台查询与追溯。

适用场景

用户实名认证

App/平台的实名制要求，注册后引导用户完成人脸核身。

高风险操作复核

提现、改绑、大额交易等敏感操作前的人脸复核。

内容 / 社区合规

创作者、主播、商家入驻时的身份核验，满足平台合规要求。

防薅羊毛

活动发放前做实名 + 人脸核身，挡住批量注册与机器账号。

计费与规格

项	说明
计费方式	按次计费；平台有免费额度（后台配置），超出后每次认证扣 1 次额度
失败会扣吗	认证未通过按规则处理；超时过期（30 分钟）会退还被冻结的额度
两种通道	H5 刷脸（`POST /api/id/verify/h5`）与支付宝认证（`POST /api/id/verify/alipay`）价格相同、共用一把 Key
套餐价格	见服务与价格

常见问题

支付宝通道要注意什么？

必须使用已完成实名、且姓名与被认证人一致的支付宝账号扫码；否则无法完成人脸核身，建议在页面上给用户明确提示。

两种通道怎么选？

两种通道价格相同、共用一把 Key，接口地址不同。一般 H5 刷脸适用面更广；用户手机装有支付宝时，支付宝通道体验更顺。

用户一直没做认证怎么办？

认证单 30 分钟有效，超时自动置为 expired 并退还冻结额度；你可以重新创建一单并把新链接发给用户。

回调没收到/丢了怎么办？

回调只是通知手段：以回调地址为准的同时，建议再用 GET /api/id/verify/result?order_no=… 做一次兜底查询，避免网络抖动漏掉结果。

用户身份信息会不会被留存？

接口只用于当次核验；后台记录的是认证流水（订单号、状态、时间），手机号等敏感字段在日志中脱敏展示。