芬兰国民身份证验证API (ZH)

在芬兰招募用户意味着要确认他们就是他们声称的那个人。此服务会根据芬兰身份证的官方签发机构验证输入数据。文件或输入的信息只能证明数据存在，而不能证明其真实性或属于您面前的人。芬兰国民身份证验证通过将数据与该国官方政府身份登记处进行核对，弥补了这一空白。本指南解释了此检查的功能、具体技术细节以及如何在几分钟内完成集成。

主要内容：

• 检查内容 — 芬兰国民身份证验证会根据该国官方政府身份登记处核实国民身份证。
• 返回结果 — 标准化的 match_type 以及字段级别的结果，您可以直接将其路由到批准/审查/拒绝逻辑中。
• 重要性 — 文件可能被伪造；而登记记录不能。对照权威政府来源验证身份证，可确认持证人真实且身份正确。
• 使用方法 — 向 Didit 的数据库验证端点发送一个 POST 请求，或使用无代码工作流模块。每次有效查询2.10美元，几秒内出结果。

芬兰国民身份证验证内容

根据芬兰身份证的官方签发机构验证输入数据。Didit 通过单个端点公开此服务，因此您可以根据该国官方政府身份登记处验证提交的数据，并接收结构化、标准化的结果——而不是您需要自行解析的原始注册表转储。

确切的响应会返回匹配的 source_data 和每个字段的 validation 块，因此您的风险引擎会收到清晰、机器可读的判决。

重要性

文件可能被伪造；而登记记录不能。对照权威政府来源验证身份证，可确认持证人真实且身份正确。

对于芬兰受监管的企业——金融科技公司、加密平台、贷款机构、市场平台和游戏运营商——对照权威来源进行检查可生成一份可辩护、可审计的记录，证明身份已在源头得到确认，而不仅仅是从表格或照片中获取。

技术细节

Didit 通过统一的数据库验证端点公开此服务。它是一个简单的 POST 请求——无需 SDK。

端点

POST /v3/database-validation/

请求参数

参数	类型	必填	描述
issuing_state	string	是	ISO 3166-1 alpha-3 国家代码。使用 FIN。
services	string	是	服务标识符。使用 fin_national_id。
first_name	string	是	名字。
last_name	string	是	姓氏。
date_of_birth	string	是	出生日期。
national_id	string	是	国民身份证号。
address	string	否	地址（可选交叉核对）。

示例请求

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=FIN" \
  -F "services=fin_national_id" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "national_id=1111111"

示例响应（确切匹配）

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "FIN",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "fin_national_id",
      "service_name": "Finland National ID",
      "source_data": {
        "address": "123 Sample Street",
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

性能和计费

• 延迟：通常几秒钟。
• 费用：每次有效查询2.10美元。您只对有效结果收费——源系统停机、字段缺失或源系统预拒绝不收费。
• 可靠性：运行在 Didit 基础设施上，季度正常运行时间目标为99.9%。

用例

• 金融科技和数字银行 — 在芬兰开立钱包或提供信贷前，确认真实的、可验证的账户持有人。
• 加密和 Web3 — 通过权威来源的身份证明，满足 VASP 入职要求。
• 贷款 — 通过源验证数据，减少合成身份和第一方欺诈。
• 市场和零工平台 — 根据权威数据验证用户，而不仅仅是自报表格。
• iGaming — 通过可审计的记录，满足芬兰玩家的身份和资格检查。

如何与 Didit 集成

您可以通过两种方式运行芬兰国民身份证验证：

1. 无代码工作流。在 Didit 业务控制台中，打开工作流构建器，添加数据库验证模块，选择芬兰 → 芬兰国民身份证验证，然后激活。匹配的用户会自动路由——无需工程开发。
2. 直接 API。调用上面所示的 /v3/database-validation/ 端点，并附带 services=fin_national_id。读取 match_type 和每个字段的 validation 块，以驱动您的批准/审查/拒绝逻辑。

每个 Didit 账户每月包含 500 次免费验证，因此您可以在支付任何查询费用之前，端到端地测试整个流程。

常见问题

芬兰国民身份证验证检查确认什么？

它根据该国官方政府身份登记处验证提交的数据，并返回标准化的匹配结果，因此您可以了解国民身份证是否在权威来源存在以及哪些字段匹配。

如果源系统暂时不可用怎么办？

您无需付费。计费仅适用于有效结果——源系统停机、字段缺失和源系统预拒绝是免费的。

检查速度有多快？

数据库验证通常在几秒钟内返回，因此它适用于实时入职流程。

我需要 SDK 吗？

不需要。该检查是对一个端点的单个 HTTPS POST 请求。您也可以将其连接到业务控制台中的无代码工作流。

准备好开始了吗？

立即验证您的第一个芬兰国民身份证。

• 阅读 API 参考： 芬兰国民身份证验证
• 查看所有数据库验证： 数据库验证定价和覆盖范围
• 开始构建： 创建一个免费的 Didit 账户 — 每月免费 500 次验证。