API для проверки статуса CPF в Бразилии (RU)

Привлечение пользователей в Бразилии означает подтверждение их личности. Возвращает статус CPF (действительный, приостановлен, аннулирован), имя и дату рождения из Receita Federal через SERPRO. Документ или введенные данные доказывают лишь то, что данные существуют, но не то, что они подлинные или принадлежат человеку перед вами. Проверка статуса CPF в Бразилии устраняет этот пробел, сверяя данные с национальной налоговой службой. Это руководство объясняет, что делает проверка, точные технические детали и как интегрировать ее за считанные минуты.

Основные выводы:

• Что проверяется — Проверка статуса CPF в Бразилии подтверждает налоговый идентификатор в национальной налоговой службе.
• Что вы получаете в ответ — нормализованный match_type плюс результаты на уровне полей, которые можно сразу направить в логику одобрения / рассмотрения / отклонения.
• Почему это важно — Проверка налогового идентификатора связывает заявителя с поддающейся проверке фискальной личностью, уменьшая количество случаев мошенничества с синтетическими и первичными данными.
• Как это использовать — один POST к конечной точке проверки базы данных Didit или модуль рабочего процесса без кода. $0.20 за каждый окончательный запрос, результаты за секунды.

Что проверяет статус CPF в Бразилии

Возвращает статус CPF (действительный, приостановлен, аннулирован), имя и дату рождения из Receita Federal через SERPRO. Didit предоставляет это через единую конечную точку, чтобы вы могли проверить предоставленные данные в национальной налоговой службе и получить структурированный, нормализованный результат — а не необработанный дамп реестра, который вам придется анализировать самостоятельно.

Окончательный ответ возвращает соответствующий source_data и блок validation для каждого поля, так что ваш механизм рисков получает четкий, машиночитаемый вердикт.

Почему это важно

Проверка налогового идентификатора связывает заявителя с поддающейся проверке фискальной личностью, уменьшая количество случаев мошенничества с синтетическими и первичными данными.

Для регулируемых предприятий в Бразилии — финтех-компаний, криптоплатформ, кредиторов, торговых площадок и игровых операторов — проверка по авторитетному источнику создает обоснованную, поддающуюся аудиту запись о том, что личность была подтверждена на источнике, а не просто получена из формы или фотографии.

Технические детали

Didit предоставляет эту услугу через унифицированную конечную точку проверки базы данных. Это один запрос POST — SDK не требуется.

Конечная точка

POST /v3/database-validation/

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

Параметр	Тип	Обязательный	Описание
issuing_state	string	Да	Трехбуквенный код страны по ISO 3166-1 alpha-3. Используйте BRA.
services	string	Да	Идентификатор услуги. Используйте bra_cpf.
tax_number	string	Да	Налоговый номер.
first_name	string	Нет	Имя (необязательная перекрестная проверка).
last_name	string	Нет	Фамилия (необязательная перекрестная проверка).
date_of_birth	string	Нет	Дата рождения (необязательная перекрестная проверка).

Пример запроса

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=BRA" \
  -F "services=bra_cpf" \
  -F "tax_number=1111111"

Пример ответа (полное совпадение)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "bra_cpf",
      "service_name": "Brazil - CPF status check",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "lgpd_minor": "sample_value",
        "minor_under_16": "sample_value",
        "minor_under_18": "sample_value"
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Производительность и выставление счетов

• Задержка: обычно несколько секунд.
• Стоимость: $0.20 за каждый окончательный запрос. Вы платите только за окончательные результаты — за простои источника, отсутствующие поля или отклонения до проверки источника плата не взимается.
• Надежность: работает на инфраструктуре Didit с целевым показателем безотказной работы 99.9% в квартал.

Сценарии использования

• Финтех и необанки — подтвердите реального, поддающегося проверке владельца счета до открытия кошелька или предоставления кредита в Бразилии.
• Крипто и Web3 — соблюдайте требования VASP по регистрации с помощью авторитетного подтверждения личности.
• Кредитование — уменьшите количество случаев мошенничества с синтетическими и первичными данными с помощью данных, проверенных источником.
• Торговые площадки и платформы для фрилансеров — проверяйте пользователей по авторитетным данным, а не только по самостоятельно заполненной форме.
• iGaming — удовлетворяйте проверки личности и права на участие для бразильских игроков с помощью аудируемого следа.

Как интегрироваться с Didit

Вы можете выполнить проверку статуса CPF в Бразилии двумя способами:

1. Рабочий процесс без кода. В Didit Business Console откройте Workflow Builder, добавьте модуль Database Validation, выберите Brazil → Brazil CPF status check Verification и активируйте его. Соответствующие пользователи автоматически маршрутизируются — инженерные работы не требуются.
2. Прямой API. Вызовите конечную точку /v3/database-validation/, показанную выше, с services=bra_cpf. Прочитайте match_type и блок validation для каждого поля, чтобы управлять логикой одобрения / рассмотрения / отклонения.

Каждый аккаунт Didit включает 500 бесплатных проверок в месяц, так что вы можете полностью протестировать весь процесс, прежде чем платить за один запрос.

Часто задаваемые вопросы

Что подтверждает проверка статуса CPF в Бразилии?

Она проверяет предоставленные данные в национальной налоговой службе и возвращает нормализованный результат совпадения, так что вы узнаете, существует ли налоговый идентификатор в авторитетном источнике и какие поля совпали.

Что произойдет, если источник временно недоступен?

С вас не взимается плата. Плата взимается только за окончательные результаты — простои источника, отсутствующие поля и отклонения до проверки источника бесплатны.

Насколько быстро выполняется проверка?

Проверка базы данных обычно возвращается за несколько секунд, поэтому она вписывается в процесс регистрации в реальном времени.

Нужен ли мне SDK?

Нет. Проверка представляет собой один HTTPS POST к одной конечной точке. Вы также можете встроить ее в рабочий процесс без кода в Business Console.

Готовы начать?

Проверьте свой первый налоговый идентификатор в Бразилии уже сегодня.

• Прочитайте справочник API: Проверка статуса CPF в Бразилии
• Посмотрите все проверки баз данных: Цены и покрытие проверки баз данных
• Начните создавать: Создайте бесплатный аккаунт Didit — 500 проверок в месяц бесплатно.