# Unico Developer Documentation

> Unico 身份验证平台文档：用例、能力、SDK 和 API 参考。

## 文档

- [IDCloud](https://developer.unico.io/zh-CN/index.md): Unico 开发者门户 — IDCloud 身份验证 API、SDK 及能力文档，支持 Web、Android、iOS 和 Flutter。
- 构建
  - [注册](https://developer.unico.io/zh-CN/products/sign-up.md): 验证全球各地新客户的身份，确保安全注册。在单一旅程中组合多种能力，量身定制适合您需求的场景。
    - [Onboarding](https://developer.unico.io/zh-CN/products/sign-up/onboarding/index.md): 身份验证，适用于任何地区，包含活体检测、生物特征身份验证、欺诈风险评估和文件复用。
    - [无文件验证](https://developer.unico.io/zh-CN/products/sign-up/non-document-verification/index.md): 在任何地区进行身份验证，包含活体检测、生物特征身份验证和欺诈风险评估。
    - [欺诈风险等级检测](https://developer.unico.io/zh-CN/products/sign-up/fraud-risk-level-detection/index.md): 通过将活体检测与行为预警相结合来验证真实用户正在进行注册——无需文件采集或政府身份标识符。
    - [多账号](https://developer.unico.io/zh-CN/products/sign-up/multi-accounts.md): 通过将用户的面部生物特征与运营商注册库进行交叉比对，验证"一张脸，一份合同"原则。
  - [升级认证](https://developer.unico.io/zh-CN/products/step-up-authentication.md): 在交易流程中验证全球任何地区客户的身份，确保安全流程。在单一旅程中集成多种能力，根据您的场景量身定制。
    - [智能重新验证](https://developer.unico.io/zh-CN/products/step-up-authentication/smart-revalidation/index.md): 在注册后对交易中的用户进行重新认证，允许根据所需体验和流程关键性选择不同的认证方式。
  - [区域解决方案](https://developer.unico.io/zh-CN/products/regional-solutions.md): 专为解决地区立法和法律框架痛点而设计的产品——适应本地监管要求的身份验证流程。
    - [年龄验证](https://developer.unico.io/zh-CN/products/regional-solutions/age-verification/index.md): 允许以100%生物特征方式证明用户满足最低年龄要求，无需文件摩擦。
    - [数据验证](https://developer.unico.io/zh-CN/products/regional-solutions/data-verification/index.md): 提供有关个人的必要信息，使企业能够遵守金融服务和 iGaming 领域的现行法规。
    - [无卡验证](https://developer.unico.io/zh-CN/products/regional-solutions/card-not-present-verification/index.md): 通过人脸生物特征识别和卡片归属验证，确认完成无卡交易的人员是合法的信用卡持有人。
- 能力
  - [活体检测](https://developer.unico.io/zh-CN/capabilities/liveness.md): 验证用户在自拍采集时真实在场且存活的能力。几乎所有 IDCloud 流程的生物特征基础。
  - [身份验证](https://developer.unico.io/zh-CN/capabilities/identity-verification.md): 该功能验证采集到的面孔属于身份证件持有人。
  - [文档重用与采集](https://developer.unico.io/zh-CN/capabilities/document-reuse-and-capture.md): 用于请求、存储和重用文档的功能。通过提供分类、OCR、FaceMatch 和 CPF 匹配，减少文档采集流程中的摩擦。
  - [欺诈风险分类](https://developer.unico.io/zh-CN/capabilities/fraud-risk-classification.md): 通过在时间维度上评估交易，利用网络效应检测行为异常和身份欺诈。
  - [风险评分](https://developer.unico.io/zh-CN/capabilities/risk-score.md): 生成概率性欺诈评分的功能，在身份验证结果为"不确定"时与身份验证配合使用。
  - [1:1 验证](https://developer.unico.io/zh-CN/capabilities/1-1-validation.md): 确认当前人脸与参考流程中所用人脸一致的能力。适用于交易场景。
  - [多账号](https://developer.unico.io/zh-CN/capabilities/multi-accounts.md): 在运营商库中执行 1:N 生物特征搜索，以检测某张面孔是否已与另一个活跃账号关联。
  - [Serpro 相似度返回](https://developer.unico.io/zh-CN/capabilities/serpro-similarity-return.md): 专用于工资贷款（INSS）及需要与 Serpro 数据库进行比对的业务能力。返回采集的自拍与 Serpro 存档照片之间的相似度分数。
  - [智能重新验证](https://developer.unico.io/zh-CN/capabilities/smart-revalidation.md): 在注册后对交易中的用户进行重新认证，允许根据所需体验和流程关键性选择不同的认证方式。
  - [年龄验证](https://developer.unico.io/zh-CN/capabilities/age-verification.md): 基于生物特征分析，判断摄像头前的人是否已达法定年龄的能力。
  - [Human Token](https://developer.unico.io/zh-CN/capabilities/human-token.md): 从自拍中派生出稳定的、不透明的 personId——身份是调用的输出，而非输入。用户无需声明任何标识符。
  - [Cardholder Verification](https://developer.unico.io/zh-CN/capabilities/cardholder-verification.md): 通过重用先前已验证的流程，结合本人的 CPF 和卡片数据，确认一张卡片属于其声明持卡人的功能。
  - [可用流程](https://developer.unico.io/zh-CN/capabilities/available-flows.md): IDCloud 平台上预组合流程的完整目录。每个流程都是预先准备好的功能组合，在 POST /v1/process 的 `flow` 字段中发送。
- 资源
  - [术语表](https://developer.unico.io/zh-CN/resources/glossary.md): IDCloud 文档中使用的术语表——生物识别、活体检测、流程、令牌及核心概念。
  - [常见问题](https://developer.unico.io/zh-CN/resources/faq.md): 关于 IDCloud 的常见问题——集成、身份验证、错误代码及支持平台。
  - [回测](https://developer.unico.io/zh-CN/resources/backtests.md): 运行历史模拟，针对过去的数据评估能力性能。
  - [重新处理与生物识别库导入](https://developer.unico.io/zh-CN/resources/reprocessing.md): 在 Unico 平台上重新处理生物识别记录或导入生物识别库的指南。

## 开发者

- [API 参考](https://developer.unico.io/zh-CN/developers/api-reference.md): IDCloud API 参考——两种公开合约（Web & SDK 和 API）。
  - [身份验证](https://developer.unico.io/zh-CN/developers/api-reference/authentication.md): 所有 IDCloud 合约使用的 OAuth2 JWT Bearer 流程。了解如何获取凭据、构建 JWT assertion 并将其换取访问令牌。
  - [环境](https://developer.unico.io/zh-CN/developers/api-reference/environments.md): Web & SDK、API 和 Magic Link Mexico 合约的沙箱与生产主机。
  - [Web 与原生](https://developer.unico.io/zh-CN/developers/api-reference/web-sdk.md): 适用于生物特征采集由 Unico 托管（iFrame、重定向或原生 SDK）的场景。
    - [创建流程](https://developer.unico.io/zh-CN/developers/api-reference/web-sdk/post-process.md): 创建验证流程。返回旅程 URL 和 SDK 令牌，将用户引导至 Unico 托管的采集体验。
    - [获取流程](https://developer.unico.io/zh-CN/developers/api-reference/web-sdk/get-process.md): 检索验证流程的当前状态和结果。
    - [流转](https://developer.unico.io/zh-CN/developers/api-reference/web-sdk/flows.md): Web SDK 可用的功能配方目录，按产品分组，以及各配方可返回的结果值。
    - [设置流程文档](https://developer.unico.io/zh-CN/developers/api-reference/web-sdk/post-process-document.md): 在创建时未提供身份证明文件的流程上设置文件。触发需要文件的功能。
    - [获取自拍照](https://developer.unico.io/zh-CN/developers/api-reference/web-sdk/get-selfie.md): 获取验证流程中拍摄的带水印自拍照。
    - [获取证据集](https://developer.unico.io/zh-CN/developers/api-reference/web-sdk/get-evidence-set.md): 检索流程的完整采集证据包 — 用于合规性和监管审计。
  - [API](https://developer.unico.io/zh-CN/developers/api-reference/api.md): TCA / Check.Integration 合同——当客户端控制采集并直接在请求中发送图像时使用。
    - [创建流程](https://developer.unico.io/zh-CN/developers/api-reference/api/post-processes.md): 通过直接发送采集的图像创建验证流程。返回同步结果。
    - [获取流程](https://developer.unico.io/zh-CN/developers/api-reference/api/get-process.md): 通过标识符检索现有的 API 合约流程。由于结果已在创建时同步返回，此接口用于重新查询。
    - [流转](https://developer.unico.io/zh-CN/developers/api-reference/api/flows.md): API 合约可用的功能配方目录，按产品分组，以及各配方可返回的结果值。
    - [获取可重用文档](https://developer.unico.io/zh-CN/developers/api-reference/api/get-document.md): 在启动新的采集流程之前，检查用户是否已有可重用的文档。
    - [创建文档流程](https://developer.unico.io/zh-CN/developers/api-reference/api/post-processes-document.md): 采集新文档，或复用与生物特征流程关联的已采集文档。
    - [数据核查](https://developer.unico.io/zh-CN/developers/api-reference/api/get-lists.md): 根据给定的 CPF 查询登记数据、PEP/反洗钱筛查及体育关系。
    - [年龄验证](https://developer.unico.io/zh-CN/developers/api-reference/api/post-processes-age-validation.md): 创建年龄验证流程。可选择在单个请求中结合活体检测和身份验证。
  - [SSO / SAML](https://developer.unico.io/zh-CN/developers/api-reference/sso-saml.md): 通过 SAML 配置单点登录（SSO），使您的用户可以使用公司自有的身份提供商进行认证，而不必使用各自独立的 Unico 凭据。
  - [错误代码](https://developer.unico.io/zh-CN/developers/api-reference/error-codes.md): 涵盖 Web & SDK、API 和 Magic Link 合约的 HTTP 及平台错误代码综合目录。
  - [速率限制](https://developer.unico.io/zh-CN/developers/api-reference/rate-limits.md): 每合同的速率限制、Retry-After 响应头以及保持在配额范围内的模式。
  - [Postman 集合](https://developer.unico.io/zh-CN/developers/api-reference/postman.md): 适用于认证、Web & SDK 和 API 合约的即用型 Postman 集合。
- [SDK 与工具](https://developer.unico.io/zh-CN/developers/sdks-and-tools/overview.md): IDCloud SDK 与集成工具概览 — Web SDK、Android SDK、iOS SDK、Flutter SDK 及 REST API。
  - [Android SDK](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/requirements.md): | 要求 | 版本 / 值 |
    - [安装](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/installation.md): 如需在项目中配置 SDK，请按照以下步骤操作：
      - [特定设置](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/installation/specific-setup.md): SDK Key
    - [初始化](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/initialization.md): 在应用加载时初始化 SDK——通常在 Application 类或入口 Activity 的 onCreate 中进行。SDK 与后端的认证需要几秒钟时间，提前初始化可避免用户点击采集按钮到相机打开之间出现延迟。更多详情请参阅最佳实践。
    - 采集流程
      - 采集类型
        - [活体检测（生物特征自拍）](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/capture-flow/capture-types/liveness.md): 带有内嵌活体验证的生物特征自拍采集。SDK 通过 SmartFrames 引导用户直到获取生物特征有效帧，并以 Base64 + JWT（JSON Web Token — 发送给您的后端以调用 REST API 的已签名载荷）格式返回图像。
        - [用户旅程](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/capture-flow/capture-types/user-journeys.md): 用户旅程是由 SDK 结合所配置的流程编排的多步骤采集会话。例如，包含 活体检测 + 风险评分 + 文档采集与重用 + 电子签名的流程将在单个会话中依次执行自拍、文件采集和签名。
        - [静默重新验证](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/capture-flow/capture-types/silent-revalidation.md): 使用静默重新验证引擎，在 Unico 网络效应范围内分析用户的行为背景，并为当前交易提供置信度信号。换句话说，我们提供的是判断当前用户是否为该交易预期用户的置信水平。
      - [接收结果](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/capture-flow/receiving-the-result.md): SDK 通过采集会话中使用的监听器接口中定义的回调来返回采集结果。
    - [自定义](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/customization.md): 这些自定义选项仅在采集流程为 document-capture 或 liveness 时可用。
    - [错误处理](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/error-handling.md): Android SDK 的所有错误处理均集中在本节。onErrorAcessoBio 回调接收一个包含 code (Int) 和 description (String) 的 ErrorBio 对象。
    - API 参考
      - [初始化 API](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/api-reference/initialization-api.md): | 类 | 描述 |
      - [采集 API](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/api-reference/capture-api.md): 在从 SDK builder 获取的 UnicoCheckCamera 接口上调用这些方法。准备完成后，CameraListener.onCameraReady(cameraOpener) 回调会提供用于启动采集的 opener。
      - [回调/监听器接口](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/api-reference/callback-listener-interfaces.md): SDK 会话的生命周期回调。将实现传递给 AcessoBio 构造函数。
      - [自定义 API](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/api-reference/customization-api.md): 使用 setTheme() 将主题实现传递给 builder：
      - [枚举](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/api-reference/enums.md): 定义要采集的文件类型。传递给 prepareDocumentCamera 以配置采集会话。
    - [资源](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/resources.md): - 在应用加载时初始化 SDK，而不是在点击捕获按钮时初始化。与后端的身份验证需要几秒钟，如果与打开摄像头同时进行，会造成卡顿的感觉。
      - [已知问题](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/resources/known-issues.md): - Release 构建失败但 debug 正常 — 可能是混淆问题。查看 ProGuard/DexGuard 规则。
      - [版本说明](https://developer.unico.io/zh-CN/developers/sdks-and-tools/android/resources/release-notes.md): 请始终将 Android SDK 更新至最新可用版本。我们使用语义化版本控制对版本进行编号。
  - [iOS SDK](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/requirements.md): | 要求 | 版本 / 值 |
    - [安装](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/installation.md): 步骤 1 — 添加 SDK 依赖
      - [特定配置](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/installation/specific-setup.md): SDK Key
    - [初始化](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/initialization.md): 在您的类中实现 AcessoBioConfigDataSource 协议：
    - 采集流程
      - 采集类型
        - [Liveness（生物特征自拍）](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/capture-flow/capture-types/liveness.md): 内置活体验证的生物特征自拍采集,以 Base64 和 JWT 形式返回采集到的图像帧。
        - [用户旅程](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/capture-flow/capture-types/user-journeys.md): 用户旅程是由 SDK 结合已配置的流程编排的多步骤采集会话。例如，包含 活体检测 + 风险评分 + 文档采集与重用 + 电子签名的流程，在单个会话中依次执行自拍、文件采集和签名。
        - [静默重新验证](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/capture-flow/capture-types/silent-revalidation.md): 使用静默重新验证引擎，在 Unico 网络效应范围内分析用户的行为背景，并为当前交易提供置信度信号。换句话说，我们提供的是判断当前用户是否为该交易预期用户的置信水平。
      - [接收结果](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/capture-flow/receiving-the-result.md): SDK 通过在采集会话期间所使用的委托接口中定义的回调来返回采集结果。
    - [自定义](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/customization.md): 这些自定义选项仅在采集流程为 document-capture 或 liveness 时可用。
    - [错误处理](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/error-handling.md): iOS SDK 的所有错误处理集中在本节。onErrorAcessoBioManager 回调接收一个 ErrorBio 对象，该对象暴露 getCode() 和 getDescription()。
    - API 参考
      - [初始化 API](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/api-reference/initialization-api.md): | 类 | 描述 |
      - [采集 API](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/api-reference/capture-api.md): | 方法 | 描述 |
      - [回调 / 监听器接口](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/api-reference/callback-listener-interfaces.md): | 方法 | 触发条件 |
      - [自定义 API](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/api-reference/customization-api.md): | 方法 | 描述 |
      - [枚举](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/api-reference/enums.md): 定义要采集的文件类型。传入 openDocument 以配置采集会话。
    - [资源](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/resources.md): - 在应用启动时初始化 SDK（通常在 AppDelegate 的 didFinishLaunchingWithOptions 或 viewDidLoad 中），而不是在捕获按钮点击时初始化。与后端的身份验证需要几秒钟，如果与打开摄像头同时进行，会产生卡顿感。
      - [已知问题](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/resources/known-issues.md): - 流程结束时出现阴影 — 流程控制委托给 SDK 调用方。如果捕获成功后出现阴影或屏幕未关闭，请在 onSuccessSelfie 中实现释放逻辑：
      - [发行说明](https://developer.unico.io/zh-CN/developers/sdks-and-tools/ios/resources/release-notes.md): 始终将您的 iOS SDK 更新至最新可用版本。我们使用语义化版本控制对版本进行编号。
  - [Flutter SDK](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/requirements.md): | 要求 | 版本 / 值 |
    - [安装](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/installation.md): 要设置适用于 Flutter 的 Unico SDK，请按照以下步骤操作：
      - [特定设置](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/installation/specific-setup.md): SDK Key
    - [初始化](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/initialization.md): 在应用加载时初始化 SDK — 通常在 main() 中，或在入口 widget 的 initState() 中。请参阅最佳实践，了解为何不应在采集按钮点击时初始化。
    - 采集流程
      - 采集类型
        - [活体检测（生物特征自拍）](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/capture-flow/capture-types/liveness.md): 内嵌活体验证的生物特征自拍采集。SDK 通过 SmartFrames 引导用户，直到获取生物特征有效帧，并以 Base64 + JWT 形式返回图像。
        - [用户旅程](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/capture-flow/capture-types/user-journeys.md): 用户旅程（User Journeys）是由 SDK 与已配置流程协同编排的多步骤采集会话。例如，idchecktrustdocssign 流程将在单个会话中依次执行自拍、证件拍摄和签名。
        - [静默重新验证](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/capture-flow/capture-types/silent-revalidation.md): 使用静默重新验证引擎，在 Unico 网络效应范围内分析用户的行为背景，并为当前交易提供置信度信号。换句话说，我们提供的是判断当前用户是否为该交易预期用户的置信水平。
      - [接收结果](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/capture-flow/receiving-the-result.md): SDK 通过在采集会话期间所使用的监听器接口中定义的回调来返回采集结果。
    - [自定义](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/customization.md): 这些自定义选项仅在采集流程为 document-capture 或 liveness 时可用。
    - [错误处理](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/error-handling.md): Flutter SDK 的所有错误处理均集中在本节。onErrorUnico、onErrorSelfie 和 onErrorDocument 回调会接收一个 UnicoError 对象，该对象提供 getCode() 和 getDescription() 方法。
    - API 参考
      - [初始化 API](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/api-reference/initialization-api.md): | 类 | 描述 |
      - [采集 API](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/api-reference/capture-api.md): | 方法 | 说明 |
      - [回调 / 监听器接口](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/api-reference/callback-listener-interfaces.md): | 方法 | 触发条件 |
      - [自定义 API](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/api-reference/customization-api.md): | 方法 | 描述 |
      - [枚举](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/api-reference/enums.md): 定义要采集的文件类型。传递给 openCameraDocument 以配置采集会话。
    - [资源](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/resources.md): - 使用官方 Flutter 插件。 不要通过桥接方式实现原生 SDK — 这种方式会产生 Unico 工程团队未映射的错误。
      - [已知问题](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/resources/known-issues.md): - Release 构建失败但 debug 正常 — 可能是 Android 端的混淆问题。原生 SDK 不能被混淆。查看 ProGuard/DexGuard 规则。
      - [版本说明](https://developer.unico.io/zh-CN/developers/sdks-and-tools/flutter/resources/release-notes.md): Unico Flutter SDK 更新日志 — 版本历史、新功能、Bug 修复以及原生 Android 和 iOS SDK 更新。
  - [Web 集成](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web.md): Web & SDK 合约的客户端集成选项——重定向流、iFrame SDK 以及 JavaScript 采集库。
    - [Web SDK](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/requirements.md): 采集框架支持 WebRTC 以及以下浏览器的较新版本。非常旧的版本不保证功能正常。
      - [安装](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/installation.md): 配置 CSP，安装 Web SDK 包，并下载活体检测采集所需的资源文件。
        - [特定设置](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/installation/specific-setup.md): SDK Key
      - [初始化](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/initialization.md): 尽早初始化 SDK — 通常在包含捕获框架的页面或组件加载时进行。请参阅最佳实践，了解为什么不应该在点击捕获按钮时才初始化。
      - 采集流程
        - 采集类型
          - [活体检测（生物特征自拍）](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/capture-flow/capture-types/liveness.md): 内嵌活体验证的生物特征自拍采集。SDK 通过 SmartFrames 引导用户，直到获取生物特征有效的帧，并以 Base64 + JWT 的形式返回图像。
          - [文档捕获](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/capture-flow/capture-types/document-capture.md): 捕获身份证件。SDK 提供一个取景框辅助用户定位证件；定位完成后，用户点击按钮拍照。
        - [接收结果](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/capture-flow/receiving-the-result.md): SDK 通过传递给 open() 的 callback 对象返回采集结果。success 和 error 处理程序均为必填项。
        - [监控数据采集](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/capture-flow/monitoring-data-collection.md): 可附加到任何采集会话的可选元数据，用于在监控和可观测性工具中识别用户和流程。
      - [自定义](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/customization.md): Web SDK 支持两个维度的自定义：语言和视觉主题。
      - [错误处理](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/error-handling.md): Web SDK 的所有错误处理都集中在本节。error 回调接收一个 ErrorBio 对象，该对象暴露了 getCode() 和 getDescription() 方法。
      - [无障碍访问](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/accessibility.md): SDK 实现的组件已准备好支持 HTML 无障碍属性——aria-label、tabindex、role 等——这些属性支持键盘导航、激活语音引导，并可被屏幕阅读器软件使用。
      - API 参考
        - [初始化 API](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/api-reference/initialization-api.md): | 类 | 描述 |
        - [采集 API](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/api-reference/capture-api.md): | 方法 | 描述 |
        - [回调 / 监听器接口](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/api-reference/callback-listener-interfaces.md): Web SDK 使用传递给 open() 的单个 callback 对象，而非平台特定的监听器接口。
        - [自定义 API](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/api-reference/customization-api.md): | 方法 | 描述 |
        - [枚举](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/api-reference/enums.md): 定义自拍采集的摄像头模式。传递给 prepareSelfieCamera。
      - [资源](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/resources.md): - 在页面加载时初始化 SDK，而不是在点击采集按钮时初始化。与后端的身份验证需要几秒钟，如果与摄像头开启同时进行，会造成明显的延迟感。
        - [已知问题](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/resources/known-issues.md): - CSP 阻止 SDK 加载 — 若缺少必要的 CSP 指令（worker-src、script-src 等），Web SDK 将无法加载 Web Workers 及其他资源。查看 CSP 配置。
        - [发布说明](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-sdk/resources/release-notes.md): 请始终将您的 Web SDK 更新至最新版本。我们使用语义化版本控制对版本进行编号。
    - [Web 应用集成](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-integration.md): 如何在客户端集成 Web & SDK 合约——重定向流与 iFrame SDK 配置。
      - [资源](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-integration/resources.md): 关于集成 Unico Web App Integration SDK（unico-journey-sdk）的最佳实践和发布说明。
        - [发布说明](https://developer.unico.io/zh-CN/developers/sdks-and-tools/web/web-integration/resources/release-notes.md): Unico 网页应用集成 SDK（unico-journey-sdk）的更新日志——版本历史、新功能和升级说明。
  - [采集标准](https://developer.unico.io/zh-CN/developers/sdks-and-tools/capture-standard.md): 为获得 IDCloud 平台能力的最佳性能，我们建议使用我们的 SDK（Web、Android、iOS、Flutter）。它们能确保产品整体运行最佳，包括流失率和活体验证可靠性两个方面。
  - [最佳实践](https://developer.unico.io/zh-CN/developers/sdks-and-tools/best-practices-for-sdk-implementation.md): 集成、更新、测试并安全上线 Unico SDK 的准则，包括预发布（UAT）环境的安全规则。
  - [更新政策](https://developer.unico.io/zh-CN/developers/sdks-and-tools/update-policy.md): Unico SDK 更新政策：政策存在的原因、客户必须满足的最短时限，以及如何持续获得支持与保护。
- [Webhooks 与事件](https://developer.unico.io/zh-CN/developers/webhooks-and-events.md): IDCloud Webhook 简介 — 实时接收身份验证流程事件通知。
  - [配置](https://developer.unico.io/zh-CN/developers/webhooks-and-events/setup.md): IDCloud Webhook 配置分步指南 — 通过门户为 Web 和 SDK 进行自助配置，以及通过客户端为使用 Check 编排的 API 集成进行配置（仅限巴西）。
  - [事件类型](https://developer.unico.io/zh-CN/developers/webhooks-and-events/event-types.md): IDCloud Webhook 事件类型参考 — 流程完成、失败及状态变更负载说明。
  - [安全](https://developer.unico.io/zh-CN/developers/webhooks-and-events/security.md): 如何验证和保护 IDCloud Webhook 负载 — 签名验证与最佳实践。
  - [回退策略](https://developer.unico.io/zh-CN/developers/webhooks-and-events/fallback.md): 当 webhook 服务暂时不可用时，如何获取流程结果。
- [AI Agent 集成](https://developer.unico.io/zh-CN/developers/llms.md): 通过每个页面的 Markdown 版本、每种语言的 llms.txt 索引和页面操作栏，让 AI Agent 和 LLM 工具读取本文档。
- 区域解决方案
  - [无卡验证](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification.md): 无卡验证 REST API 文档——在支付交易中结合购物者身份识别与信用卡持卡人验证。
    - 关于无卡验证
      - [什么是无卡验证](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/about-idpay/unico-id-pay.md): 无卡验证是什么，以及它为支付交易提供的保障：活体检测、持卡人身份匹配和责任保护。
      - [功能](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/about-idpay/feature.md): 无卡验证的核心功能：支付交易和信用卡开通，以及二者的区别。
      - [使用场景](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/about-idpay/use-cases.md): 无卡验证在结账、预分析、分析工具、销售挽回和信用卡开通等场景中的应用。
      - [拒付](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/about-idpay/chargeback.md): Unico 针对无卡验证验证的拒付责任保障：适用情形、前提条件及例外情况。
    - [集成](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/overview.md): 无卡验证集成分步概览：进行身份验证、定制体验、创建交易并处理 Webhook 通知。
      - [身份验证](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/authentication.md): 无卡验证使用 OAuth2 服务账号（两方式，two-legged）身份验证来为 REST API 签发访问令牌。
        - [创建服务账号](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/authentication/creating-a-service-account.md): 如何为服务器到服务器的无卡验证身份验证申请服务账号，包括生成密钥对。
        - [准备向 API 发起已验证的请求](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/authentication/preparing-authenticated-request.md): 如何构建并签署 JWT、向 OAuth2 平台请求访问令牌，以及处理令牌响应与过期问题。
        - [附加资源](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources.md): 无卡验证身份验证的配套资源：JavaScript 实现示例、身份验证错误代码以及 Postman 集合。
          - [JavaScript 示例](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources/example-in-javascript.md): 用于构建和签署 JWT 并请求无卡验证访问令牌的参考 JavaScript 实现。
          - [身份验证错误](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources/authentication-errors.md): 无卡验证 OAuth2 身份验证平台返回的错误代码及各自的解决方法。
          - [Postman 集合](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources/postman-collection.md): 即用型 Postman 集合，涵盖无卡验证 REST API：支付交易、拒付和信用卡入驻。
      - [API](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/apis.md): 无卡验证产品的所有可用 REST 端点：API 参考、错误和枚举值。
        - [API 参考](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference.md): 无卡验证 REST API 的端点参考：支付交易、拒付、信用卡入驻和上下文信号。
          - [支付交易](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/payment-transactions.md): 无卡验证中用于创建支付交易、查询状态、获取证据以及重新发送通知的 REST API 参考。
          - [拒付](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/chargeback.md): 无卡验证中用于申请拒付分析并查询其状态的 REST API 参考。
          - [信用卡 Onboarding](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/credit-card-onboarding.md): 无卡验证信用卡 Onboarding 功能中用于验证信用卡并查询验证状态的 REST API 参考。
          - [上下文信号](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/context-signals.md): 无卡验证中用于检索已完成信用交易欺诈风险评估（自我欺诈或社会工程）的 REST API 参考。
        - [错误](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/apis/errors.md): 无卡验证 REST API 端点返回的 HTTP 状态码和错误响应概览。
        - [枚举](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated.md): 无卡验证 REST API 中使用的枚举值：交易结果代码和拒付结果代码。
      - [Webhook](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/webhook.md): 如何配置和接收无卡验证 Webhook 通知，包括请求/响应格式以及速率限制和幂等性等重要注意事项。
      - [控制体验](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/overview.md): 无卡验证 SDK 集成的工作原理——Webview、SDK 和 Redirect 标准，以及在您的应用程序中集成之前所需的 API 步骤。
        - [要求](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/requirements.md): 无卡验证 SDK 捕获框架的最低操作系统版本及浏览器/操作系统兼容性矩阵。
        - Mobile
          - [Android](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/android.md): 通过 CustomTabs 在 Android 中管理无卡验证捕获体验：依赖项、打开标签页、清单（Manifest）配置以及读取回调。
          - [iOS](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/ios.md): 两种推荐的方式，用于在 iOS 上管理无卡验证捕获体验：WKWebView 和 ASWebAuthenticationSession。
            - [WKWebView](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/ios/wkwebview.md): 如何在 iOS 上使用 WKWebView 实现无卡验证捕获体验：打开视图、控制何时关闭以及所需权限。
            - [ASWebAuthenticationSession](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/ios/aswebauthenticationsession.md): 如何在 iOS 上使用 ASWebAuthenticationSession 实现无卡验证捕获体验：身份验证控制器、会话设置以及所需权限。
          - [Flutter](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/flutter.md): 通过 inappwebview 在 Flutter 中管理无卡验证捕获体验：打开 webview、监控 URL 变化以及摄像头权限。
        - Web
          - [SDK](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/web/sdk.md): 如何为 Web 实现 Unico SDK：安装、init/open 方法、全屏指南以及 iFrame + 身份验证令牌安全模型。
          - [Redirect（已弃用）](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/web/redirect-deprecated.md): 无卡验证已弃用的 Web 集成模式：window.open() 和整页重定向。为获得更好的转化效果，建议使用 SDK。
      - [自定义](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/customizations.md): 无卡验证体验的 Logo、按钮颜色和形状自定义选项，以及无障碍对比度建议。
      - [静默验证](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/integration/silent-verification.md): 在无卡验证中为回访用户启用后台验证，通过信号和复现规律判断该笔交易是否可以静默通过。
    - 帮助与常见问题
      - [沟通最佳实践](https://developer.unico.io/zh-CN/developers/regional-solutions/card-not-present-verification/help-and-faq/best-communication-practices.md): 关于如何向终端用户传达无卡验证生物特征身份验证流程的技巧，以减少摩擦和支持工单。

## Product Guide

- [产品指南](https://developer.unico.io/zh-CN/product-guide.md): Unico 产品操作手册——逐步说明如何使用每个界面、每个字段和每项设置。
- [IDCloud 门户](https://developer.unico.io/zh-CN/product-guide/portal-idcloud.md): IDCloud 门户操作指南——配置客户体验、系统通知以及 QR 码验证。
  - 设置
    - [旅程定制](https://developer.unico.io/zh-CN/product-guide/portal-idcloud/settings/journey-customization.md): 直接在 IDCloud 门户中配置流程的视觉形象——徽标、颜色、背景和按钮形状——并提供实时预览。
    - [Webhook](https://developer.unico.io/zh-CN/product-guide/portal-idcloud/settings/webhook.md): 配置 IDCloud 在验证流程状态变化时通知您系统的位置、它如何针对您的 API 进行认证，以及当您的 API 无响应时会发生什么。
    - [QR 码](https://developer.unico.io/zh-CN/product-guide/portal-idcloud/settings/qr-code.md): 直接在 IDCloud 门户中启用验证流程中的 QR 码显示,让您的客户可以在桌面端开始流程,在移动端继续完成。