Lists API: черные и белые списки Didit

Lists API позволяет управлять типизированными списками для вашего приложения. Системные списки блокировки создаются автоматически и проверяются при верификации и скрининге транзакций. Вы также можете создавать белые списки и пользовательские списки для условий сценария.

Основные понятия

Тип	Описание
Список блокировки	Создается системой, по одному на каждый тип записи. Элементы списка блокировки приводят к автоматическому отклонению при верификации или скрининге транзакций.
Белый список	Создается пользователем. Используется в условиях сценария и для подавления действий при дубликатах и повторном использовании для доверенных совпадающих элементов.
Пользовательский список	Создается пользователем. Гибкие списки для ветвления сценария, правил мониторинга или ручной проверки.

Типы записей

Тип записи	Проверяется при	При совпадении
`face`	Проверке живости	Сессия отклонена
`document`	Верификации личности (OCR)	Сессия отклонена
`phone`	Проверке телефона	Сессия отклонена
`email`	Проверке электронной почты	Сессия отклонена
`ip_address`	Анализе устройства и IP (поддерживает диапазоны CIDR)	Сессия отклонена
`device_fingerprint`	Анализе устройства и IP	Сессия отклонена
`wallet_address`	Скрининге транзакций	Транзакция отклонена
`bank_account`	СкрININГе транзакций	Транзакция отклонена
`user`	Скрининге транзакций	Пользователь заблокирован
`business`	Скрининге транзакций	Компания заблокирована
`country`	Условиях сценария	Настраивается
`key`	Пользовательском использовании	Настраивается

Белые списки

Белые списки не отменяют списки блокировки и проверки подлинности. Они только подавляют действия при дубликатах и повторном использовании для того же типа записи. Например, лицо из белого списка лиц может пропустить действие DUPLICATED_FACE, IP-адрес из белого списка IP может пропустить действие DUPLICATED_IP_ADDRESS, а отпечаток устройства из белого списка устройств может пропустить действие DUPLICATED_DEVICE_FINGERPRINT. Didit всё равно фиксирует информационное предупреждение о белом списке, чтобы вы могли проверить, почему действие для дубликата не выполнилось.

Системные списки блокировки

Каждое приложение автоматически получает 10 системных списков блокировки (по одному на каждый поддерживаемый тип записи) и системный список High Risk Countries. Их нельзя удалить или переименовать. Записи в них можно добавлять через API или из консоли.

Трассировка

Каждую запись списка блокировки можно связать с исходным объектом, чтобы перейти от списка к исходной записи:

Из сессии: передайте reference_session_id при создании записи. Didit автоматически извлекает значение (лицо, документ, телефон, email, IP или устройство), помечает связанную модель как занесённую в список блокировки и связывает запись с сессией. Didit использует самую последнюю запись этого типа в сессии. Чтобы внести значение из более ранней записи, добавьте его по value без reference_session_id.
Из транзакции, пользователя или компании: передайте reference_object_uuid с UUID объекта и укажите metadata.reference_type ("transaction", "vendor_user" или "vendor_business"), чтобы консоль могла связать запись с исходной записью.

Endpoints

Получить все списки

Получение всех списков приложения.

Записи списка

Получение записей списка.

Создать запись

Добавление значения в список блокировки: по значению, ссылке на сессию или ссылке на транзакцию.

Удалить запись

Удаление записи и разблокировка связанной сущности.

Загрузить лицо

Загрузка изображения лица напрямую в список блокировки лиц.

​Основные понятия

​Типы записей

​Белые списки

​Системные списки блокировки

​Трассировка

​Endpoints