Перейти к основному содержанию
POST
Проверяет входные данные по базе данных банковской отрасли Нигерии. Требуется селфи: портрет, зарегистрированный в системе BVN, сверяется с ним по лицу, и запись возвращается только в том случае, если это один и тот же человек. Didit предоставляет этот сервис через POST /v3/database-validation/, чтобы вы могли сверить отправленные данные с авторитетным источником и получить нормализованные результаты сопоставления. Формат ввода: bvn принимает номер банковской верификации Нигерии (ровно 11 цифр).

Покрытие

  • Покрытие: ~ 100%
  • Страна: Нигерия
  • ID сервиса: nga_bank_verification_number
  • Домен данных: финансовые данные
  • Категория: банковские услуги

Входные данные

  • Обязательные входные данные: bvn, selfie
  • Необязательные входные данные: first_name, last_name, date_of_birth, vendor_data
  • Согласие: не требуется
  • Доступность в сценарии: доступно в сценарии с сопоставлением полей
  • Покрытие: ~ 100%
  • Цена: $0.35 за успешный запрос
В сценарии bvn не указывается в удостоверении личности, поэтому ни один шаг не получает его самостоятельно. Соберите его из ответа на анкету, поля, извлечённого через Document AI, или значения, которое вы передаёте при создании сессии, и сопоставьте его на шаге «Проверка по базам данных». Пока поле не сопоставлено, редактор сценариев показывает, что этот сервис отключён, и называет недостающий входной параметр. Во время выполнения отсутствие входного параметра означает, что проверка пропускается до любого запроса, поэтому с вас никогда не берут плату за базу данных, которую не удалось запросить.

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

string
по умолчанию:"NGA"
обязательно
Код страны по ISO 3166-1 alpha-3 для этого сервиса базы данных.Пример: NGA
string
по умолчанию:"nga_bank_verification_number"
обязательно
Массив, содержащий ID этого сервиса. Указание сервиса ограничивает запрос этой конкретной базой данных.Пример: nga_bank_verification_number
string
по умолчанию:"11111111111"
обязательно
Номер банковской верификации (BVN).Пример: 11111111111
file
обязательно
Файл изображения селфи для загрузки при биометрической проверке по базе данных. Принимаемые форматы: JPEG, PNG или WebP.Пример: @./selfie.jpg
string
Имя для проверки.Пример: John
string
Фамилия для проверки.Пример: Doe
string
по умолчанию:"1990-01-01"
Дата рождения в формате YYYY-MM-DD.Пример: 1990-01-01
string
по умолчанию:"user-1234"
Ваш постоянный идентификатор пользователя, например внутренний ID пользователя. Didit использует его, чтобы связать отдельные проверки с одним и тем же конечным пользователем и уменьшить количество ложных срабатываний при поиске дубликатов.Пример: user-1234

Правила ввода и примечания по валидации

  • Номер банковской верификации Нигерии (ровно 11 цифр)
  • bvn должен содержать только цифры; удалите пробелы, дефисы и знаки препинания перед отправкой запроса.
  • Длина bvn должна быть ровно 11 символов.

Как выполнить вызов

Возвращаемые данные

Точный набор полей, возвращаемых в source_data, зависит от того, что возвращает реестр. Сгенерированный пример для nga_bank_verification_number сейчас описывает такую нормализованную структуру:
  • date_of_birth
  • first_name
  • last_name

Цены и SLA

Запросы номера банковской верификации (BVN) Нигерии тарифицируются только тогда, когда Didit получает окончательный результат от источника проверки.
  • Цена за вызов: $0.35 USD.
  • Тарификация: за каждый успешный запрос. Плата не взимается, если реестр недоступен, если не хватает обязательных полей или если запрос отклонён до того, как он дошёл до источника.
  • Задержка: типичный p95 < 2 с.
  • Доступность: 99.9% за квартал со стороны Didit; доступность источника данных зависит от страны и набора данных.

Читайте также

Последнее изменение 7 ноября 2026 г.