Какие данные собирает Didit
Поддерживаемые типы документов охватывают полную матрицу «страна × документ» (14,000+ документов в 220+ странах).
Получение документов
Документы связаны с сессией, в рамках которой они были собраны, а не напрямую с пользователем. Чтобы получить все документы пользователя:1
Получите список сессий пользователя
2
Получите решение по каждой сессии
Решение по каждой сессии содержит URL-адреса собранных документов.Проверьте поля
id_verification.document_images, proof_of_address.document_images и liveness.images в ответе.3
Используйте подписанные URL
URL изображений в ответе являются короткоживущими подписанными URL. Кэшируйте их на стороне клиента на время использования или повторно запрашивайте решение после истечения срока их действия.
Создание PDF-отчёта
Чтобы получить удобочитаемый экспорт всех данных, собранных для сессии, включая все документы, используйте:GET /v3/session/{session_id}/generate-pdf/
Возвращает PDF с деталями сессии, результатами функций и встроенными изображениями документов. Полезно для аудитов комплаенса, приложений к SAR и регуляторной отчётности.
Загрузка документов из консоли
Сотрудники комплаенса могут загружать дополнительные документы для пользователя или активной сессии:- Перейдите в раздел Users → [user] → Documents → Upload document.
- Выберите тип документа (ID, POA, настраиваемый).
- Загрузите файл; для поддерживаемых типов OCR запускается автоматически.
- Документ прикрепляется к последней сессии (или вы можете создать сессию для устранения проблемы).
Загрузка документов доступна только в консоли: публичного API endpoint для прикрепления документов напрямую к пользователю нет. Используйте сессии как точку входа для всех способов сбора документов.
Перекрёстная сверка документов
Когда сессия собирает несколько типов документов, Didit выполняет их перекрёстную сверку:- ID ↔ Liveness: лицо на документе совпадает с селфи из проверки живости.
- ID ↔ POA: имя в POA совпадает с именем, извлечённым из удостоверения личности.
- ID ↔ NFC: MRZ или визуальные данные совпадают с данными чипа NFC.
Мониторинг документов и повторная верификация
Для сценариев, требующих постоянного контроля действительности документов (например, истёкших удостоверений):- Срок действия документа отслеживается для каждого верифицированного удостоверения личности. Запросите поле
expiration_dateв решении по сессии. - Мониторинг документов включён по умолчанию и работает автоматически: ничего включать не нужно. Когда срок действия удостоверения истекает, сессия со статусом
"Approved"переходит в"Kyc Expired", в результат верификации личности добавляется предупреждениеDOCUMENT_EXPIRED, и срабатывает webhookstatus.updated. До наступления даты предупреждение не отправляется. - Отключение — установите Expiration mode в значение Allow expired для нужной страны и типа документа в настройках верификации личности. Reject expired, режим по умолчанию, является тем режимом, при котором выполняется мониторинг. Документ, принятый в режиме Allow expired, никогда не отслеживается.
- Повторная верификация — создайте новую сессию с тем же
vendor_data, чтобы обновить документы.
Геолокация документа
Проверка геолокации ID-документа сравнивает местоположение IP-адреса отправителя со страной выдачи удостоверения. Результаты прикрепляются к решению по сессии.Конфиденциальность и хранение
- Все документы шифруются при хранении.
- Доступ к изображениям осуществляется через короткоживущие подписанные URL.
- Хранение регулируется политикой хранения данных приложения.
- Пользователи имеют право запросить удаление; при удалении удаляются изображения, данные OCR и данные NFC.
Следующие шаги
Верификация личности
Как выполняются захват удостоверения личности и OCR.
Подтверждение адреса
Сбор документов POA.
Решение по сессии
Справочник по GET /v3/session//decision/.