开始集成
下载
聚焦模式
字号
将腾讯云 eKYC 服务与您的应用程序集成，可以按照下图所示三个阶段进行：准备阶段、集成阶段和测试阶段。
如上图所示，集成 eKYC 分为三个不同的阶段，下面将分阶段进行详细介绍：
准备阶段（Prepare）
集成 eKYC 准备阶段，可以按照下面的步骤执行：
1. 做好计划（Plan your integration）
在您采取任何实际行动之前，请根据所需要的功能选择合适的产品：
子产品名称 | 功能简介 | 功能明细 | 服务部署区域 | 支持接入的方式 |
活体人脸比对 | 判断视频上的用户是否为真人，并与客户后台传入的照片比对判断是否为同一人。 | ●人脸姿态实时检测 ●活体检测（支持配置：静默、动作、光线、眨眼+光线模式） ●与客户后台自传照片进行人脸比对 | ●中国香港 ●新加坡 ●印度尼西亚 ●泰国 ●马来西亚 ●巴西 | ●App SDK ●移动端 H5 ●纯 API |
卡证活体人脸比对 | 提供一整套自动化身份认证的方案，通过引导用户拍摄证件照和录制人脸视频，判断用户是否为真人、是否为本人。 | ●证件文字识别 ●自动提取证件人像照 ●人脸姿态实时检测 ●活体检测（支持配置：静默、动作、光线、眨眼+光线模式） ●与证件人像照进行人脸比对 | | ●App SDK ●移动端 H5 |
腾讯云 eKYC 提供了不同的集成方式供您与不同的产品集成。目前两类子产品支持五种集成方式：
活体人脸比对
集成方式 | 说明 |
活体人脸比对（App SDK） | 将 eKYC 的活体人脸比对服务与本机移动应用程序集成 |
活体人脸比对（移动端 H5） | 将 eKYC 的活体人脸比对服务与移动网络（H5）应用程序集成，或通过现代移动网络浏览器进行交互 |
活体人脸比对（纯 API） | 通过 API 将 eKYC 的活体人脸比对服务与服务器端应用程序集成 |
卡证活体人脸比对
集成方式 | 说明 |
卡证活体人脸比对（App SDK） | 将 eKYC 的卡证活体人脸比对服务与本机移动应用程序集成 |
卡证活体人脸比对（移动端 H5） | 将 eKYC 的卡证活体人脸比对服务与移动网络（H5）应用程序集成，或通过现代移动网络浏览器进行交互 |
如何选择集成方式
按业务需求选择：
需验证证件（身份证、护照等）→ 卡证活体人脸比对
仅验证人脸（已有用户照片）→ 活体人脸比对
按技术平台选择：
原生 iOS/Android App → App SDK
公众号/小程序/移动网页 → 移动端 H5
服务端批量处理/自定义界面 → 纯 API
按开发阶段选择：
快速测试/首次接入 → 先用移动端 H5 验证功能
正式上线/追求性能 → 后续切换至 App SDK
如何选择不同版本
针对活体人脸比对和卡证活体人脸比对两种服务，腾讯云 eKYC 提供了多种版本可供选择，灵活包含了从活体比对、设备风控和人脸防护盾等多种能力的组合。
接入方式 | 版本 | SdkVersion | 活体 | 人脸比对 | 设备风控 | 人脸防护盾 |
纯 API | Basic(default) | 不提供该参数 | Yes | Yes | No | No |
App SDK | Basic(default) | BASIC | Yes | Optional | No | No |
App SDK | Enhance | ENHANCED | Yes | Optional | Yes | No |
App SDK | Pro | PRO | Yes | Optional | No | Yes |
App SDK | Plus | PLUS | Yes | Optional | Yes | Yes |
Mobile H5 | Basic(default) | BASIC | Yes | Optional | Yes | No |
Mobile H5 | Plus | PLUS | Yes | Optional | No | Yes |
2. 设置腾讯云账号（Set up your Tencent portal account）
A.注册腾讯云账号
B.开通 eKYC 服务
3. 获取 API 密钥（Get API credentials ready）
腾讯云通过 SecretId 和 SecretKey 对开发者的身份和权限进行校验，您可以参考以下步骤获取腾讯云 API 访问密钥：
B. 单击新建密钥创建密钥，并保存 SecretId 和 SecretKey 供后续 API 调用传参。（如果您已经具有腾讯云密钥，请跳过本步骤。）
4. 集成腾讯云 API（Integrate the Tencent Cloud API）
腾讯云 API 可以通过 API 3.0 Explorer 在线调试页面调用，您可以通过阅读 三分钟跑通接口 快速查看接口的入参以及响应结果。集成腾讯云 API 之前，您必须集成腾讯云 SDK 以简化腾讯云 API 接入流程以及保证 API 接口的请求和响应都符合预期，更多的集成信息可以参考 连接腾讯云 API 接口。
集成阶段（Integration）
eKYC 提供了多种集成模式，不同的集成模式，其集成方案是不一样的，可以参考不同模式的集成指引文档完成对应模式的集成。
下面是不同模式下的接入指引：
测试阶段（Test）
完成集成之后，您可以通过测试验证您的集成是否成功，强烈建议您在生产环境上线之前完成全流程测试，腾讯云目前未提供测试环境，可以通过腾讯云生产环境完成您的集成测试工作。
文档反馈