跳转到主要内容

三种身份验证方式

身份证件验证仍是一个可配置的功能,计费仍取决于所用的方式,但证件照片不再是唯一的途径。现在,您可以按国家选择允许用户使用哪些方式。
  • 证件采集,保持不变:您已配置的每种证件类型、采集规则和阈值都将完全按原样继续生效。未设置任何方式的工作流仍仅支持证件采集。
  • 非证件查询:用户输入其国民身份号码及若干个人信息,我们会将其与该国的权威数据源进行核对。无需证件照片或证件上传。在大多数国家,该数据源是政府登记库;在部分国家,则是征信机构、金融服务机构、公用事业或住址记录档案。覆盖范围表格列出了各国的具体数据源。
  • 数字身份钱包:五种方案已上线:MitID(丹麦)、Finnish Trust Network(芬兰)、Smart-ID(爱沙尼亚、拉脱维亚、立陶宛和比利时)、Mobile-ID(爱沙尼亚和立陶宛)以及 BankID Sweden 现已在生产环境中验证用户身份。用户使用其已持有的身份登录,钱包会共享一组已签名的属性。
  • 登录页面采用您的品牌:钱包登录页面会显示您的白标颜色,Smart-ID 和 Mobile-ID 运行于与流程其余部分相同的验证设计之中。
  • 路线图保持可见:目录中的所有其他钱包,包括 iDIN、Vipps、BankID Norway、itsme、Freja eID、Personalausweis、UAE PASS、gov.br、OneID 和 EUDI Wallet,均显示为即将推出,暂时无法启用。覆盖范围和价格请参阅钱包页面。
  • 按国家选择:身份证件验证步骤中的国家标签页可为每个国家开启或关闭各项方式和各个钱包,相同设置也可通过 API 配置。

返回照片的数据源同样可与自拍照比对

在政府登记库会返回当事人肖像的国家(南非、尼日利亚、阿根廷和巴拿马),查询也会接收一张自拍照并将其与该肖像比对,费用已包含在查询价格中。每个国家都有一个开关 skip_liveness_and_face_match(默认开启),开启后,工作流可在匹配成功后跳过其自身的活体检测和人脸比对步骤。关闭该开关,则仍会执行这些步骤。在阿根廷,您还可以选择不使用自拍照的查询方式,详见按国家选择查询数据源。

当某种方式未能通过时,由您决定如何处理

查询配有独立的开关,分别针对部分匹配、无匹配以及数据源无响应的情况。钱包则只有一个开关,针对登录失败、被取消或超时的情况。每个开关都会将用户引导至证件采集,或拒绝该会话。
  • 重试由您设置:1 至 5 次,默认为 1 次,且只计入数据源实际返回结果的查询。
  • 输入错误不收费:未通过格式校验的号码不会发送至数据源,因此既不计次,也不计费。
  • 保存前控制台会显示费用:每个查询开关都会明确列出该配置的费用。

每个结果都说明了验证方式

会话、决策 API 以及 status.updated Webhook 现在会携带完成每项身份证件验证的方式,以及与之对应的保证等级:证件对应 Documentary,查询对应 Data match,钱包对应 Cryptographic。各等级代表不同类型的证据,并非优劣排名。
  • 数据源比对:每个被比对的字段,包括用户提供的内容、数据源所持有的内容以及是否匹配;数据源未能响应时,还会提供单独的数据源错误详情。
  • 凭证详情:钱包、其签发机构、其声明的保证级别,以及签名是否通过校验。
  • 现有集成不受影响:证件会话仍报告 document 和 documentary,新增字段留空。

定价

证件采集保持不变:每次检查 $0.15,每月前 500 次检查免费。查询价格列于国家与标识符表格,按每次已响应的尝试以美元计价;钱包价格见钱包页面。查询多项服务的数据源会对每项已响应的服务计费,重试也可能产生额外费用。
  • 已响应即计费:数据源已响应的查询即计费,无论是否匹配。
  • 未响应不收费:从未响应的数据源不计费。
  • 回退的证件采集单独计费:回退至证件采集的用户,需另行支付该次采集的费用。
了解更多,请参阅身份证件验证方式、非证件查询和数字身份钱包。

按国家选择查询数据源

当某个国家的非证件查询有多个数据源时,您现在可以选择运行哪一个。
  • 每个国家一个数据源,由您选择:国家标签页可为每个提供多个数据源的国家选择数据源。
  • 阿根廷无需自拍照:阿根廷的国家登记库可在不使用自拍照的情况下查询,价格不变。由于不会返回肖像,您的活体检测和人脸比对步骤仍会随后运行。
  • 巴西配合已验证的自拍照:巴西可使用一个能够确认自拍照属于 CPF 持有人的数据源,之后的人脸比对步骤会使用该自拍照。

企业验证:选择购买的登记数据量

每个国家的登记核查现在分为三个数据等级,选择前即可看到价格。
  • Lite、股东或 UBOs:在 KYB Registry Check 步骤及一次性核查中按国家选择等级。控制台会显示该国家各等级的价格。
  • 新的独立 endpoint:POST /v3/kyb/shareholders/ 和 POST /v3/kyb/ubo/。响应会注明您请求的等级和实际交付的等级;若某国家或企业没有股权数据,则按 Lite 交付并计费。详见股东和UBOs。
  • 申请人无需等待登记库:申请人确认企业后即可继续,股权数据仍在获取中。企业记录会注明股权数据仍在获取中,而不是显示“无股权数据”。
  • 手动录入企业的价格明确:申请人手动输入的企业按固定 $0.75 计费,国家标签页会显示该费用。
工作流编辑器中的公司登记步骤,显示 Lite、Shareholders 和 UBOs 数据等级及其价格区间和登记覆盖范围

工作流编辑器在发布前发现错误

编辑器现在会标记那些会悄悄产生与您设计相反结果的工作流。
  • 标记相互矛盾的分支:分支条件与其路由到的结果相矛盾时,例如“ID 状态不是‘已拒绝’”却路由到会话被拒绝,画布上会显示警告标记。图谱验证 API 也会返回相同的警告
  • 按证件子类型分支:根据精确的证件子类型进行路由,例如区分身份证与居留许可
  • 查看会话走该路径的原因:会话时间线会显示每个分支决策以及结束会话的状态节点,在决策 API 中使用 include=events 参数时,也可通过 workflow_terminal_node_id 获取
  • 伪造阈值说明:身份证件验证步骤会说明每个伪造阈值的作用
工作流图编辑器中,一个分支的条件与其路由到的状态相矛盾,并显示警告标记

对人脸检查有更多控制

您可以决定何时运行人脸搜索,而且当某张人脸出现在另一份证件上时,现在可以据此拒绝会话。
  • 按工作流关闭人脸搜索:在活体检测和年龄估算的规则标签页中有一个开关(face_search_enabled)。默认开启,因此现有工作流不受影响。参见人脸搜索
  • 同一张脸,不同证件:选择当一张已在其他身份证件上通过的人脸再次出现时的处理方式,并在会话上查看判定结果
  • 拒绝并非实时录制的采集:活体视频分析现在可以拒绝会话,而不只是报告结果
  • 识别模拟摄像头:来自模拟或虚拟化设备的活体采集会产生一个您可以采取行动的风险提示
  • 每个结果都包含证件活体分数:即使未触发任何警告,决策 API 也会返回用于人像替换、纸质复印件和屏幕回放的 document_liveness 分数
  • 关键字段被遮挡:当证件号码或其他关键字段被遮挡时,会触发可配置的警告,包括独立的身份证件验证 API 中的情况
工作流编辑器中活体检测步骤的规则标签页,人脸搜索开关已打开,下方是重复人脸的处理操作

AML 筛查

您可以通过 API 管理持续监控,并且 AML 步骤可以对证件上提到的任何人进行筛查。
  • 通过 API 进行持续监控:POST /v3/users/aml-monitoring/ 和 POST /v3/businesses/aml-monitoring/ 可以一次为最多 1,000 个档案开启或关闭监控,支持仅用于估算的试运行,大批量操作会以任务形式运行。参见 AML 监控
  • 证明监控已运行:每个 AML 结果都会显示其持续监控证据
  • 筛查证件中提到的任何人:AML 步骤可以使用前面的 Document AI 步骤从税务证明或公司章程等文件中识别出的人员,并且您可以选择每个 AML 步骤筛查哪个实体
  • 钱包筛查作为单独检查:无需会话,即可从控制台运行按需钱包筛查。该检查项现在称为钱包验证与筛查
  • 在沙盒中演练 AML:POST /v3/aml/ 上的 sandbox_scenario 可以在没有终端用户会话的情况下模拟一次命中
标题为“通过 API 进行持续 AML 监控”的 Didit 卡片

交易监控

从现成的 iGaming 预设开始,并使用当前值过滤器和更广泛的货币列表优化规则。
  • iGaming 规则预设:为游戏平台提供的现成事件规则,例如奖金滥用和筹码倾销,位于规则库中
  • 当前交易值速率过滤器:速率条件可以按当前交易的金额进行过滤
  • 更多货币:货币选择器列出所有流通中的货币,交易 PDF 会按各货币自身的小数位数显示每个金额
  • 沙盒交易会注明环境:在沙盒应用上评估的交易会注明其环境,因此,规则运行结果为空时不会被误认为规则故障
交易监控规则库,显示 iGaming 规则预设

Didit Copilot

Copilot 会显示它做出的更改,允许您撤销,并且可以在控制台的更多范围内执行操作。
  • 查看并撤销更改:在编辑工作流的一轮对话之后,变更卡片会列出所做的更改,点击撤销即可还原
  • 斜杠技能:在输入框中输入“/”,即可列出当前页面可用的模板
  • 可操作控制台的更多部分:切换组织或应用、重命名应用、复制、重命名、归档或关联工作流,打开成员、角色、Webhook 和列表对话框,以及从会话中屏蔽用户或下载 PDF
  • 对话控制更多:可在页眉中选择回复语言,附加 Word 和纯文本文件,并从历史记录中删除所有对话
  • AI 披露:回复会在输入框下方标注为 AI 生成
  • 帮助中心中的 Copilot 操作:Copilot 可执行的操作列表已用所有语言记录在文档中
工作流编辑器中的 Didit Copilot 面板,斜杠技能菜单已展开,输入框下方显示 AI 披露

品牌设置:短信验证码和证件过期邮件中显示您的名称

  • 短信验证码中的您的品牌:自定义中新增的短信标签页可设置SMS 发送方名称,即验证码消息中显示的品牌名称,并附有实时预览。留空则使用应用的公开名称
  • 过期证件重新提交邮件:针对过期证件的重新提交邮件会说明该证件已过期,您可以在文本标签页中撰写此邮件的内容
自定义中的短信标签页,包含发送方名称字段以及验证码消息的实时预览

支持

  • 拖放工单附件:将文件拖放到工单上,或使用回形针图标
  • 关闭自己的工单:在控制台或 Copilot 中将工单标记为已解决,回复即可重新打开

会话 API 与 Webhook

  • 通过 API 获取用户历史 PDF:GET /v3/users/{vendor_data}/generate-pdf/ 返回一份带品牌标识的 PDF,内容为该用户最近 20 次已完成的会话,与控制台中的 下载 PDF 报告相同。请参阅生成 PDF
  • 地址证明与 Document AI 的编码识别:证件上发现的二维码和条形码会以 detected_codes 返回,并显示在会话审核中
  • 背面不可用警告:当你的工作流要求采集正反两面,但 Didit 的证件目录中没有该已识别证件的背面登记信息时,身份证件验证结果会带有信息性的 DOCUMENT_BACK_SIDE_NOT_AVAILABLE 警告,因此只能采集到正面
  • X-Signature-Simple 已弃用:请改用 X-Signature-V2 验证 Webhook。请参阅Webhook
  • 通过 MCP 进行 Webhook 投递:可通过 Didit MCP 列出并重新发送某个会话的 Webhook,详见下文

Didit MCP

你连接的 AI 代理现在可以解释会话决策、排查 Webhook 投递问题,并构建经过验证的工作流。
  • 解释决策:didit_session_explain_decision 会追溯会话为何以通过、拒绝或审核中结束:包括警告、状态规则或审核员的人工覆盖
  • 检查并重新发送 Webhook:didit_session_webhooks 列出会话的 Webhook 投递记录,并可等待第一次投递;didit_session_webhook_resend 重新发送其中一次投递
  • 根据简单规格构建工作流:didit_workflow_build_graph 将功能列表(国家/地区按你指定的名称填写)转换为完整且经过验证的流程图
  • 了解各国家/地区提供的服务:didit_workflow_get_kyb_registry_catalog 返回企业登记等级和价格,身份证件验证方法目录工具则返回各国家/地区的查询和钱包方式
更多信息请参阅 Didit MCP 工具。
Didit MCP 卡片,显示 didit_session_explain_decision 如何追溯会话被拒绝的原因

新增证件

  • 警察身份证件:现已在阿根廷、文莱、哥伦比亚和菲律宾获得支持
  • 新增加拿大、摩尔多瓦和美国证件:2026 年版艾伯塔省驾照和身份证(支持条形码验证)、2026 年版摩尔多瓦驾照,以及 2019 年版 NYC 身份证件
  • 支持采集背面:巴西各州驾照、泰国驾照以及加拿大护照的 B 页,现可采集正反两面
  • ePassport 信任库已更新:包含最新的国家/地区签名证书
标题为新增证件的 Didit 卡片

Web SDK 从 0.3.0 升级到 0.4.0

@didit-protocol/sdk-web 本月从 0.3.0 升级到 0.4.0。使用 npm install @didit-protocol/sdk-web@latest 进行升级;你已经调用的所有功能都将继续正常工作。
  • 从浏览器提交交易:submitTransaction() 使用限定范围的交易 token 提交交易以进行监控,并自动收集设备情报。请参阅 SDK 交易提交
  • 钱包所有权检查:当交易要求进行钱包所有权检查时,SDK 会执行该检查,并通过回调报告完成情况
  • 新增四种弹窗语言:波斯尼亚语、哈萨克语、吉尔吉斯语和阿尔巴尼亚语
  • 网页端支持原生 SDK 的摄像头选项:defaultDocumentCamera、defaultLivenessCamera、showDocumentCameraSwitchButton 和 showLivenessCameraSwitchButton 可让你使用后置摄像头进行人脸采集,适用于自助终端或由操作员将设备对准被验证人的场景,并可隐藏采集界面内的切换按钮。设备没有所请求的摄像头时,将继续使用其现有摄像头。如果你直接打开验证 URL,需自行设置对应的查询参数(liveness_camera=back、liveness_camera_switch=false 等)
更多信息请参阅 Web SDK 指南。
标题为 Web SDK 0.4.0 的 Didit 卡片

原生 SDK 4.9.0

iOS SDK、Android SDK、React Native SDK 和 Flutter SDK 均已升级至 4.9.0,其中 React Native 和 Flutter 包含相同的原生版本。无需更改任何集成 API。
  • 让用户选择语言:设置 showLanguageSelector 后,欢迎界面会显示与网页流程相同的紧凑、可搜索语言选择器。默认隐藏(4.9.0)
  • 应用中的身份证件验证方法:为某国家/地区配置了国民身份号码查询、数字身份钱包登录或两者兼有时,这些方法会与证件采集一同显示在同一个入口界面,与网页端流程相同。查询会采集该国家/地区要求的字段,并在发送前于设备端进行校验;如果你的配置允许,则会回退为证件采集(4.8.0)
  • 入口界面的证件插图:iOS 方法选择器中的每种证件类型都会显示其专属插图(4.8.0)
  • 更清晰的问卷错误信息:问卷提交被拒绝时,用户将看到服务器返回的原因(4.8.0)
标题为原生 SDK 4.9.0 的 Didit 卡片

Didit Academy:28 节新课程

28 个全新的简短控制台操作演示,每个 2 至 7 分钟,均在真实控制台中录制,每个都附有书面摘要,可在 didit.me/academy 查看。
开始使用 构建 运营 浏览全部课程,请访问 didit.me/academy。

改进内容

  • 选择不参与模型训练:设置 中的组织设置用于控制您的验证数据是否可用于改进 Didit 的模型
  • 更清晰的低余额警报:警报中会显示组织名称和您设置的阈值
  • 发票包含您的联系信息:您组织的联系信息会显示在每张发票上
  • 沙盒运行真实的主动活体检测采集:在沙盒中测试用户会看到的同一主动活体检测流程
  • 用户资料中显示手动上传内容:您手动上传的证件和人脸会显示在用户资料中
  • 自定义域名仅适用于生产环境应用:沙盒应用上的 域名 选项卡说明,自定义域名仅适用于生产环境应用
最后修改于 2026年11月7日