- Стандартный код исхода, который работает одинаково во всех поддерживаемых странах, позволяя написать единую логику обработки для них всех.
- Необязательный код детализации конкретной страны, который сообщает точное состояние, возвращённое государственным реестром — полезно для поддержки, аналитики и решения о том, предложить ли пользователю повторить попытку.
Стандартные коды исхода
Эти коды идентичны для всех стран. Выстраивайте логику ручной проверки, отклонения и повторных попыток на их основе — а не на детальных кодах отдельных стран.Поле
outcome_code находится внутри каждого элемента массива validations в отчёте о валидации. См. Отчёт о проверке по базам данных, чтобы узнать его расположение в ответе.REGISTRY_UNAVAILABLE и REGISTRY_ERROR означают, что исходный реестр так и не ответил на запрос, поэтому эти два исхода не тарифицируются - см. цены. Любой другой код исхода является реальным, платным ответом от реестра, даже если он ничего не подтверждает (INCONCLUSIVE, BIOMETRIC_IMAGE_UNUSABLE) или отклоняет переданные данные (INVALID_DOCUMENT_FORMAT, INVALID_INPUT — в качестве кодов исхода они означают, что сам реестр отклонил данные уже после отправки запроса).Входные данные, которые не доходят до реестра, не генерируют код исхода вовсе: POST /v3/database-validation/ возвращает 400, если значение не соответствует правилам формата страны, а сервис в сценарии с отсутствующими или некорректными полями пропускается с ошибкой COULD_NOT_PERFORM_DATABASE_VALIDATION. Ни один из этих случаев не тарифицируется. Полный разбор представлен на странице с ценами на Проверку по базам данных.Детализированные коды по странам
Детализированный код возвращается в полеoutcome_detail вместе с outcome_code. Только перечисленные ниже страны генерируют детализированные коды помимо стандартного результата — все остальные поддерживаемые страны возвращают только стандартные коды.
Аргентина (RENAPER)
Аргентина использует биометрическую валидацию 1×1 по национальному реестру удостоверений личности RENAPER, сопоставляя DNI, селфи и указанный пол.Бразилия (Receita Federal — Consulta CPF)
Бразилия выполняет проверку CPF через официальный сервис CPF ведомства Receita Federal с явной обработкой данных несовершеннолетних согласно LGPD (Lei Geral de Proteção de Dados) и Цифровому уставу детей и подростков.Для результатов
MINOR_BLOCKED в Бразилии объект source_data по-прежнему возвращает флаги lgpd_minor, minor_under_18 и minor_under_16, что позволяет применять сценарии, соответствующие возрасту, без повторных попыток.Панама (SIB — Tribunal Electoral)
Панама использует биометрическую валидацию по реестру SIB (Servicio de Identificación Biométrica), управляемому Tribunal Electoral. При возникновении технической ошибки SIB сессия автоматически переключается на поиск 1×1.Другие поддерживаемые страны
Перечисленные ниже страны возвращают только стандартные коды результатов — детализированные коды по странам для них отсутствуют.- Боливия, Венесуэла, Гватемала, Гондурас, Колумбия, Коста-Рика, Парагвай, Сальвадор, Испания, Уругвай — поиск 1×1 по соответствующему реестру актов гражданского состояния. Результаты напрямую сопоставляются с
MATCH,NO_MATCH,DOCUMENT_NOT_FOUND,INVALID_DOCUMENT_FORMATилиREGISTRY_UNAVAILABLE. - Чили (Registro Civil) — поиск по RUT. Сопоставляется со стандартными результатами, а также с
MINOR_BLOCKED, когда реестр помечает запись как принадлежащую несовершеннолетнему. - Доминиканская Республика (JCE) — поиск по cédula, возвращающий логическое значение действительности; сопоставляется с
MATCHилиNO_MATCH. - Эквадор (Registro Civil) — поиск по cédula.
- Мексика (RENAPO, а также INE для 2×2) — поиск CURP через RENAPO. Если
validation_typeимеет значениеtwo_by_two, выполняется дополнительная перекрёстная сверка с INE; результаты обоих методов преобразуются в одни и те же стандартные коды результатов. - Перу (RENIEC) — поиск по DNI.
Пример обработки
Простейший надёжный обработчик выглядит следующим образом:Вам не нужно ветвить бизнес-логику на основе
outcome_detail — используйте его для аналитики, отладки и тикетов в службу поддержки. Стандартный outcome_code гарантированно остаётся стабильным между странами и во времени.См. также
- Предупреждения проверки по базам данных — теги предупреждений на уровне сессии (
COULD_NOT_PERFORM_DATABASE_VALIDATION,DATABASE_VALIDATION_PARTIAL_MATCH,DATABASE_VALIDATION_NO_MATCH) и настройка действий проверки или отклонения в приложении. - Отчёт о проверке по базам данных — полная структура ответа и расположение полей
outcome_code/outcome_detail. - Поддерживаемые страны для проверки по базам данных — полный список стран и методов сопоставления.