API для проверки национальных удостоверений личности Финляндии (RU)

При подключении пользователей в Финляндии необходимо подтвердить, что они являются теми, за кого себя выдают. Проверяет введенные данные по официальному органу, выдавшему финское удостоверение личности. Документ или введенные данные лишь подтверждают, что данные существуют — но не то, что они подлинны или принадлежат человеку перед вами. Проверка национального удостоверения личности Финляндии устраняет этот пробел, проверяя данные по официальному государственному реестру страны. В этом руководстве объясняется, что делает проверка, точные технические детали и как интегрировать ее за считанные минуты.

Основные выводы:

• Что проверяется — Проверка национального удостоверения личности Финляндии подтверждает национальное удостоверение личности по официальному государственному реестру страны.
• Что вы получаете — нормализованный match_type плюс результаты на уровне полей, которые вы можете напрямую направить в логику одобрения / рассмотрения / отклонения.
• Почему это важно — Документ может быть подделан; запись в реестре — нет. Проверка удостоверения личности по авторитетному государственному источнику подтверждает, что владелец реален и правильно идентифицирован.
• Как это использовать — один POST к конечной точке проверки базы данных Didit или модуль рабочего процесса без кода. 2,10 $ за убедительный запрос, результаты за секунды.

Что проверяет проверка национального удостоверения личности Финляндии

Проверяет введенные данные по официальному органу, выдавшему финское удостоверение личности. Didit предоставляет это через единую конечную точку, чтобы вы могли проверять отправленные данные по официальному государственному реестру страны и получать структурированный, нормализованный результат — а не необработанный дамп реестра, который вам придется анализировать самостоятельно.

Убедительный ответ возвращает сопоставленные source_data и блок validation для каждого поля, поэтому ваша система управления рисками получает четкое, машиночитаемое заключение.

Почему это важно

Документ может быть подделан; запись в реестре — нет. Проверка удостоверения личности по авторитетному государственному источнику подтверждает, что владелец реален и правильно идентифицирован.

Для регулируемых предприятий в Финляндии — финтех-компаний, криптоплатформ, кредиторов, торговых площадок и игровых операторов — проверка по авторитетному источнику создает обоснованную, проверяемую запись о том, что личность была подтверждена на источнике, а не просто получена из формы или фотографии.

Технические детали

Didit предоставляет эту услугу через унифицированную конечную точку проверки базы данных. Это один POST — SDK не требуется.

Конечная точка

POST /v3/database-validation/

Параметры запроса

Параметр	Тип	Обязательный	Описание
issuing_state	строка	Да	Код страны ISO 3166-1 alpha-3. Используйте FIN.
services	строка	Да	Идентификатор услуги. Используйте fin_national_id.
first_name	строка	Да	Имя.
last_name	строка	Да	Фамилия.
date_of_birth	строка	Да	Дата рождения.
national_id	строка	Да	Национальный идентификатор.
address	строка	Нет	Адрес (необязательная перекрестная проверка).

Пример запроса

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 Business откройте Workflow Builder, добавьте модуль Database Validation, выберите Finland → Finland National ID Verification и активируйте его. Соответствующие пользователи маршрутизируются автоматически — не требуется никаких инженерных работ.
2. Прямой API. Вызовите конечную точку /v3/database-validation/, показанную выше, с services=fin_national_id. Прочитайте match_type и блок validation для каждого поля, чтобы управлять логикой одобрения / рассмотрения / отклонения.

Каждая учетная запись Didit включает 500 бесплатных проверок в месяц, поэтому вы можете протестировать весь процесс от начала до конца, прежде чем платить за один запрос.

Часто задаваемые вопросы

Что подтверждает проверка национального удостоверения личности Финляндии?

Она проверяет отправленные данные по официальному государственному реестру страны и возвращает нормализованный результат совпадения, чтобы вы узнали, существует ли национальное удостоверение личности в авторитетном источнике и какие поля совпали.

Что произойдет, если источник временно недоступен?

С вас не взимается плата. Плата взимается только за убедительные результаты — простой источника, отсутствующие поля и отклонения до источника бесплатны.

Насколько быстра проверка?

Проверка базы данных обычно возвращает результат за пару секунд, поэтому она вписывается в процесс подключения в режиме реального времени.

Нужен ли мне SDK?

Нет. Проверка представляет собой один HTTPS POST к одной конечной точке. Вы также можете подключить ее к рабочему процессу без кода в Business Console.

Готовы начать?

Проверьте свое первое национальное удостоверение личности Финляндии сегодня.

• Прочитайте справочник по API: Проверка национального удостоверения личности Финляндии
• Посмотреть все проверки базы данных: Цены и покрытие проверки базы данных
• Начните строить: Создайте бесплатную учетную запись Didit — 500 проверок в месяц, бесплатно.