> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Didit 更新日志：2026 年 5 月身份验证更新

> Didit 2026 年 5 月发布：原生 SDK 4.0 支持模块化变体，文件活体检测可配置，新增南非数据库核验与墨西哥 INE 校验。

### 原生 SDK 4.0：模块化变体

今年规模最大的原生 SDK 发布。iOS、Android、React Native 和 Flutter 均推出了 4.0 版本线，将 SDK 拆分为相互独立的变体，让您只需集成真正需要的二进制文件。

* **四种变体**：`Core`（无 NFC，无自动采集）、`AutoDetection`（自动采集，无 NFC）、`NFC`（NFC 读取，无自动采集）和 `All`（全部功能）
* **iOS Core 体积减少 84%**：磁盘占用约 6 MB，IPA 压缩后约 3 MB，而 3.x 版本约为 40 MB，适用于不需要基于 MediaPipe 的自动采集功能的应用
* **向后兼容**：现有的 `pod 'DiditSDK'` 和 Gradle 集成无需修改即可继续使用；`All` 为默认变体
* **各平台的选择方式**：iOS 上为 CocoaPods 子规范和 SPM 库产品，Android 上为独立的构件，React Native 上为 Expo 配置插件标志，Flutter 上为 `DIDIT_SDK_IOS_VARIANT` / `$DiditSdkIosVariant`
* **迁移指南**：每个 SDK README 中均新增了表格，说明安装矩阵以及如何从 3.x 迁移

![Didit 原生 SDK 4.0 模块化变体，适用于 iOS、Android、React Native 和 Flutter](https://mintcdn.com/didit-0f962782/5cj1EteGq5bbThZl/images/changelog/may-2026/native-sdk-4.png?fit=max\&auto=format\&n=5cj1EteGq5bbThZl\&q=85\&s=4e510f464f74489edd59bae07ff0d274)

### 可配置的证件活体检测

证件活体检测已从单一的通过/拒绝开关，升级为按欺诈类型细分的更丰富配置。该配置既可通过 API 设置，也可在工作流编辑器中全新的 Forgery 标签页中设置。

* **按欺诈类型设置阈值**：为屏幕翻拍、打印件和人像替换分别设置独立的**拒绝**和**审核**分数
* **控制台中全新的 Forgery 标签页**：三个滑块取代了原有的通过/审核/拒绝选项，并已为所有支持的语言完成本地化
* **每次警告均附带证据**：会话工具提示现在会显示实际活体分数、生效阈值、决策类别（或决策档位），以及结果来自证件的哪一面
* **上传场景判断更准确**：合法扫描或拍摄证件时误报的"打印件"警告已被移除；屏幕翻拍和人像篡改在上传时仍会触发

![工作流编辑器 Forgery 标签页中的可配置证件活体检测阈值](https://mintcdn.com/didit-0f962782/5cj1EteGq5bbThZl/images/changelog/may-2026/configurable-document-liveness.png?fit=max\&auto=format\&n=5cj1EteGq5bbThZl\&q=85\&s=e16fdb8399ca71a6df910b7c9ad1b06a)

### 正反面一致性检查

新增的检查可识别上传的证件正面与另一张证件背面不一致的用户。该检查首次在生产环境中捕获了一张玻利维亚 cedula（身份证）的此类情况。

* **新的 `DATA_INCONSISTENT` 风险**：当正面的 OCR 数据与背面不匹配时触发
* **工作流操作**：通过现有的 `inconsistent_data_action` 设置，将不一致的提交路由至**拒绝**、**审核**或**通过**
* **正确保存**：即使 OCR 最初将正反面标签互换，保存的正面图像始终与正面步骤一致

### 南非数据库核验扩展

南非的覆盖范围已从单一的国民身份证检查扩展为完整的数据源套件，所有数据源均可通过同一数据库核验 API 调用。

* **南非内政部**：指纹比对和 DHA 照片查询
* **车辆数据**：车辆所有权查询，以及按 VIN 查询
* **企业数据**：公司登记、公司董事和个人董事任职
* **银行与消费者信号**：银行账户持有人验证和可联系性
* **欺诈与 AML**：欺诈防范检查、难民身份验证，以及按人脸进行的犯罪记录筛查
* **更便宜的国民身份证核验**：南非国民身份证核验已迁移至新的集成，单次调用成本显著降低

![Didit 数据库核验，南非数据源覆盖范围扩展](https://mintcdn.com/didit-0f962782/5cj1EteGq5bbThZl/images/changelog/may-2026/south-africa-database-validation.png?fit=max\&auto=format\&n=5cj1EteGq5bbThZl\&q=85\&s=92550f269a92e6b98eb8b5623ceb6fcb)

### 墨西哥 INE 选民卡有效性

墨西哥 INE/IFE 选民卡现可实时对照官方登记库进行核验。

* **证件有效性**：确认证件型号（`modelo`）、有效期（`vigencia`），以及是否可作为身份证明使用
* **投票权**：确认持卡人的投票权状态

### AML 筛查优化

当身份信息未发生变化时，重新提交的 AML 筛查现已去重，因此您不会再为同一人的重复筛查被重复计费。

* **相同重新提交时跳过**：与上一次筛查相比，姓名、出生日期、国籍和证件号码均未变化的，将不再进行新的筛查（也不会产生新的费用）
* **身份确实发生变化时行为不变**：首次筛查、沙盒会话以及独立 AML endpoint 上的行为保持不变
* **同样适用于 KYB**：企业身份未变化的重新提交，企业 AML 筛查同样进行去重

### 上传用户人脸

通过 **Upload User Face** endpoint 导入的人脸，现在与验证会话中采集的任何人脸表现一致。

* **在用户资料中可见**：人像会像正常采集的图像一样显示在控制台的用户详情页上
* **纳入重复检测**：导入的人脸现已纳入 1:N 搜索索引，因此在其他供应商数据标识符下重新注册的情况会被正确标记
* **便于历史数据回填**：在将现有身份数据库迁移至 Didit 时非常有用

### 白标自定义域名错误

当 DNS 服务商的 CAA 记录确实阻止证书签发时，自定义验证域名不再无提示地显示为"已验证"。

* **显示真实错误**：控制台现在会显示具体原因（通常是 CAA 记录阻止 AWS 签发 SSL 证书）
* **5 步修复指引**：需要添加的具体 DNS 记录已列在自定义页面中
* **不再有隐性失败**：看似已验证但无法加载的域名，会在到达最终用户之前被检测出来

![Didit 白标验证域名的自定义域名错误诊断](https://mintcdn.com/didit-0f962782/5cj1EteGq5bbThZl/images/changelog/may-2026/custom-domain.png?fit=max\&auto=format\&n=5cj1EteGq5bbThZl\&q=85\&s=a442091912ad56ff6836bec035028e7e)

### 重新设计的交易类邮件

全部 11 封身份验证与组织相关邮件均已按照控制台设计系统重新构建，采用简洁的白色版式、全宽胶囊形 CTA 按钮，以及以文字为主的页脚，页脚包含 `hello@didit.me`。白标客户的验证邮件仍会显示其自有的徽标和主题。

### 复合姓名匹配

数据库核验查询现已能正确处理消费者记录服务中的复合名。

* **美国**：“Jorge Luis”“Miguel Angel Jr”等西班牙语双名模式现已能正确匹配
* **英国**：“Lukasz Marcin”等复合名现在会被解析为名加中间名，而不再被当作单个词元处理

### 新增证件支持

* **Tax Card 证件类型**：在 iOS、Android、Flutter 和 React Native SDK 中新增的证件子类型，用于税务居民身份验证
* **荷兰 2025 年驾照**：新版设计已端到端支持
* **巴西数字驾照**：双面采集现在会以“Side C”/“Page B”标记保存正确的正面照片和背面图像
* **西班牙难民公约旅行证件**：使用 D / DV / TI MRZ 前缀和 `XXA` 国籍的同类无国籍旅行证件现已能正确解析
* **11 种新增支持的证件**：根据真实提交数据同步至生产环境注册表

### 蒙古语

验证流程及全部四个原生 SDK 现已支持蒙古语（mn），语言覆盖范围增至 54 种。

### 原生 SDK 发布

除 4.0 模块化变体外，各原生 SDK 持续发布稳定性修复，直至五月。

* **Android SDK 3.5.3 – 4.0.2**：证件照片质量与人脸引导页样式、结果不明确的网络故障后的恢复、完成时白标主题闪烁修复、证件和活体检测的相机切换及状态重置、视频片段缺失时的上传保护、条款与翻译更新、前置摄像头自拍照采集修复、返回按钮与问卷细节优化、蒙古语支持，以及 4.0 版本中可配置的默认摄像头和切换按钮可见性
* **iOS SDK 3.3.3 – 4.0.2**：证件采集质量以及可播放的 MP4 / H.264 上传、后端响应中断后的步骤恢复、可选的无 NFC 构建、内联 podspec 许可证、3.5 / 3.6 常规版本，修复了由 Swift 6 运行时符号引起的 iOS 13–17 上 `EXC_BAD_ACCESS` 严重崩溃问题，支持蒙古语，以及 4.0 版本中的模块化变体拆分和 Tax Card 支持
* **React Native SDK 3.2.11 – 4.0.1**：每个周期都同步至最新的原生 iOS 和 Android 版本；Expo 配置插件新增 `iosNfcEnabled` / `androidNfcEnabled` 标志，供使用者选择无 NFC 变体；4.0 版本提供完整的变体矩阵
* **Flutter SDK 3.5.0 – 4.0.2**：同步至最新的原生 iOS 和 Android 版本，新增 Android 无 NFC 构建选项，开放完整的原生配置项（`showCloseButton`、`showExitConfirmation`、`closeOnComplete`），4.0 版本支持原生变体选择和 Tax Card

### 设备智能

服务端设备指纹识别更加准确，也更难被欺骗。

* **需要确定性锚点**：模糊指纹匹配现在要求存在基于硬件的标识符（Android SSAID 或 Widevine，iOS 为 `identifierForVendor`），才能关联两个会话，从而消除误报
* **TLS / JA4 佐证**：网页指纹现在会与 TLS 指纹信号相互佐证，以实现更可靠的确定性匹配分类

### 改进

* 当用户在最后一次允许的尝试中成功重新拍摄证件时，过期的“图片过于模糊”警告不再附加到已通过的会话上
* 人脸采集算法现在使用真实的边界框几何数据，而非归一化范围，并新增“远离一点”和“靠近一点”提示，同时针对不同设备进行稳定性调优
* 相机权限错误在整个验证流程中的分类保持一致，提示信息更清晰，可区分权限超时与相机访问失败
* 未验证账户不能再永久占用邮箱地址：重新注册将接管未验证的记录，而不再被阻止
* 工作流图谱和问卷编辑器的全屏切换现在可在 Safari 上正常使用
* 在约 35 个支持地址的数据库核验服务中，修复了澳大利亚 ImmiCard 与旅行证件字段、新西兰护照有效期以及结构化地址解析的问题

### 修复

* 修复了 ID Verification API 返回的 `front_image` 裁剪图损坏的问题：OCR 过程中正反面被互换时会出现该问题（阿根廷 2019 和 2020 年身份证）
* 修复了重新提交的会话缺失 `FILE_UPLOADED` 事件的问题，该问题曾导致重新提交的证件在控制台中显示为没有文件
* 修复了整个网页验证流程中的翻译和白标定制问题


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.