Проверка по базам данных - активация сервисов и что оплачивается
Проверка по базам данных сверяет извлечённые данные личности с государственным или уполномоченным реестром. Почему сервис показывает "Требуется онбординг", почему он возвращает 403 или вообще ничего, и какие запросы оплачиваются.
Проверка по базам данных выполняется в фоновом режиме по официальному реестру: пользователь её никогда не видит. Она активируется только после первого пополнения вашей организации, некоторые сервисы дополнительно показывают "Требуется онбординг", пока Didit не включит их для вас, и каждый запрос, на который реестр действительно ответил, оплачивается, включая несовпадение.
Чтение документа говорит, что на нём напечатано. Проверка по базам данных говорит, согласен ли с этим уполномоченный источник: реестр актов гражданского состояния, налоговый орган, кредитное бюро, база водительских удостоверений. Каждая страна предоставляет один или несколько сервисов, у каждого своя цена, свои входные данные и правила согласия. См. поддерживаемые страны и сервисы и цены по сервисам.
#Выполняется незаметно, после шага с документом
Экрана проверки по базам данных не существует. Шаг берёт данные, извлечённые из документа (или переданные при создании сессии), отправляет их в реестр и сохраняет ответ в отчёте сессии. Из этого следуют два вывода:
- Если шаг проверки документа извлёк неверный номер или имя, реестр запрашивается с неверным значением, и проверка проваливается или возвращает неопределённый результат. Сначала исправьте извлечение. См. исправление неверно прочитанного имени или поля.
- Вы не можете "отправить на повторную подачу" проверку по базам данных так, как документ или селфи, потому что пользователю нечего переделывать. Запрос повторной подачи
DATABASE_VALIDATIONвозвращает ошибку о том, что эта функция не входит в шаги сессии, доступные для повторной подачи. Чтобы выполнить её снова, вызовите автономный API проверки по базам данных с исправленными данными. Этот вызов оплачивается за запрос, как и любой другой.
#Почему она не выполняется
Проверяйте по порядку. Это объясняет почти все обращения вида "проверка по базам данных ничего не сделала".
- Ваша организация хоть раз пополняла баланс?
Проверка по базам данных (и проверка телефона) активируется только после первого пополнения. Приветственные кредиты, включая 10 $ для новых аккаунтов, не учитываются. До этого шаг пропускается, сессия может вернуться одобренной, хотя проверка незаметно не выполнялась, а прямой вызов
POST /v3/database-validation/отвечает 403. См. пополнения, счета и способы оплаты. - Сервис помечен как Требуется онбординг?
В шаге проверки по базам данных рабочего процесса некоторые сервисы показывают "Требуется онбординг. Обратитесь в поддержку Didit, чтобы включить эту функцию." Сервис виден, но отключён для вашей организации, пока Didit его не активирует. Это не ошибка, и переключателя самообслуживания нет: откройте тикет в поддержку с указанием сервиса и страны, и команда запустит онбординг.
- Страна вообще настроена?
Вызов API для страны, которую вы никогда не выбирали в рабочем процессе, или автономный вызов сервиса, который вы не включили, отвечает "No database validation services configured" для этой страны. Добавьте сервис в шаг или передайте точный
service_idсо страницы страны. - Баланс положительный?
Проверка по базам данных никогда не входит в бесплатный тариф. Нулевой или отрицательный баланс возвращает
insufficient_credits, как и любая платная функция. См. исправление ошибки "недостаточно кредитов".
#Сервисы, требующие онбординга у провайдера
Несколько государственных источников требуют, чтобы Didit зарегистрировал вашу организацию у провайдера, а не просто щёлкнул переключателем. Сегодня это касается:
- Австралии (DVS: водительское удостоверение, паспорт, виза, Medicare и остальные сервисы DVS)
- Новой Зеландии (DIA: паспорт, гражданство, записи о рождении и смерти, водительское удостоверение)
- Канады (кредитные бюро и сервисы сверки в духе FINTRAC)
Для них поддержка присылает вам формы провайдера, провайдер выпускает учётные данные для вашего аккаунта, и активация обычно занимает до двух недель. Австралия и Новая Зеландия исторически также требовали минимального соглашения об обслуживании (единовременная предоплата, сейчас 5 000 USD, которая зачисляется на ваш баланс в виде кредитов без срока действия). Это требование касается только доступа к реестрам этих двух стран, а не других функций Didit, и оно пересматривается по мере того, как Didit завершает собственную аккредитацию в австралийской схеме, поэтому уточните актуальные условия у поддержки, прежде чем строить на них планы.
Некоторые сервисы также требуют явного согласия конечного пользователя перед отправкой запроса (например, проверка паспорта DIA Новой Зеландии). Шаг рабочего процесса помечает такие сервисы, и согласие нужно собрать в вашем процессе до того, как проверка сможет выполниться.
#Что оплачивается
Вы платите за сервис, за каждый запрос, на который реестр ответил, по цене на странице этого сервиса. Понимайте это как "реестр спросили, и он ответил", а не "ответ был тот, которого вы ждали":
| Результат | Оплачивается? |
|---|---|
| Совпадение, частичное совпадение, несовпадение | Да |
| Неопределённый результат, непригодное биометрическое изображение | Да |
| Неверный формат документа, неверные входные данные (отклонено реестром) | Да |
REGISTRY_UNAVAILABLE, REGISTRY_ERROR (реестр так и не ответил) | Нет |
| Запрос отклонён до попадания в реестр (400 в автономном API или шаг рабочего процесса пропущен из-за отсутствующих или неверно оформленных полей) | Нет |
Одна сессия может вызвать несколько оплачиваемых запросов, если выполняет несколько сервисов, и запрос оплачивается один раз за сервис, а не за страну. Полная раскладка: цены на проверку по базам данных и коды результатов.
Пустой результат - это не несовпадение. Если сервис вообще ничего не вернул вместо
результата NO_MATCH, обычные причины - правило первого пополнения, сервис в ожидании
онбординга или сбой реестра; их стоит исключить, прежде чем отлаживать интеграцию. См.
ошибки API и что они означают.
#Что возвращается
Каждый сервис возвращает стандартный код результата плюс собственные данные реестра там, где источник это позволяет: какие поля совпали, оценку совпадения, если реестр оценивает, а не отвечает да или нет, а для биометрических сервисов (RENAPER Аргентины, BVN Нигерии, Панама) сравнение лица с портретом из реестра. Что Didit сохраняет из этого ответа, определяют настройки Возвращаемые данные шага. См. выбор данных, которые возвращает проверка и отчёт проверки по базам данных.
#Тестирование перед запуском
Приложения-песочницы никогда не обращаются к реальному реестру и не тратят кредиты: сценарий песочницы вроде decline_database_no_match принудительно задаёт результат, который вы хотите отрепетировать. Чего песочница не покажет - подключён ли конкретный сервис для вашей боевой организации; для этого нужны первое пополнение и реальный вызов. См. тестирование в песочнице.