跳转到主要内容
用户在验证期间上传的每份证件都会永久关联到其 User 实体。本页说明收集的内容、如何获取证件，以及如何手动上传其他证件。

​
Didit 收集的内容

支持的证件类型涵盖完整的国家/地区 × 证件类型矩阵（220+ 个国家/地区，14,000+ 种证件）。

​
获取证件

证件与收集它的会话相关联，而不是直接与用户关联。要列出某个用户的所有证件，请执行以下步骤：
1

列出用户的会话

2

获取每个会话的决策

每个会话决策都包含已收集证件的 URL。
检查响应中的 id_verification.document_images、proof_of_address.document_images 和 liveness.images 字段。
3

使用签名 URL

响应中的图片 URL 是短期有效的签名 URL。请将其缓存在客户端以供使用，或在过期后重新获取决策。

​
生成 PDF 报告

如需为某个会话导出便于阅读的完整记录（包括所有证件），请使用： GET /v3/session/{session_id}/generate-pdf/ 该接口返回一份 PDF，其中包含会话详情、功能结果以及嵌入的证件图片。适用于合规审计、SAR 附件和监管备案。

​
从控制台上传证件

合规人员可以为某个用户或某个活跃会话上传其他证件：
  1. 进入 Users → [user] → Documents → Upload document。
  2. 选择证件类型（ID、POA 或自定义）。
  3. 上传文件；对于受支持的类型，会自动运行 OCR。
  4. 证件会关联到最近的会话（或者您可以创建一个修复会话）。
证件上传界面仅在控制台中提供，没有可将证件直接关联到用户的公开 API 端点。请将会话作为所有证件采集的入口。

​
证件交叉核验

当一个会话收集了多种类型的证件时，Didit 会进行交叉核验：
  • ID ↔ 活体检测：证件上的人脸与活体检测自拍照一致。
  • ID ↔ 地址证明：地址证明上的姓名与从证件中提取的姓名一致。
  • ID ↔ NFC：MRZ / 视觉数据与 NFC 芯片数据一致。
不一致之处会以警告的形式显示在会话决策中，并可配置为触发人工审核。

​
证件监控与重新验证

对于需要持续确认证件有效性的场景（例如已过期的证件）：
  • 证件有效期会在每份已验证的身份证件上记录。查询会话决策中的 expiration_date 字段即可获取。
  • 证件监控：默认开启且自动运行，无需手动启用。证件到期日期过后，状态为 "Approved" 的会话会变为 "Kyc Expired"，身份证件验证结果会新增 DOCUMENT_EXPIRED 警告，并触发一次 status.updated Webhook。到期日期之前不会发送任何警告。
  • 关闭监控：在身份证件验证设置中，针对对应的国家/地区和证件类型，将 Expiration mode 设置为 Allow expired。默认的 Reject expired 才会进行监控。以 Allow expired 接受的证件永远不会被监控。
  • 重新验证：使用相同的 vendor_data 发起新会话，以刷新证件。

​
证件地理位置

身份证件地理位置检查会将提交者的 IP 位置与证件的签发国家/地区进行比较。结果会附在会话决策中。

​
隐私与数据保留

  • 所有证件均在静态存储时加密。
  • 图片访问通过短期有效的签名 URL 进行。
  • 数据保留遵循应用的数据保留政策。
  • 用户有权请求删除；删除会移除图片、OCR 提取结果和 NFC 数据。

​
后续步骤

身份证件验证

了解证件采集和 OCR 的工作方式。

地址证明

POA 证件采集。

会话决策

GET /v3/session//decision/ 参考文档。
最后修改于 2026年11月7日