Verifizierung der CPF-Statusprüfung in Brasilien über API (DE)

Die Onboarding von Nutzern in Brasilien bedeutet, zu bestätigen, dass sie die Person sind, die sie vorgeben zu sein. Es werden der CPF-Status (regulär, suspendiert, annulliert), Name und Geburtsdatum von Receita Federal über SERPRO zurückgegeben. Ein Dokument oder eine eingegebene Angabe beweist nur, dass die Daten existieren – nicht, dass sie echt sind oder zur vorliegenden Person gehören. Die brasilianische CPF-Statusprüfung schließt diese Lücke, indem die Daten mit der nationalen Steuerbehörde abgeglichen werden. Dieser Leitfaden erklärt, was die Prüfung leistet, die genauen technischen Details und wie Sie sie in wenigen Minuten integrieren können.

Wichtige Erkenntnisse:

• Was geprüft wird — Die brasilianische CPF-Statusprüfung validiert die Steueridentifikation gegen die nationale Steuerbehörde.
• Was Sie zurückerhalten — einen normalisierten match_type plus feldspezifische Ergebnisse, die Sie direkt in Ihre Genehmigungs-/Überprüfungs-/Ablehnungslogik leiten können.
• Warum es wichtig ist — Die Steuer-ID-Validierung verknüpft einen Antragsteller mit einer überprüfbaren fiskalischen Identität, wodurch synthetische Identitäten und Betrug durch Erstparteien reduziert werden.
• Wie man es verwendet — ein POST an Didits Datenbankvalidierungs-Endpunkt oder ein No-Code-Workflow-Modul. 0,20 $ pro schlüssiger Abfrage, Ergebnisse in Sekunden.

Was die brasilianische CPF-Statusprüfung validiert

Gibt den CPF-Status (regulär, suspendiert, annulliert), Name und Geburtsdatum von Receita Federal über SERPRO zurück. Didit stellt dies über einen einzigen Endpunkt bereit, sodass Sie die übermittelten Daten mit der nationalen Steuerbehörde überprüfen und ein strukturiertes, normalisiertes Ergebnis erhalten können – kein rohes Register-Dump, das Sie selbst parsen müssen.

Eine schlüssige Antwort liefert die übereinstimmenden source_data und einen feldspezifischen validation-Block, sodass Ihre Risiko-Engine ein klares, maschinenlesbares Urteil erhält.

Warum es wichtig ist

Die Steuer-ID-Validierung verknüpft einen Antragsteller mit einer überprüfbaren fiskalischen Identität, wodurch synthetische Identitäten und Betrug durch Erstparteien reduziert werden.

Für regulierte Unternehmen in Brasilien – Fintechs, Kryptoplattformen, Kreditgeber, Marktplätze und Glücksspielanbieter – erzeugt die Überprüfung anhand einer autoritativen Quelle einen verteidigungsfähigen, prüfbaren Nachweis, dass die Identität an der Quelle bestätigt wurde und nicht nur aus einem Formular oder einem Foto erfasst wurde.

Technische Details

Didit stellt diesen Dienst über den einheitlichen Datenbankvalidierungs-Endpunkt bereit. Es ist ein einzelner POST – kein SDK erforderlich.

Endpunkt

POST /v3/database-validation/

Anforderungsparameter

Parameter	Typ	Erforderlich	Beschreibung
issuing_state	string	Ja	ISO 3166-1 alpha-3 Ländercode. Verwenden Sie BRA.
services	string	Ja	Dienst-ID. Verwenden Sie bra_cpf.
tax_number	string	Ja	Steuernummer.
first_name	string	Nein	Vorname (optionale Gegenprüfung).
last_name	string	Nein	Nachname (optionale Gegenprüfung).
date_of_birth	string	Nein	Geburtsdatum (optionale Gegenprüfung).

Beispielanfrage

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"

Beispielantwort (schlüssiger Treffer)

{
  "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"
      }
    }
  ]
}

Leistung und Abrechnung

• Latenz: typischerweise ein paar Sekunden.
• Kosten: 0,20 $ pro schlüssiger Abfrage. Ihnen werden nur schlüssige Ergebnisse in Rechnung gestellt – keine Gebühren für Ausfallzeiten der Quelle, fehlende Felder oder Ablehnungen vor der Quelle.
• Zuverlässigkeit: läuft auf Didits Infrastruktur mit einem vierteljährlichen Uptime-Ziel von 99,9 %.

Anwendungsfälle

• Fintech & Neobanken — Bestätigen Sie einen echten, überprüfbaren Kontoinhaber, bevor Sie eine Wallet eröffnen oder in Brasilien Kredit gewähren.
• Krypto & Web3 — Erfüllen Sie die VASP-Onboarding-Anforderungen mit einem Identitätsnachweis aus einer autoritativen Quelle.
• Kreditvergabe — Reduzieren Sie synthetische Identitäten und Betrug durch Erstparteien mit quellverifizierten Daten.
• Marktplätze & Gig-Plattformen — Überprüfen Sie Benutzer anhand autoritativer Daten, nicht nur anhand eines selbst gemeldeten Formulars.
• iGaming — Erfüllen Sie Identitäts- und Berechtigungsprüfungen für brasilianische Spieler mit einem prüfbaren Nachweis.

Wie man Didit integriert

Sie können die brasilianische CPF-Statusprüfung auf zwei Arten durchführen:

1. No-Code-Workflow. Öffnen Sie in der Didit Business Console den Workflow Builder, fügen Sie das Modul Datenbankvalidierung hinzu, wählen Sie Brasilien → Brasilianische CPF-Statusprüfung aus und aktivieren Sie es. Übereinstimmende Benutzer werden automatisch weitergeleitet – kein Engineering erforderlich.
2. Direkte API. Rufen Sie den oben gezeigten Endpunkt /v3/database-validation/ mit services=bra_cpf auf. Lesen Sie match_type und den feldspezifischen validation-Block, um Ihre Genehmigungs-/Überprüfungs-/Ablehnungslogik zu steuern.

Jedes Didit-Konto beinhaltet 500 kostenlose Verifizierungen pro Monat, sodass Sie den gesamten Ablauf von Anfang bis Ende testen können, bevor Sie für eine einzige Abfrage bezahlen.

Häufig gestellte Fragen

Was bestätigt die brasilianische CPF-Statusprüfung?

Sie validiert die übermittelten Daten gegen die nationale Steuerbehörde und gibt ein normalisiertes Übereinstimmungsergebnis zurück, sodass Sie erfahren, ob die Steueridentifikation an der autoritativen Quelle existiert und welche Felder übereinstimmten.

Was passiert, wenn die Quelle vorübergehend nicht verfügbar ist?

Ihnen werden keine Kosten berechnet. Die Abrechnung erfolgt nur für schlüssige Ergebnisse – Ausfallzeiten der Quelle, fehlende Felder und Ablehnungen vor der Quelle sind kostenlos.

Wie schnell ist die Prüfung?

Die Datenbankvalidierung wird typischerweise in wenigen Sekunden zurückgegeben, sodass sie in einen Echtzeit-Onboarding-Flow passt.

Benötige ich ein SDK?

Nein. Die Prüfung ist ein einzelnes HTTPS POST an einen Endpunkt. Sie können es auch in einen No-Code-Workflow in der Business Console integrieren.

Bereit zum Start?

Validieren Sie noch heute Ihre erste brasilianische Steueridentifikation.

• Lesen Sie die API-Referenz: Brasilien CPF-Statusprüfung
• Alle Datenbankvalidierungen anzeigen: Preise und Abdeckung der Datenbankvalidierung
• Beginnen Sie mit der Entwicklung: Erstellen Sie ein kostenloses Didit-Konto – 500 Verifizierungen pro Monat, kostenlos.