Проверка по базам данных - активация сервисов и что оплачивается

Проверка по базам данных сверяет извлечённые данные личности с государственным или уполномоченным реестром. Почему сервис показывает "Требуется онбординг", почему он возвращает 403 или вообще ничего, и какие запросы оплачиваются.

Short answer

Проверка по базам данных выполняется в фоновом режиме по официальному реестру: пользователь её никогда не видит. Она активируется только после первого пополнения вашей организации, некоторые сервисы дополнительно показывают "Требуется онбординг", пока Didit не включит их для вас, и каждый запрос, на который реестр действительно ответил, оплачивается, включая несовпадение.

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

#Выполняется незаметно, после шага с документом

Экрана проверки по базам данных не существует. Шаг берёт данные, извлечённые из документа (или переданные при создании сессии), отправляет их в реестр и сохраняет ответ в отчёте сессии. Из этого следуют два вывода:

  • Если шаг проверки документа извлёк неверный номер или имя, реестр запрашивается с неверным значением, и проверка проваливается или возвращает неопределённый результат. Сначала исправьте извлечение. См. исправление неверно прочитанного имени или поля.
  • Вы не можете "отправить на повторную подачу" проверку по базам данных так, как документ или селфи, потому что пользователю нечего переделывать. Запрос повторной подачи DATABASE_VALIDATION возвращает ошибку о том, что эта функция не входит в шаги сессии, доступные для повторной подачи. Чтобы выполнить её снова, вызовите автономный API проверки по базам данных с исправленными данными. Этот вызов оплачивается за запрос, как и любой другой.

#Почему она не выполняется

Проверяйте по порядку. Это объясняет почти все обращения вида "проверка по базам данных ничего не сделала".

  1. Ваша организация хоть раз пополняла баланс?

    Проверка по базам данных (и проверка телефона) активируется только после первого пополнения. Приветственные кредиты, включая 10 $ для новых аккаунтов, не учитываются. До этого шаг пропускается, сессия может вернуться одобренной, хотя проверка незаметно не выполнялась, а прямой вызов POST /v3/database-validation/ отвечает 403. См. пополнения, счета и способы оплаты.

  2. Сервис помечен как Требуется онбординг?

    В шаге проверки по базам данных рабочего процесса некоторые сервисы показывают "Требуется онбординг. Обратитесь в поддержку Didit, чтобы включить эту функцию." Сервис виден, но отключён для вашей организации, пока Didit его не активирует. Это не ошибка, и переключателя самообслуживания нет: откройте тикет в поддержку с указанием сервиса и страны, и команда запустит онбординг.

  3. Страна вообще настроена?

    Вызов API для страны, которую вы никогда не выбирали в рабочем процессе, или автономный вызов сервиса, который вы не включили, отвечает "No database validation services configured" для этой страны. Добавьте сервис в шаг или передайте точный service_id со страницы страны.

  4. Баланс положительный?

    Проверка по базам данных никогда не входит в бесплатный тариф. Нулевой или отрицательный баланс возвращает insufficient_credits, как и любая платная функция. См. исправление ошибки "недостаточно кредитов".

#Сервисы, требующие онбординга у провайдера

Несколько государственных источников требуют, чтобы Didit зарегистрировал вашу организацию у провайдера, а не просто щёлкнул переключателем. Сегодня это касается:

  • Австралии (DVS: водительское удостоверение, паспорт, виза, Medicare и остальные сервисы DVS)
  • Новой Зеландии (DIA: паспорт, гражданство, записи о рождении и смерти, водительское удостоверение)
  • Канады (кредитные бюро и сервисы сверки в духе FINTRAC)

Для них поддержка присылает вам формы провайдера, провайдер выпускает учётные данные для вашего аккаунта, и активация обычно занимает до двух недель. Австралия и Новая Зеландия исторически также требовали минимального соглашения об обслуживании (единовременная предоплата, сейчас 5 000 USD, которая зачисляется на ваш баланс в виде кредитов без срока действия). Это требование касается только доступа к реестрам этих двух стран, а не других функций Didit, и оно пересматривается по мере того, как Didit завершает собственную аккредитацию в австралийской схеме, поэтому уточните актуальные условия у поддержки, прежде чем строить на них планы.

Note

Некоторые сервисы также требуют явного согласия конечного пользователя перед отправкой запроса (например, проверка паспорта DIA Новой Зеландии). Шаг рабочего процесса помечает такие сервисы, и согласие нужно собрать в вашем процессе до того, как проверка сможет выполниться.

#Что оплачивается

Вы платите за сервис, за каждый запрос, на который реестр ответил, по цене на странице этого сервиса. Понимайте это как "реестр спросили, и он ответил", а не "ответ был тот, которого вы ждали":

РезультатОплачивается?
Совпадение, частичное совпадение, несовпадениеДа
Неопределённый результат, непригодное биометрическое изображениеДа
Неверный формат документа, неверные входные данные (отклонено реестром)Да
REGISTRY_UNAVAILABLE, REGISTRY_ERROR (реестр так и не ответил)Нет
Запрос отклонён до попадания в реестр (400 в автономном API или шаг рабочего процесса пропущен из-за отсутствующих или неверно оформленных полей)Нет

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

Important

Пустой результат - это не несовпадение. Если сервис вообще ничего не вернул вместо результата NO_MATCH, обычные причины - правило первого пополнения, сервис в ожидании онбординга или сбой реестра; их стоит исключить, прежде чем отлаживать интеграцию. См. ошибки API и что они означают.

#Что возвращается

Каждый сервис возвращает стандартный код результата плюс собственные данные реестра там, где источник это позволяет: какие поля совпали, оценку совпадения, если реестр оценивает, а не отвечает да или нет, а для биометрических сервисов (RENAPER Аргентины, BVN Нигерии, Панама) сравнение лица с портретом из реестра. Что Didit сохраняет из этого ответа, определяют настройки Возвращаемые данные шага. См. выбор данных, которые возвращает проверка и отчёт проверки по базам данных.

#Тестирование перед запуском

Приложения-песочницы никогда не обращаются к реальному реестру и не тратят кредиты: сценарий песочницы вроде decline_database_no_match принудительно задаёт результат, который вы хотите отрепетировать. Чего песочница не покажет - подключён ли конкретный сервис для вашей боевой организации; для этого нужны первое пополнение и реальный вызов. См. тестирование в песочнице.