> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 芬兰信任网络 (FTN) 集成指南

> 通过 Didit 为芬兰配置芬兰信任网络 (FTN) 身份验证：涵盖银行登录、工作流配置、核验结果及证件回退方案。

Finnish Trust Network (FTN) 允许符合条件的用户使用芬兰银行身份或受支持的移动证书来验证其身份。
使用 [Finnish Trust Network API](https://docs.didit.me/zh/api-reference/digital-id-wallets/ftn.md) 可直接从您自己的应用中启动银行认证，而无需通过工作流。
FTN 也可在 Didit 的**身份证件验证**工作流步骤内运行，使用钱包标识符 `ftn` 以及国家/地区代码 `FIN`。
对于下文介绍的托管集成，请使用与其他 Didit 工作流相同的会话创建、会话结果和 Webhook。

> [!NOTE]
>
> **Finnish Trust Network 适用于芬兰。**
> 在工作流中为 `FIN` 接受的钱包启用 `ftn`。
> 公布的价格为**每次完成验证 \$0.25**。
> 有关所有受支持钱包的信息，请参阅[钱包覆盖范围和定价](https://docs.didit.me/zh/core-technology/id-verification/digital-id-wallets.md#定价)。

## 用户流程

1. 用户从您工作流接受的身份验证方式中选择芬兰和 Finnish Trust Network。
2. 用户选择一家合作银行或受支持的移动证书。
3. 用户使用该服务进行认证并授权身份验证。
4. 用户返回 Didit 会话，会话验证身份结果并继续工作流。

用户需要在所选服务中拥有有效身份，并能够使用其认证方式。
他们仅在该服务的认证界面中输入银行凭据和授权码。
Didit 不会在其验证表单中索要银行密码。

Didit 的方式选择器和返回屏幕使用该会话的品牌化和自定义域名设置。
所选银行或身份服务负责控制其自身的认证屏幕。

## 配置工作流

在控制台中打开工作流的**身份证件验证**步骤，选择**国家/地区**，然后打开**芬兰**。
在**可接受的钱包**下，在可用时启用 Finnish Trust Network。
如果希望用户也能改用证件，请保持证件验证处于启用状态。
在创建新会话之前，保存并发布工作流。

以下是 `methods` 配置片段，并非完整的工作流请求：

```json theme={null}
{
  "FIN": {
    "document": { "enabled": true },
    "wallet": {
      "enabled": true,
      "providers": ["ftn"],
      "on_failure": "fallback_to_document"
    }
  }
}
```

如果钱包不可用，保存工作流时将被拒绝。
完整 API 规范请参阅[工作流功能配置](https://docs.didit.me/zh/management-api/workflows/feature-configs.md#ocr-/-身份证件验证)，可视化设置请参阅[控制台配置](https://docs.didit.me/zh/console/id-verification-methods.md)。

## 验证结果

已完成的 FTN 检查将返回具有 `cryptographic` 保证级别的钱包验证结果。
所验证的身份包括用户的姓名、出生日期以及个人标识符（当所选身份验证方式返回这些信息时）。
FTN 不返回人像照片。
请检查实际结果，而不要假定每个可选的身份字段都存在。

会话的**凭据**卡片会显示所选钱包及其已验证的证据。
结果架构请参阅[身份证件验证数据模型](https://docs.didit.me/zh/reference/data-models.md#身份证件验证)。
成功的 FTN 认证将完成身份证件验证步骤；其余检查仍将决定会话的最终决策。
当您的工作流需要单独的活体检测和人脸比对步骤时，请保持这些步骤的配置。

## 取消和证件回退

如果用户取消、请求过期或验证失败，Didit 将应用该国家/地区的 `wallet.on_failure` 设置。
`fallback_to_document` 会在芬兰启用证件验证时启动证件采集。
`decline` 则会拒绝该身份证件验证步骤。
已禁用的证件验证方式不能作为回退选项。
若要先引导用户使用 Finnish Trust Network，并在失败后才显示证件采集，请将 `document.fallback_only` 设置为 `true`。
请参阅[仅在回退时提供证件采集](https://docs.didit.me/zh/core-technology/id-verification/verification-methods.md#仅将证件采集作为回退选项)。

重定向或显示的银行选择器并不代表身份验证成功。
在授予访问权限之前，请等待已验证的会话结果或 Webhook。
请使用与集成其余部分相同的幂等性处理来应对重复的 Webhook 投递。

## 测试和上线

在启用了该钱包的环境中对其进行测试。
测试应涵盖成功返回、用户取消、过期、不完整身份以及证件回退。
还要测试您的用户所依赖的设备和浏览器环境。
沙盒环境中的模拟结果并不能证明真实的银行认证或生产环境激活正常工作。

FTN 的公布基础费率为**每次完成验证 \$0.25**。
已取消、已过期和失败的钱包尝试不会产生完成钱包验证的费用。
完成的证件回退验证将根据证件验证定价单独计费。
有关最新的计费规则，请参阅[钱包定价](https://docs.didit.me/zh/core-technology/id-verification/digital-id-wallets.md#定价)。

## 相关指南

* [数字身份钱包覆盖范围和定价](https://docs.didit.me/zh/core-technology/id-verification/digital-id-wallets.md)
* [Smart-ID 和 Mobile-ID 集成](https://docs.didit.me/zh/core-technology/id-verification/smart-id-mobile-id.md)
* [身份证件验证方法](https://docs.didit.me/zh/core-technology/id-verification/verification-methods.md)
* [Webhook 集成](https://docs.didit.me/zh/integration/webhooks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.