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

Покрытие

  • Покрытие: ~ 100%
  • Страна: Бразилия
  • ID сервиса: bra_cpf
  • Домен данных: Личность
  • Категория: Налоговый реестр

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

  • Обязательные входные данные: tax_number, date_of_birth
  • Необязательные входные данные: first_name, last_name, vendor_data
  • Согласие: Не требуется
  • Доступность в сценарии: Доступно в сценарии
  • Покрытие: ~ 100%
  • Цена: $0.20 за успешный запрос
Не каждый документ, который принимает этот сервис, содержит идентификатор, по которому выполняется запрос. Если идентификатор не извлечён из документа, проверка фиксируется как не применимо: база данных не запрашивается, и с вас не взимается плата. В некоторых странах это составляет значительную долю реальных пользователей. Чтобы охватить их, также собирайте идентификатор из ответа в анкете, поля извлечения Document AI или значения, которое вы передаёте при создании сессии, и сопоставляйте его на шаге Проверка по базам данных.

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

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

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

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

Как выполнить запрос

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

Точный набор полей в source_data зависит от того, что возвращает реестр. Сгенерированный пример для bra_cpf сейчас описывает такую нормализованную структуру:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • lgpd_minor
  • minor_under_16
  • minor_under_18
  • registration_date

Цены и SLA

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

Читайте далее

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