升级认证

此用例解决的问题

检测某个面部生物特征是否已关联到运营商库中的另一个活跃账户——即 "一张脸，一份合同" 原则。通过单次 API 调用，将采集的面部与注册库进行交叉比对，并在操作节点拦截重复账户。

在以下情况下使用此用例：

• 用户尝试执行某项操作（申请首次提现、出金），您希望验证该生物特征是否已属于系统中另一个活跃账户。
• 您需要对**自拍历史库进行追溯性导入**，以识别已有的重复项（批量模式）。这是生物特征库导入流程。
• 您的业务模型要求每个人每个运营商（或每个国家）最多只能拥有一个活跃账户。
• 您希望减少人工视频审核台的负担，用自动化的确定性决策取代人工分析。

在以下情况下请勿使用此用例：

• 如需验证身份证件的真实性 → 请查看入职/新用户注册用例。
• 如需确认执行交易的人是账户持有人（1:1 验证）→ 请查看交易类用例。
• 您的产品设计上允许每人拥有多个账户（例如个人账户和企业账户）→ 在启用此规则前，请与 Unico 团队评估 clientReferenceSegment 配置。此字段定义搜索范围：1:N 比对仅针对在同一分段下注册的记录运行，因此不同分段可在同一运营商内共存而不触发误报。

涉及的能力

在单个流程中执行的管道：

LivenessMulti accounts 1:N

能力	是否必需	在流程中的作用
活体检测	API 可选；Web 和 Native 必需	采集时的活体检测。
多账号 1:N	必需	在运营商库中执行分段生物特征搜索，将接收到的面部与同一分段下的所有记录进行交叉比对。

前提条件

• Bearer token — 参见身份验证。
• 沙盒凭据 — 参见环境。
• 已安装 SDK 或 Web 组件 — 仅适用于 Web 和 SDK 集成。参见 SDK 与工具。
• 所有请求中均已填写 clientReference 字段 — 在运营商系统中唯一标识用户。必须在客户数据库中唯一，最多 256 个字符且不含空格。此字段是多账号用途的主要标识符。

分步实施

Native

通过原生 SDK 集成 — 采集在您的应用内运行，使用适用于 Android、iOS 或 Flutter 的 Unico SDK。

1. 安装 SDK — 为您的平台添加 Unico SDK 依赖项。请参阅 Android、iOS 或 Flutter 的安装指南。
2. 创建流程 — 调用 POST /v1/process，传入对应的 flow 值和用户标识符。使用返回的 token 初始化 SDK。
3. 启动采集 — SDK 渲染摄像头 UI 并在设备端执行活体检测，返回采集到的数据。
4. 查询结果 — 调用 GET /v1/process/{processId} 获取能力检测结果，或通过 webhook 接收结果。
5. 应用业务规则 — 根据响应字段决定通过、拒绝或升级处理。

Android

用于应用内采集的原生 Android SDK。

查看概览

iOS

用于应用内采集的原生 iOS SDK。

查看概览

Flutter

用于应用内采集的跨平台 Flutter SDK。

查看概览

Web

通过 iFrame、重定向或原生集成 — Unico 托管采集 UI，您通过轮询接收结果。

1. 创建流程 — 调用 POST /v1/process，传入对应的 flow 值和用户标识符。响应中包含 userRedirectUrl。
2. 重定向用户 — 将用户引导至 userRedirectUrl。Unico 负责渲染采集流程。
3. 用户完成流程 — 采集完成后，用户将被重定向回您的 callbackUri。
4. 查询结果 — 调用 GET /v1/process/{processId} 获取能力检测结果，或通过 webhook 异步接收结果。
5. 应用业务规则 — 根据响应字段决定通过、拒绝或升级处理。

Web

通过浏览器快速集成，无需安装。

查看概览

API

直接 API 集成——使用 Unico SDK 或遵循采集标准采集自拍，然后将图像直接发送至 Unico API。

1. 采集自拍 — 使用适用于您平台的 Unico SDK，或遵循采集标准获取符合活体检测要求的自拍图像。
2. 创建流程 — 调用创建流程，传入用户标识符及 imagebase64 格式的自拍。
3. 查询结果 — 调用获取流程以获取能力检测结果。
4. 应用业务规则 — 根据响应字段决定通过、拒绝或升级处理。

API

通过后端直连集成，完全掌控流程。

查看概览