API для проверки DNI/NIE в Испании (RU)

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

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

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

Что проверяет верификация DNI/NIE в Испании

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

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

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

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

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

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

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

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

POST /v3/database-validation/

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

Параметр	Тип	Обязательный	Описание
issuing_state	string	Да	Трехбуквенный код страны по ISO 3166-1 alpha-3. Используйте ESP.
services	string	Да	Идентификатор сервиса. Используйте esp_dni.
personal_number	string	Да	Личный номер.
document_type	string	Да	Тип документа.
expiration_date	string	Да	Дата истечения срока действия.
first_name	string	Нет	Имя (необязательная перекрестная проверка).
last_name	string	Нет	Фамилия (необязательная перекрестная проверка).

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

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ESP" \
  -F "services=esp_dni" \
  -F "personal_number=1111111" \
  -F "document_type=sample_value" \
  -F "expiration_date=1990-01-01"

Пример ответа (полное совпадение)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "ESP",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "esp_dni",
      "service_name": "Spain - DNI/NIE verification",
      "source_data": {
        "document_type": "sample_value",
        "expiration_date": "1990-01-01",
        "first_name": "John",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Производительность и тарификация

• Задержка: обычно пару секунд.
• Стоимость: $0.20 за подтвержденный запрос. Вы оплачиваете только подтвержденные результаты — плата не взимается за простой источника, отсутствующие поля или отклонения до проверки источника.
• Надежность: работает на инфраструктуре Didit с целевым показателем безотказной работы 99,9% в квартал.

Варианты использования

• Финтех и необанки — подтвердите реального, проверяемого владельца счета перед открытием кошелька или предоставлением кредита в Испании.
• Крипто и Web3 — соблюдайте требования VASP по регистрации с подтверждением личности из авторитетного источника.
• Кредитование — уменьшите мошенничество с синтетическими личностями и мошенничество от первого лица с помощью данных, проверенных источником.
• Торговые площадки и платформы для фрилансеров — проверяйте пользователей по авторитетным данным, а не только по самостоятельно заполненной форме.
• iGaming — удовлетворяйте проверки личности и права для игроков из Испании с помощью проверяемого следа.

Как интегрироваться с Didit

Вы можете использовать проверку DNI/NIE в Испании двумя способами:

1. Рабочий процесс без кода. В Didit Business Console откройте Workflow Builder, добавьте модуль Database Validation, выберите Spain → Spain DNI/NIE Verification и активируйте его. Совпадающие пользователи маршрутизируются автоматически — инженерия не требуется.
2. Прямой API. Вызовите конечную точку /v3/database-validation/, показанную выше, с services=esp_dni. Прочитайте match_type и блок validation для каждого поля, чтобы управлять своей логикой одобрения / рассмотрения / отклонения.

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

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

Что подтверждает проверка DNI/NIE в Испании?

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

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

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

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

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

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

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

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

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

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