API для верификации национальных удостоверений личности ЮАР (DHA) (RU)

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

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

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

Что подтверждает проверка национальных удостоверений личности Южной Африки (DHA)

Проверяет входные данные по реестру Департамента внутренних дел (DHA) Южной Африки. Didit предоставляет доступ к нему через единую конечную точку, чтобы вы могли проверить представленные данные по официальному государственному реестру идентификационных данных страны и получить структурированный, нормализованный результат — а не необработанный дамп реестра, который вам придется анализировать самостоятельно.

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

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

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

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

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

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

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

POST /v3/database-validation/

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

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

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

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_africa_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": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_africa_national_id",
      "service_name": "South Africa National ID (DHA)",
      "source_data": {
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "marital_status": "sample_value"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

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

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

Сценарии использования

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

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

Вы можете выполнить проверку национальных удостоверений личности Южной Африки (DHA) двумя способами:

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

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

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

Что подтверждает проверка национальных удостоверений личности Южной Африки (DHA)?

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

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

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

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

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

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

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

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

Проверьте свое первое национальное удостоверение личности Южной Африки сегодня.

• Прочитайте справочник API: Проверка национальных удостоверений личности Южной Африки (DHA)
• Посмотрите все проверки баз данных: Цены и покрытие проверки баз данных
• Начните создавать: Создайте бесплатную учетную запись Didit — 500 проверок в месяц бесплатно.