门户中
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
- 证件
- 通过
- 证件认证通过:正面、背面、条形码以及 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 尚不会强制执行这一限制。
创建您的账户
在门户中注册,并选择英语或法语。使用 sandbox 无需绑定银行卡。复制您的 sandbox 密钥
创建后仅显示一次。请将其放入环境变量中,而不要放进源代码管理。创建会话
一次 API 调用,附带返回 URL 和 webhook URL。将返回的链接发送给申请人。查看结果
在控制台中查看结果送达,或在结果产生的瞬间通过带签名的 webhook 读取。
大多数团队当天下午就能完成可用的 sandbox 集成。
常见问题