...
正在集成身份验证 API 的开发者

身份验证 API:一次 REST 调用创建 KYC 会话

用一次 POST 创建验证会话,把客户引导到我们的 Web SDK 组件,并从同一个会话读取结果。证件核验、人脸比对和活体检测都在其中运行,每项核验都以具名形式返回,并附各自的结果。

阅读 API 文档API 文档
  • REST API 与 Web SDK REST + SDK
  • JWT 与永久访问令牌 JWT · 令牌
  • 响应中的具名核验项 具名核验项
  • 公开的错误参考 错误参考

12,000次免费验证,首次接入即享

每家首次接入 NeuroVision 的企业,均可获赠 12,000 次免费验证,有效期 12 个月。自2026年12月1日起开放。

了解更多

通过独立测试与认证

ISO Register Global 认证标志ASIB 认证标志QA Compliance Assessment 认证标志
  • ISO/IEC 27001:2022
  • GDPR
  • iBeta ready
全球覆盖

16,000+ 种证件类型
来自 195+ 个国家和地区

客户用随身携带的证件即可验证,支持 90+ 种语言,包括手写栏位与 MRZ。

16,000+

种证件类型


护照 身份证 驾驶证 居留许可 签证 工作许可 选民证 税号 电子身份证 生物识别护照 军人证 医保卡 国民身份证 旅行证件 难民身份证件 社保卡
195+

国家和地区


哈萨克斯坦 阿联酋 德国 英国 新加坡 印度 巴西 尼日利亚 菲律宾 越南 土耳其 墨西哥 乌兹别克斯坦 埃及 印度尼西亚 法国 西班牙 意大利 波兰 肯尼亚 沙特阿拉伯 日本 韩国 澳大利亚 美国 加拿大 泰国 马来西亚 南非
快速入门

五步完成第一次验证

  1. 01获取令牌POST /user/login 为您的账户返回一个临时 JWT。
  2. 02创建会话使用您已配置的场景调用 POST /kyc/session/create。
  3. 03打开组件通过链接或二维码把用户引导到 Web SDK 组件。
  4. 04读取结果轮询会话状态,或接收您设置的回调。
  5. 05正式上线先在沙箱中测试流程,再接入真实用户。
这里的一切都有文档每一步都对应公开 API 参考中的一个方法,名称相同。
工作方式
接口

身份验证 API 涵盖什么

五组方法,以及使用这些方法的一个组件。

下面的名称与我们公开参考文档中的一致,因此您不必猜测落地页上叫什么,就能找到每个方法。

KYC 会话

创建会话、查询状态、列出会话、筛选,并下载日志归档。

8 个方法

访问令牌

创建永久令牌,列出某位用户持有的令牌,更新或删除令牌。

4 个方法

用户与余额

授权用户并获取临时 JWT,读取或更新分组余额。

3 个方法

人员

创建人员名单和人员记录,更新、删除,并为已存储的人脸添加图像。

8 个方法

数据来源

创建来源和来源组,列出、更新和删除。

8 个方法

Web SDK

安装组件、传入参数,并使用把组件与会话关联起来的客户端密钥。

4 页
开发者

一次请求调用 API

一次 POST 即可创建会话。接下来由组件接手,结果就绪后由您的后端读取。

终端REST API
curl -X POST $NV_API_URL/kyc/session/create \  -H "Content-Type: application/json" \  -H "Authorization: Bearer $JWT" \  -d '{"token":"$JWT","schemaId":"schema-001"}'仅为示例,完整请求体请见文档。
错误{ "status": …, "message": "…", "details": … }
信任与数据

您的数据存放在哪里,并保持在哪里

在我们的云端运行核验,或在您自己的网络边界内运行。

ISO/IEC 27001:2022通过认证的安全体系
  • 每次调用都使用 JWT
  • 永久访问令牌
  • 本地化部署
  • 由您设定图像保留期限
Web SDK

您的用户真正看到的 Web SDK 组件

组件运行在您的页面之上,引导客户完成证件拍摄、自拍和各项核验,然后把结果发送给您。

在他们已有的浏览器中运行

支持桌面和移动端的所有现代浏览器,包括 iOS 和 Android。组件只会请求一项权限:访问摄像头。

无需下载应用

通过密钥关联到会话

客户端密钥把您页面上的组件与您创建的会话连接起来,结果就是这样回到您手中的。

通过链接或二维码启动

用户打开一个起始页,扫描二维码或点击链接,并可在开始前切换界面语言。

由您决定运行哪些步骤

证件、手持证件自拍、活体检测和反欺诈步骤,是在您的场景中开启或关闭的,而不是在组件代码里。

Web SDK 组件:起始页、证件拍摄与结果

组件文档共四页,从安装到客户端密钥。

结果

读取会话结果

两种获取方式,一种读取格式。

每项核验都以具名条目返回,带有各自的状态和置信度,您的规则可以读取自己关心的部分,而不是只看一个总结论。

轮询会话状态

按会话 id 或客户端密钥查询会话,读取当前状态和结果。

拉取

接收回调

会话结束时,回调会送达最终结果,您无需轮询。

推送

带置信度的具名核验项

证件和人脸核验以具名条目返回,每项都带有状态和置信度。

JSON

每个错误都有代码

未通过的核验会返回我们公开参考中的代码和说明,客服可以据此告诉客户该怎么做。

40 个代码
访问

令牌、访问与错误

临时令牌与永久令牌

登录会返回有效期由您选择的临时 JWT。服务器之间的调用,可创建永久访问令牌,并在不再需要时撤销。

可据此采取行动的错误

四十个有文档的代码,每个都有说明,涵盖图像质量、证件问题、欺诈信号和人脸核验,因此可以向客户解释拒绝的原因。

查看错误参考

可下载的会话日志

会话可以通过 API 导出为日志归档,因此审计或争议可以用您自己保存的副本回应,而不是一张截图。

阅读 API 文档

这里的每个方法都在参考文档中

本页上的每个接口、字段和错误代码,都以相同的名称出现在我们的公开文档中,因此您可以从示例直接跳转到对应的参考页面。

选择理由

团队为何选择 NeuroVision Global Systems

可审计的准确率

经独立测试的人脸比对,每个结果都附带置信度评分。

可审计的准确率

人脸算法经 NIST 测试,在 NIST FRVT 1:1 Verification 中位列 TOP-24。每一项证件与人脸结果都附带置信度分值。

TOP-24NIST FRVT 1:1 Verification
0.1 秒每次人脸比对

一小时内上线

REST API、Web SDK、iOS 与 Android SDK、WebView;先在沙箱环境试跑。

一小时内上线

用沙箱密钥接入 REST API 或 Web SDK 不到一小时,生产环境一个工作日上线。14 天真实流量试用并提供全程支持。

< 1 小时使用沙箱密钥即可完成集成
14 天试用,开放全部 API 权限

全球覆盖

195+ 个国家和地区、16,000+ 种证件类型、90+ 种语言。

全球覆盖

客户用随身携带的证件即可验证:支持来自 195+ 个国家和地区的 16,000+ 种证件类型,包括手写栏位与 MRZ。

16,000+种证件类型
90+种语言

基于真实攻击打磨的反欺诈

40+ 项证件检查、1:N 人脸检索、黑名单筛查,另有 30 道防护。

基于真实攻击打磨的反欺诈

在证件检查之上,叠加可抵御深度伪造的活体检测、1:N 去重与黑名单筛查:一人一账户。

40+证件检查项
0.01%残余欺诈风险

隐私保护内建于设计

符合 ISO/IEC 27001:2022,满足 GDPR 要求;支持本地化、云端或混合部署。

隐私保护内建于设计

可在我们的云端、您的数据中心或混合环境中运行:生物特征模板与个人信息不出您所在的司法辖区。

27001:2022ISO/IEC 认证
GDPR就绪

全部引擎自主研发

OCR、人脸、活体检测与反欺诈都是我们自己的。

全部引擎自主研发

一个供应商、一个 API,覆盖 KYC、KYB、AML 与 KYT:一份 SLA,无第三方授权。

20 年计算机视觉研发
1 份 SLA覆盖每次核验
价格

身份验证 API 价格

API 不是带有独立许可的单独产品。您按已完成的核验付费。

证件套餐

低至$0.25每次核验

证件识别与反欺诈核验。在 Basic 套餐中增加自拍和活体检测。在计算器中组合您自己的方案。

计算您的价格

按量付费

API 没有订阅费,也没有许可费,您按已完成的核验付费。

查看价格

免费试用

在您的真实流量上试用 14 天,开放全部 API 权限,第一天起即可使用沙箱环境。

大用量与企业方案

大用量定制条款、本地化部署与 SLA。

产品

我们的 AI 身份解决方案

验证、认证与保护客户所需的一切,尽在一个强大的平台。

真人持真证件,几秒完成验证。证件采集、人脸比对、活体检测、反欺诈与 AML。

了解更多

对每位客户筛查制裁名单、PEP 与监控名单(含自我禁入名单),就在同一验证流程中完成。

了解更多

核验账户背后的企业:公司登记数据与受益所有人(UBO),在开户前完成核查。

了解更多

交易实时监控:可疑转账会被标记以供复核,与 KYC、AML 共用同一个 API。

了解更多

确认本人在场,且可抵御深度伪造。用人脸代替密码来认证老客户。

了解更多

结账时用人脸或身份证件确认支付,凭的是客户已经验证过的身份。

了解更多
联系方式

获取您的 API 密钥

告诉我们您在构建什么,需要哪些核验。我们会发送沙箱凭据,并为您对接协助您上线的工程师。

更希望直接联系我们?
发送邮件:
hello@nv.global
姓名 *
请输入有效的姓名
公司
电子邮箱 *
请输入有效的电子邮箱
电话
请输入有效的电话号码
留言 (选填)
请先同意隐私政策
常见问题

身份验证 API 常见问题

开发者在开始前会问的问题。完整参考在文档中,我们提供了链接。

没有找到您要的答案?

登录会返回临时 JWT,您也可以为服务器之间的调用创建永久访问令牌。两者都在 API 参考中有说明。

支持,用于会话的最终结果。您也可以按会话 id 或客户端密钥轮询会话状态。

年龄核验在同一会话中运行;见年龄验证 API。

我们不公布速率限制。告诉我们您计划的用量,我们会针对您的情况给出确认。

返回一个带状态的具名核验项,外加来自我们公开错误参考的错误代码和说明,足以让您的客服告诉客户下一步该怎么做。

AML 筛查同样以具名检查项返回;见AML API。

有。您在接入真实数据之前先在沙箱中测试集成,我们的集成团队会陪您走完第一次会话。

没有单独的 API 许可费。您按已完成的核验付费,带反欺诈的证件识别每次 $0.25 起。可在价格页面组合您自己的方案。

一站式人脸识别平台,
实现即时 KYC 验证

简化客户开户、防范欺诈,确保 KYC/AML 合规