Didit

厂商定位

Didit 当前在知识库中主要作为 证件 OCR 识别与证件防伪供应商 维护。它适合用于 App 端证件采集、证件字段结构化抽取、证件图像质量判断、防翻拍/防篡改和 KYC 决策结果留痕。

Didit 也提供活体、人脸比对、AML、NFC、电话/邮箱/IP/住址核验等能力，但当前重点先沉淀 OCR Session 与 Retrieve Session Decision 两条链路。

能力归属

• KYC 能力
• 合规能力

已整理资料

• Didit OCR 与证件防伪接入说明
• Didit Session 接口与字段映射

能力拆分

能力	接口 / 资料	业务定位
创建 OCR 会话	POST /v3/session/	后端创建核验会话，返回 session_id 和 session_token 给 App
App 端证件采集	Didit Android SDK	App 用 session_token 启动采集，图片直传 Didit，不经过我方后端
查询最终决策	GET /v3/session/{session_id}/decision/	后端获取 OCR 字段、证件防伪 warnings、会话状态和最终结论
Webhook 回调	status.updated	Didit 主动通知会话状态变化，我方验签、去重、落库
证件防伪	id_verifications[].warnings[]	识别屏幕采集、打印件/复印件、证件头像篡改等风险

当前接入结论

• Didit 是异步 session-based 模式，不是一次同步请求直接返回 OCR 结论。
• API Key 只放后端，App 只拿短期 session_token。
• OCR 与证件防伪的权威结果以 GET /v3/session/{session_id}/decision/ 为准。
• 程序判断应读取 id_verifications[].status、warnings[].log_type 和 warnings[].risk，不要依赖面向人的描述文案。
• 当前资料足以进行接口设计和字段映射，但 webhook 签名 header、payload 层级、沙盒 application、workflow_id、测试环境权限仍需联调确认。

适用场景

• 开户前证件 OCR 识别。
• 贷款申请前证件字段抽取与复核。
• 证件原件性、防翻拍、防打印件、防头像篡改判断。
• 人工复核时查看 OCR 字段、warnings、reviews 和原始决策 JSON。

接入待确认

• Sandbox / Live application、API Key、workflow_id 是否已开通。
• Webhook 签名算法、header 名和编码是否与当前实现一致。
• OCR 工作流是否只做证件识别与防伪，还是同时启用活体、人脸比对、AML 等节点。
• 是否需要补齐 sandbox_scenario、expected_details、contact_details 透传，方便沙盒联调。
• 证件媒体、短期签名 URL、原始 Decision JSON 的保存范围和留存期限。