跳转到主要内容
Finnish Trust Network (FTN) 允许符合条件的用户使用芬兰银行身份或受支持的移动证书来验证其身份。 使用 Finnish Trust Network API 可直接从您自己的应用中启动银行认证,而无需通过工作流。 FTN 也可在 Didit 的身份证件验证工作流步骤内运行,使用钱包标识符 ftn 以及国家/地区代码 FIN。 对于下文介绍的托管集成,请使用与其他 Didit 工作流相同的会话创建、会话结果和 Webhook。
Finnish Trust Network 适用于芬兰。 在工作流中为 FIN 接受的钱包启用 ftn。 公布的价格为每次完成验证 $0.25。 有关所有受支持钱包的信息,请参阅钱包覆盖范围和定价。

用户流程

  1. 用户从您工作流接受的身份验证方式中选择芬兰和 Finnish Trust Network。
  2. 用户选择一家合作银行或受支持的移动证书。
  3. 用户使用该服务进行认证并授权身份验证。
  4. 用户返回 Didit 会话,会话验证身份结果并继续工作流。
用户需要在所选服务中拥有有效身份,并能够使用其认证方式。 他们仅在该服务的认证界面中输入银行凭据和授权码。 Didit 不会在其验证表单中索要银行密码。 Didit 的方式选择器和返回屏幕使用该会话的品牌化和自定义域名设置。 所选银行或身份服务负责控制其自身的认证屏幕。

配置工作流

在控制台中打开工作流的身份证件验证步骤,选择国家/地区,然后打开芬兰。 在可接受的钱包下,在可用时启用 Finnish Trust Network。 如果希望用户也能改用证件,请保持证件验证处于启用状态。 在创建新会话之前,保存并发布工作流。 以下是 methods 配置片段,并非完整的工作流请求:
如果钱包不可用,保存工作流时将被拒绝。 完整 API 规范请参阅工作流功能配置,可视化设置请参阅控制台配置。

验证结果

已完成的 FTN 检查将返回具有 cryptographic 保证级别的钱包验证结果。 所验证的身份包括用户的姓名、出生日期以及个人标识符(当所选身份验证方式返回这些信息时)。 FTN 不返回人像照片。 请检查实际结果,而不要假定每个可选的身份字段都存在。 会话的凭据卡片会显示所选钱包及其已验证的证据。 结果架构请参阅身份证件验证数据模型。 成功的 FTN 认证将完成身份证件验证步骤;其余检查仍将决定会话的最终决策。 当您的工作流需要单独的活体检测和人脸比对步骤时,请保持这些步骤的配置。

取消和证件回退

如果用户取消、请求过期或验证失败,Didit 将应用该国家/地区的 wallet.on_failure 设置。 fallback_to_document 会在芬兰启用证件验证时启动证件采集。 decline 则会拒绝该身份证件验证步骤。 已禁用的证件验证方式不能作为回退选项。 若要先引导用户使用 Finnish Trust Network,并在失败后才显示证件采集,请将 document.fallback_only 设置为 true。 请参阅仅在回退时提供证件采集。 重定向或显示的银行选择器并不代表身份验证成功。 在授予访问权限之前,请等待已验证的会话结果或 Webhook。 请使用与集成其余部分相同的幂等性处理来应对重复的 Webhook 投递。

测试和上线

在启用了该钱包的环境中对其进行测试。 测试应涵盖成功返回、用户取消、过期、不完整身份以及证件回退。 还要测试您的用户所依赖的设备和浏览器环境。 沙盒环境中的模拟结果并不能证明真实的银行认证或生产环境激活正常工作。 FTN 的公布基础费率为每次完成验证 $0.25。 已取消、已过期和失败的钱包尝试不会产生完成钱包验证的费用。 完成的证件回退验证将根据证件验证定价单独计费。 有关最新的计费规则,请参阅钱包定价。

相关指南

最后修改于 2026年11月7日