多账号

Markdown

属于欺诈风险分类

此产品依赖多账号能力，它属于欺诈风险分类产品。它在与 Unico 进行入职对接期间在您的 API Key 配置中启用。

此产品解决的问题

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

在以下情况下使用此产品：

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

在以下情况下请勿使用此产品：

• 如需验证身份证件的真实性 → 请查看入职/新用户注册产品。
• 如需确认执行交易的人是账户持有人（1:1 验证）→ 请查看交易类产品。
• 您的产品设计上允许每人拥有多个账户（例如个人账户和企业账户）——在这种情况下，请与您的 Unico 联系人讨论：搜索可以进行分段，从而不会将这些账户类型检测为重复。

涉及的能力

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

Liveness多账号

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

前提条件

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

分步实施

Native

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

1. 安装 SDK — 为您的平台添加 Unico SDK 依赖项。请参阅 Android、iOS 或 Flutter 的安装指南。
2. 创建流程 — 调用创建流程，传入 适当的 flow 值 和用户标识符。响应中包含 webAppToken。
3. 打开旅程 — 使用 webAppToken 打开 SDK。SDK 会在您的应用内运行该旅程，用户完成后会携带 processId 调用 onSuccess。
4. 查询结果 — 调用获取流程以获取 能力 结果。
5. 应用业务规则 — 根据 响应 字段决定通过、拒绝或升级处理。

Android

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

查看概览

iOS

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

查看概览

Flutter

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

查看概览

Web

在浏览器中集成 — Unico 托管旅程，您可以使用 Journeys SDK 打开它，或通过重定向用户来打开。

1. 创建流程 — 调用创建流程，传入 适当的 flow 值 和用户标识符。响应中包含流程 id、token 和 userRedirectUrl。
2. 打开旅程 — 在您的页面内使用 Journeys SDK 打开旅程，并传入流程 id（作为 transactionId）和 token。这是推荐的方式。如果旅程可以在页面之外运行，请改用直接访问：将用户发送至 userRedirectUrl，并在创建流程中设置 callbackUri，以便 Unico 知道将用户送回何处。
3. 用户完成旅程 — Journeys SDK 会调用 onFinish。使用直接访问时，Unico 会将用户重定向回您的 callbackUri。
4. 查询结果 — 调用获取流程以获取 能力 结果。
5. 应用业务规则 — 根据 响应 字段决定通过、拒绝或升级处理。

Web

浏览器中的 Journeys SDK 或直接访问。

查看概览

API

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

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

API

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

查看概览