Перейти к основному содержанию
POST
Биометрическая проверка Unico IDCloud: сравнивает селфи пользователя с лицом, зарегистрированным по его CPF, и возвращает результат: тот же это человек, другой человек или результат неопределённый. Didit предоставляет эту услугу через POST /v3/database-validation/, чтобы вы могли сверить отправленные данные с авторитетным источником и получить нормализованные результаты сравнения. Формат ввода: tax_number принимает бразильский CPF (ровно 11 цифр).

Охват

  • Охват: 96%
  • Страна: Бразилия
  • ID сервиса: bra_unico_idcloud
  • Домен данных: Личность
  • Категория: BiometricRiskScore
Около 96% владельцев CPF в Бразилии имеют биометрическую запись в реестре Unico. Это примерно вдвое больше охвата государственного источника сравнения лиц Datavalid, у которого около 50%.

Входные данные

  • Обязательные входные данные: tax_number, selfie
  • Необязательные входные данные: first_name, last_name, full_name, date_of_birth, vendor_data
  • Согласие: обязательно
  • Доступность в сценарии: доступно в сценарии
  • Охват: 96%
  • Цена: $0.20 за успешный запрос

Параметры тела запроса

string
по умолчанию:"BRA"
обязательно
Код страны ISO 3166-1 alpha-3 для этой базы данных.Пример: BRA
string
по умолчанию:"bra_unico_idcloud"
обязательно
Массив, содержащий ID этого сервиса. Фиксация сервиса ограничивает запрос именно этой базой данных.Пример: bra_unico_idcloud
Явное согласие конечного пользователя на использование этого сервиса.Пример: true
string
по умолчанию:"11111111111"
обязательно
Налоговый или фискальный идентификационный номер.Пример: 11111111111
file
обязательно
Файл изображения селфи для биометрической проверки по базе данных. Допустимые форматы: JPEG, PNG или WebP.Пример: @./selfie.jpg
string
Имя для проверки.Пример: John
string
Фамилия для проверки.Пример: Doe
string
Полное юридическое имя для проверки.Пример: John Doe
string
Дата рождения в формате YYYY-MM-DD.Пример: 1990-01-01
string
по умолчанию:"user-1234"
Ваш стабильный идентификатор этого пользователя, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и уменьшать количество ложных срабатываний при поиске дубликатов.Пример: user-1234

Правила ввода и примечания по валидации

  • Бразильский CPF (ровно 11 цифр)
  • tax_number должен содержать только цифры; перед отправкой запроса удалите пробелы, дефисы и знаки пунктуации.
  • Длина tax_number должна быть ровно 11 символов.

Как вызвать

Возвращаемые данные

Точный набор полей в source_data зависит от того, что возвращает реестр. Сгенерированный пример для bra_unico_idcloud сейчас описывает такую нормализованную структуру:
  • unico_face_match

Цены и SLA

Запросы BRA - Unico IDCloud (CPF + селфи) тарифицируются только тогда, когда Didit получает окончательный результат от источника проверки.
  • Цена за вызов: $0.20 USD.
  • Тарификация: за успешный запрос. Плата не взимается, если реестр недоступен, если не заполнены обязательные поля или если запрос отклонён до обращения к источнику.
  • Задержка: типичный p95 < 2 с.
  • Доступность: 99.9% за квартал со стороны Didit; доступность внешних источников зависит от страны и набора данных.

Об источнике

Unico — бразильская IDtech-компания, которая ведёт крупнейший в стране частный реестр биометрических данных лица. Её платформа IDCloud хранит более миллиарда эмбеддингов лиц и ежемесячно добавляет около 35 миллионов новых лиц. Данные поступают из процессов онбординга и повторной аутентификации более чем 800 бразильских компаний, включая четыре из пяти крупнейших банков страны. Именно этот масштаб обеспечивает показатель покрытия, указанный выше: поиск по CPF находит биометрическую запись примерно для 96% взрослых граждан Бразилии. Didit имеет прямое партнёрство с Unico, поэтому вы можете обращаться к IDCloud через стандартный API проверки по базам данных. Оплата производится за каждый вызов. Отдельный договор с Unico, минимальный объём запросов и процесс онбординга не требуются. Чем это отличается от государственного реестра. Didit также предлагает Brazil - CPF + face match (Datavalid). Это официальный источник SERPRO, и он подходит, если вам конкретно нужен государственный реестр в качестве источника достоверных данных. IDCloud является более сильным выбором во всех остальных случаях, и это можно проверить по двум показателям. Во-первых, он охватывает около 96% взрослых против примерно 50% у Datavalid. Во-вторых, он сверяет лицо с биометрической записью, которую хранит и поддерживает сам реестр, а не с портретом, снятым с документа, который предоставляет пользователь. Поэтому он устойчив как к подделке документов, так и к мошенничеству с украденным CPF. Кроме того, цена одного запроса меньше половины цены Datavalid.

Рекомендуемый сценарий для Бразилии

Для большинства сценариев в Бразилии захват документа не нужен. Пользователь передаёт CPF, а селфи с проверкой живости подтверждает, что это действительно он.
1

Соберите CPF

Единственный текстовый ввод: 11-значный CPF. Фото документа, имя и дата рождения вводиться вручную не нужны.Поскольку в этом сценарии документ не считывается, Didit не знает, откуда взять CPF, пока вы это не укажете. Передайте его в metadata сессии при её создании и сопоставьте с входом tax_number шага «Проверка по базам данных». В Business Console это делается в сопоставлении входов шага, а через API сценариев в database_validation_field_sources узла:
Затем создавайте каждую сессию со значением под этим ключом:
Без сопоставления шаг всё равно выполняется, но сообщает, что tax_number отсутствует, и никогда не обращается к реестру. Плата не взимается, а причина указывается в записи database_validations сессии.
2

Сделайте селфи с проверкой живости

Добавьте шаг проверки живости в тот же сценарий и выберите метод, соответствующий вашему уровню риска: Пассивная проверка живости (пользователь ничего не делает), 3D Flash или 3D-действие и Flash (активные методы, которые проецируют световые узоры; последний дополнительно добавляет случайное действие). Задайте его через face_liveness_method (PASSIVE, FLASHING или ACTIVE_3D) в Business Console или через API сценариев. Каким бы методом вы ни пользовались, Didit показывает шаг захвата и подтверждает, что перед камерой реальный человек. Именно это исключает отправку сохранённого фото или повтора с экрана.
3

Проверьте CPF и селфи через Unico IDCloud

В сценарии сессии Didit автоматически использует селфи проверки живости, и вы никогда не работаете с изображением. CPF он берёт из сопоставления выше. IDCloud подтверждает, принадлежит ли это лицо владельцу CPF. Шагу нужны только эти два входа. Если вы также передадите full_name или date_of_birth в metadata и сопоставите их, они будут переданы в Unico для перекрёстной проверки, но обязательными не являются.
Этот сценарий, основанный только на CPF, применяется к интеграциям через сессии и сценарии, где захват выполняет Didit и передаёт селфи проверки живости этому сервису. Если вы вызываете POST /v3/database-validation/ напрямую, selfie является обязательным файлом, и изображение передаёте вы сами. Об обоих режимах см. обзор «Проверки по базам данных».
Стоимость: около $0.30 за проверенного пользователя с Пассивной проверкой живости ($0.20 за запрос к IDCloud и $0.10 за проверку живости) или около $0.35 с активным методом, где проверка живости стоит $0.15. Это прайс-лист: скидка по вашему тарифу применяется к каждой позиции. См. цены. Запасной вариант для примерно 4% без покрытия. Когда IDCloud возвращает INCONCLUSIVE, реестр не смог сопоставить этот CPF с пригодной биометрической записью, обычно потому, что человека в нём нет. Считайте это «нет ответа», а не неудачной проверкой, и переходите к полной верификации личности: захват документа и сравнение лиц с портретом из документа. Так каждый пользователь остаётся верифицируемым, а за проверку документа вы платите только за небольшую оставшуюся часть. Обработка отказов. BIOMETRIC_NO_MATCH означает, что реестр явно указывает на несоответствие: лицо не принадлежит этому CPF. Воспринимайте это как сильный отрицательный результат, а не как повод предложить повтор. Отправка пользователя сразу на захват документа именно тот путь, которым воспользовался бы мошенник, ведь документ — артефакт, который контролирует он сам. Однако ложноотрицательные результаты случаются: изменилась внешность, устарело фото в реестре или захват был плохим. Поэтому направляйте такие случаи на ручную проверку, а не одобряйте автоматически и не завершайте сценарий без дальнейших вариантов для пользователя. BIOMETRIC_IMAGE_UNUSABLE относится к другой ситуации: селфи просто не удалось прочитать, попросите новое. Решите, как каждый результат влияет на сессию, с помощью действий при частичном совпадении и отсутствии совпадения, а полный список см. в кодах результатов. Повторные пользователи. Запрос к реестру нужно оплатить только один раз. После того как пользователь проходит этот сценарий, селфи проверки живости сохраняется в его vendor_data, и вы можете повторно верифицировать его позже с помощью биометрической аутентификации: проверка живости плюс сравнение лица с сохранённым изображением за $0.10, с тем же выбором методов проверки живости. Учтите, что это относится именно к повторно приходящим пользователям. Сессия биометрической аутентификации требует сохранённого лица (или portrait_image, который вы передаёте сами) и завершается ошибкой при создании, если у пользователя нет ни того, ни другого. Поэтому пользователи, которые приходят впервые, сначала проходят описанный выше сценарий.

Продолжить чтение

Последнее изменение 7 ноября 2026 г.