API de vérification du statut CPF au Brésil

L'intégration d'utilisateurs au Brésil implique de confirmer qu'ils sont bien ceux qu'ils prétendent être. L'API renvoie le statut CPF (régulier, suspendu, annulé), le nom et la date de naissance de la Receita Federal via SERPRO. Un document ou une information saisie ne prouve que l'existence des données — pas qu'elles sont authentiques ou qu'elles appartiennent à la personne en face de vous. La vérification du statut CPF au Brésil comble cette lacune en vérifiant les données auprès de l'autorité fiscale nationale. Ce guide explique ce que fait la vérification, les détails techniques exacts et comment l'intégrer en quelques minutes.

Points clés :

• Ce qu'elle vérifie — La vérification du statut CPF Brésil valide l'identification fiscale auprès de l'autorité fiscale nationale.
• Ce que vous obtenez — un match_type normalisé ainsi que des résultats au niveau des champs que vous pouvez directement intégrer dans une logique d'approbation / révision / rejet.
• Pourquoi c'est important — La validation de l'identifiant fiscal lie un demandeur à une identité fiscale vérifiable, réduisant ainsi la fraude d'identité synthétique et de première partie.
• Comment l'utiliser — un POST vers le point de terminaison de validation de base de données de Didit, ou un module de workflow sans code. 0,20 $ par requête concluante, résultats en quelques secondes.

Ce que la vérification du statut CPF Brésil valide

Elle renvoie le statut CPF (régulier, suspendu, annulé), le nom et la date de naissance de la Receita Federal via SERPRO. Didit l'expose via un point de terminaison unique afin que vous puissiez vérifier les données soumises auprès de l'autorité fiscale nationale et recevoir un résultat structuré et normalisé — et non un dump brut du registre que vous devriez analyser vous-même.

Une réponse concluante renvoie le source_data correspondant et un bloc de validation par champ, afin que votre moteur de risque obtienne un verdict clair et lisible par machine.

Pourquoi c'est important

La validation de l'identifiant fiscal lie un demandeur à une identité fiscale vérifiable, réduisant ainsi la fraude d'identité synthétique et de première partie.

Pour les entreprises réglementées au Brésil — fintechs, plateformes de crypto, prêteurs, marketplaces et opérateurs de jeux — la vérification auprès d'une source faisant autorité produit un enregistrement défendable et auditable que l'identité a été confirmée à la source, et non simplement capturée à partir d'un formulaire ou d'une photo.

Détails techniques

Didit expose ce service via le point de terminaison unifié de validation de base de données. Il s'agit d'un simple POST — aucun SDK n'est requis.

Point de terminaison

POST /v3/database-validation/

Paramètres de requête

Paramètre	Type	Requis	Description
issuing_state	string	Oui	Code pays ISO 3166-1 alpha-3. Utilisez BRA.
services	string	Oui	Identifiant de service. Utilisez bra_cpf.
tax_number	string	Oui	Numéro d'identification fiscale.
first_name	string	Non	Prénom (vérification croisée facultative).
last_name	string	Non	Nom de famille (vérification croisée facultative).
date_of_birth	string	Non	Date de naissance (vérification croisée facultative).

Exemple de requête

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"

Exemple de réponse (correspondance concluante)

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

Performances et facturation

• Latence : généralement quelques secondes.
• Coût : 0,20 $ par requête concluante. Vous n'êtes facturé que sur les résultats concluants — pas de frais pour l'indisponibilité de la source, les champs manquants ou les rejets avant la source.
• Fiabilité : fonctionne sur l'infrastructure de Didit avec un objectif de disponibilité trimestriel de 99,9 %.

Cas d'utilisation

• Fintech et néobanques — confirmez un titulaire de compte réel et vérifiable avant d'ouvrir un portefeuille ou d'accorder un crédit au Brésil.
• Crypto et Web3 — respectez les exigences d'intégration VASP avec une preuve d'identité provenant d'une source faisant autorité.
• Prêt — réduisez la fraude d'identité synthétique et de première partie avec des données vérifiées à la source.
• Marketplaces et plateformes de services — vérifiez les utilisateurs par rapport aux données faisant autorité, et non seulement un formulaire auto-déclaré.
• iGaming — satisfaites aux contrôles d'identité et d'éligibilité pour les joueurs brésiliens avec une piste d'audit.

Comment intégrer Didit

Vous pouvez effectuer la vérification du statut CPF Brésil de deux manières :

1. Workflow sans code. Dans la Didit Business Console, ouvrez le Workflow Builder, ajoutez le module Validation de base de données, sélectionnez Brésil → Vérification du statut CPF Brésil, et activez-le. Les utilisateurs correspondants sont acheminés automatiquement — aucune ingénierie requise.
2. API directe. Appelez le point de terminaison /v3/database-validation/ montré ci-dessus avec services=bra_cpf. Lisez match_type et le bloc validation par champ pour piloter votre logique d'approbation / révision / rejet.

Chaque compte Didit comprend 500 vérifications gratuites par mois, vous pouvez donc tester le flux complet de bout en bout avant de payer pour une seule requête.

Foire aux questions

Que confirme la vérification du statut CPF Brésil ?

Elle valide les données soumises auprès de l'autorité fiscale nationale et renvoie un résultat de correspondance normalisé, vous permettant de savoir si l'identification fiscale existe à la source faisant autorité et quels champs ont correspondu.

Que se passe-t-il si la source est temporairement indisponible ?

Vous n'êtes pas facturé. La facturation s'applique uniquement aux résultats concluants — l'indisponibilité de la source, les champs manquants et les rejets avant la source sont gratuits.

Quelle est la rapidité de la vérification ?

La validation de base de données est généralement renvoyée en quelques secondes, elle s'intègre donc dans un flux d'intégration en temps réel.

Ai-je besoin d'un SDK ?

Non. La vérification est un simple POST HTTPS vers un seul point de terminaison. Vous pouvez également l'intégrer à un workflow sans code dans la Business Console.

Prêt à commencer ?

Validez votre première identification fiscale brésilienne dès aujourd'hui.

• Lisez la référence de l'API : Vérification du statut CPF Brésil
• Voir toutes les validations de base de données : Tarification et couverture de la validation de base de données
• Commencez à construire : Créez un compte Didit gratuit — 500 vérifications par mois, gratuites.