Перейти к основному содержанию
POST
SERPRO Datavalid v4 pf-facial проверяет CPF (обязательно) по данным Receita Federal и сравнивает живое селфи (обязательно) с портретом из CNH, который хранится в Senatran. По желанию проверяет имя и дату рождения. Didit предоставляет этот сервис через POST /v3/database-validation/, чтобы вы могли сверить отправленные данные с авторитетным источником и получить нормализованные результаты сравнения. Формат ввода: tax_number принимает бразильский CPF (ровно 11 цифр).

Покрытие

  • Покрытие: ~50%
  • Страна: Бразилия
  • ID сервиса: bra_cpf_facial
  • Домен данных: Биометрический
  • Категория: NationalIDRegistry
Примерно 50% взрослых бразильцев: этап сравнения лиц опирается на портрет из CNH, который хранится в Senatran, поэтому сопоставить можно только держателей водительского удостоверения.

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

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

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

string
по умолчанию:"BRA"
обязательно
Код страны по ISO 3166-1 alpha-3 для этого сервиса баз данных.Пример: BRA
string
по умолчанию:"bra_cpf_facial"
обязательно
Массив, содержащий ID этого сервиса. Фиксация сервиса ограничивает запрос этой конкретной базой данных.Пример: bra_cpf_facial
Явное согласие конечного пользователя на использование этого сервиса.Пример: true
string
по умолчанию:"11111111111"
обязательно
Налоговый или фискальный идентификационный номер.Пример: 11111111111
file
обязательно
Файл изображения селфи для биометрической проверки по базам данных. Допустимые форматы: JPEG, PNG или WebP.Пример: @./selfie.jpg
string
Имя для проверки.Пример: John
string
Фамилия для проверки.Пример: 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_cpf_facial сейчас описывает такую нормализованную структуру:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • name_match_score

Цены и SLA

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

Об этом источнике

Это официальный государственный источник: SERPRO Datavalid, которым управляет федеральная служба обработки данных Бразилии. CPF проверяется по базе Receita Federal, а селфи сравнивается с портретом этого человека из Senatran, национального реестра водительских удостоверений. Поскольку портрет берется из записи CNH (водительского удостоверения), биометрическое изображение лица хранится в базе только для тех, кто имеет CNH. Именно поэтому охват составляет примерно 50% взрослого населения: данные являются достоверными, но отсутствуют для всех бразильцев, которые никогда не получали водительское удостоверение. Нужен более широкий охват? Используйте вместо этого BRA - Unico IDCloud (CPF + selfie). Он охватывает около 96% взрослых бразильцев через частный биометрический реестр Unico и стоит $0.20 против $0.45 здесь. Выбирайте Datavalid, когда вам нужен именно государственный реестр как источник достоверных данных, а IDCloud, когда нужно проверить всех.

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

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