用户 KYC 历史：会话与重新验证

用户曾进行过的每个用户验证（KYC）会话都会永久关联到其 User 实体。您可以检索完整历史记录、查看单个会话的结果、触发重新验证，并导出合规报告。

列出用户的所有会话

按 vendor_data 筛选会话列表：

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42" \
  --data-urlencode "page_size=50"

响应包含该用户的每一个会话，无论其状态如何：已通过、已拒绝、审核中、已放弃或已过期。

了解功能汇总数据

User 实体的 features 映射反映所有会话中每项功能的最新状态：

"features": {
  "id_verification": "APPROVED",
  "liveness": "APPROVED",
  "face_match": "APPROVED",
  "aml": "IN_REVIEW"
}

请将其作为快速判断“用户当前是否已通过验证？”的捷径。如需完整的历史记录（所有会话、所有功能、所有结果），请列出会话并逐个查看其决策。

检查单个会话

curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"

决策结果包括：

各项功能的结果（证件、活体检测、人脸比对、AML、地址证明、NFC 等）
提取的证件数据和图片（签名 URL）
AML 命中记录及匹配分数和风险分数
设备与 IP 分析以及设备信息
审核员备注和人工操作记录

完整的数据结构请参阅检索会话。

触发重新验证

当您需要用户重新验证时（例如年度重新 KYC、证件到期或基于触发器的复查）：

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_reverification",
    "vendor_data": "user-42"
  }'

新会话会关联到同一个 User 实体。会话完成后，该实体的 features 映射会更新为新的结果。

重新提交与新建会话

场景	使用方式
用户会话因可修复的问题被拒绝（证件模糊、光线不佳）	重新提交：使用同一会话，重新上传
完整重新验证或定期重新 KYC	创建全新会话
交易规则触发的补救	交易会自动创建补救会话（`AWAITING_USER` 状态）

导出合规报告

用于审计、可疑交易报告（SAR）或监管机构请求时，可为任意会话生成 PDF：

curl https://verification.didit.me/v3/session/{session_id}/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o session-report.pdf

如需将用户的完整历史记录汇总到一个文件中，请下载用户历史 PDF：文件首页包含档案摘要、功能状态和会话索引，其后是每个可报告会话的完整报告，按从旧到新排列，最多包含最近的 20 个会话。

curl --fail https://verification.didit.me/v3/users/user-42/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o user-history.pdf

该文档与控制台中 Users → [user] → Actions → Download PDF 生成的文档相同。如需跨多个用户批量导出 CSV，请使用 Review & Operations → Export PDF/CSV 中的全应用导出功能。

与第三方共享会话

当您需要与合作伙伴应用共享用户的验证结果时（例如可复用 KYC 场景），请使用：

POST /v3/session/{session_id}/share/：生成可共享的 token。
POST /v3/session/import-shared/：在接收方导入共享会话。

完整流程请参阅可复用 KYC。

基于历史记录的工作流

利用会话历史做出更智能的合规决策：

如果用户在 N 天内已有通过的活体检测，跳过相应步骤。
如果用户最近一次会话被拒绝，要求额外检查。
当用户的会话数量异常激增时，标记该用户。
通过持续监控功能监控持续进行的 AML 重扫。

后续步骤

数据模型

了解 features 映射和计数器的计算方式。

检索会话

完整的会话决策数据结构。

可复用 KYC

在多个应用之间复用已验证的数据。

概览

定价

工作流与验证

审核与运营

实体（用户与企业）

设置与自定义

安全与合规

Didit 学院

资源

用户 KYC 历史：会话与重新验证

列出用户的所有会话

了解功能汇总数据

检查单个会话

触发重新验证

重新提交与新建会话

导出合规报告

与第三方共享会话

基于历史记录的工作流

后续步骤

数据模型

检索会话

可复用 KYC

​列出用户的所有会话

​了解功能汇总数据

​检查单个会话

​触发重新验证

​重新提交与新建会话

​导出合规报告

​与第三方共享会话

​基于历史记录的工作流

​后续步骤

数据模型

检索会话

可复用 KYC

列出用户的所有会话

了解功能汇总数据

检查单个会话

触发重新验证

重新提交与新建会话

导出合规报告

与第三方共享会话

基于历史记录的工作流

后续步骤