跳到主要内容
ShieldID

控制台

一个身份验证控制台,管理密钥、用量和结果。

查看本月用量,管理 sandbox 和正式 API 密钥,核对账单,并以与团队完全一致的方式查看每一条验证结果。支持英语和法语。

  • Sandbox 密钥与正式密钥相互隔离
  • 每个结果都以逐项检查结论呈现
  • 英语和法语,全程支持

门户中

KYC 门户该呈现的一切,集中在一处。

客户门户是您的团队日常工作的地方:不是原始的 API 调用日志,而是把用量、密钥、账单和结果整理成便于人阅读的形式。

本月用量

本月迄今已运行的验证次数与您的套餐包含额度的对比,随结果返回实时更新。

套餐与订阅

您当前使用的套餐、包含的内容,以及在哪里更改。

API 密钥

沙盒密钥和正式密钥,完整密钥只显示一次,之后仅显示一个简短的前缀,方便您区分。

用量历史

本月及之前的历史记录,让用量激增或清淡的月份一目了然。

账单与发票

您的订阅、订阅状态和以往的发票,尽在一个页面。

品牌定制(限符合条件的套餐)

设置申请人在托管验证页面上看到的公司名称、徽标和强调色。

Sign-in

按 KYC 门户应有的标准严密加固。

这是您的合规负责人要登录的门户,因此登录本身得到与背后各项检查同等的重视。

  • 密码经过哈希处理,绝不以明文存储。
  • 连续八次登录失败会将账户锁定十五分钟,猜密码的脚本因此一无所获。
  • 会话是一个随机令牌;服务器上只保存它的哈希值,并且 Cookie 被标记为 HttpOnly。
  • 双重验证登录——即将推出。
  • 登录页面和整个门户都提供英语和法语版本。

API 密钥

可以区分的密钥,无需提交工单即可吊销。

密钥只能从门户创建,绝不会通过匿名 API 调用创建,并且每个密钥都仅限于您的账户范围。

  • 沙盒密钥和正式密钥始终相互独立,因此测试脚本绝不会意外触及生产环境。
  • 完整密钥在您创建后只显示一次。之后我们仅以明文保留一个简短的前缀。
  • 吊销密钥会立即生效:此后使用该密钥的下一个请求将被拒绝。
  • 每个密钥的速率限制是所有套餐的一部分。

API 密钥

示例数据

已创建新的 sandbox 密钥

vk_sand_8Kd93jXQmZp2AeBTUqk7RmS4

请立即复制。此密钥不会再次显示,之后仅保留前缀可见。

  • Sandbox 默认

    vk_sand_8Kd9…

    Sandbox2026年9月12日启用中
  • 生产环境

    vk_live_2Qf1…

    生效中2026年8月3日启用中
  • 旧的集成测试

    vk_sand_9Ta2…

    Sandbox2026年2月18日已吊销

示例数据

结果是什么样子。

每次验证都会返回多项各自命名的独立结论,而不是一个不透明的分数。这是一份虚构的示例:姓名和证件均为虚构,结果的结构则是真实的。

Jordan Reyes

Ontario driver's licence

示例数据Sandbox 已验证
证件
通过
证件认证通过:正面、背面、条形码以及 MRZ(如有)均已成功读取。
身份
通过
条形码、MRZ 和印刷页面在每个字段上都一致。来源之间不一致时会被标记出来,绝不取平均值。
姓名匹配
通过
您的集成预期的姓名与证件上的姓名一致。
活体检测
通过
一项引导式挑战,在至少十帧画面中追踪 478 个面部特征点。
Anti-spoof
通过
不是照片的照片、屏幕回放或打印的人脸。
深度伪造
通过
没有合成或被篡改人脸的迹象。
面具
通过
没有 3D 面具或假体的迹象。
篡改
已报告
针对证件图像的一项参考性信号,而非通过/不通过的关卡。
人脸比对
通过
现场人脸与证件肖像相匹配,并对照固定的判定线给出结果。我们从不显示百分比。
制裁名单
Add-on
为已添加此功能的账户筛查 OFAC、UN、EU、加拿大 OSFI、英国 HMT、澳大利亚 DFAT 和 OpenSanctions 名单;名单更新通过手动或由外部调度的同步执行,而非自动的每日刷新。
地址
通过
在提供了用于比对的地址时,存档地址与证件上印刷或编码的地址相符。

结果详解

一次示例验证,逐字段解读。

示例数据:为虚构申请人创建的虚构会话,呈现方式与其到达您的控制台和 webhook 接收端时一致。

示例数据
会话 ID
ses_7f2a91c0b3d4——您创建会话时使用的 ID,之后所有查询和 webhook 都使用它。
状态
VERIFIED、FAILED、PENDING、IN_PROGRESS 或 EXPIRED。
环境
Sandbox 或生产环境,标注在会话上,绝不混用。
申请人
从证件中读取的姓名、出生日期、证件类型、证件所属国家和司法辖区以及地址。
逐项检查结论
证件、活体检测、防欺骗、人脸比对,以及在启用时的制裁名单筛查,每项各自给出 PASS、FAIL 或 SKIPPED。
人脸比对
与固定的判定线进行比较。我们只报告通过或未通过,从不提供百分比。
重拍建议
验证失败时,会指明究竟是证件还是自拍需要重拍,而不是笼统地提示“请重试”。
完成时间
会话达到最终状态的时间。
送达方式
向您的 webhook_url 发送带签名的 webhook,同样的结果也会显示在控制台和 API 中。

此结果所依据的图像会在较短的定时后自动清除,默认为七天。结果本身会保留。

其余部分

管理端、角色与限制,坦诚相告。

有两件事值得直接说明,而不是让您自己去发现。

管理端

每个客户门户的背后,都有一个我们自己团队使用的独立内部控制台:一次搜索即可查看所有账户的用量和账单、套餐变更,以及在固定且经过测试的范围内调整的共享检测设置。它不属于您的账户,您也不会看到它。

即将推出

角色与限制

目前每个账户只有一个登录。邀请队友并为其分配各自的角色——管理员、账单、只读——即将推出。每个密钥的速率限制是所有套餐的一部分;正式 API 中的强制执行即将推出,因此请将您套餐的限额作为设计时的参照数字,目前 API 尚不会强制执行这一限制。

Quick-start

从注册到获得第一个结果。

门户的设计目标是让您快速获得真实结果,而不是先让您阅读一本手册。

  1. 创建您的账户

    在门户中注册,并选择英语或法语。使用 sandbox 无需绑定银行卡。
  2. 复制您的 sandbox 密钥

    创建后仅显示一次。请将其放入环境变量中,而不要放进源代码管理。
  3. 创建会话

    一次 API 调用,附带返回 URL 和 webhook URL。将返回的链接发送给申请人。
  4. 查看结果

    在控制台中查看结果送达,或在结果产生的瞬间通过带签名的 webhook 读取。

大多数团队当天下午就能完成可用的 sandbox 集成。

常见问题

关于仪表盘的直接解答。

开始使用

登录,亲自看看。

了解控制台最快的方式就是打开它:创建一个沙盒密钥,运行一次验证,看着结果送达。