API de Vérification du Statut CPF au Brésil (FR-1)

L'intégration d'utilisateurs au Brésil implique de confirmer leur identité. Le statut CPF (régulier, suspendu, annulé), le nom et la date de naissance sont renvoyés par la Receita Federal via SERPRO. Un document ou une information saisie prouve seulement que les données existent — pas qu'elles sont authentiques ou appartiennent à la personne devant vous. La vérification du statut CPF au Brésil comble cette lacune en comparant les données avec l'autorité fiscale nationale. Ce guide explique le fonctionnement de cette vérification, les détails techniques exacts et comment l'intégrer en quelques minutes.

Points clés à retenir :

• Ce qu'elle vérifie — La vérification du statut CPF au 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 du champ 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 flux de travail sans code. 0,20 $ par requête concluante, résultats en quelques secondes.

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

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 par rapport à l'autorité fiscale nationale et recevoir un résultat structuré et normalisé — et non un dump de registre brut que vous devriez analyser vous-même.

Une réponse concluante renvoie le source_data correspondant et un bloc de validation par champ, de sorte 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, places de marché 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 du service. Utilisez bra_cpf.
tax_number	string	Oui	Numéro fiscal.
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"
      }
    }
  ]
}

Performance 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 les temps d'arrêt 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 — répondez aux exigences d'intégration VASP avec une preuve d'identité provenant d'une source faisant autorité.
• Prêts — réduisez la fraude d'identité synthétique et de première partie avec des données vérifiées à la source.
• Places de marché et plateformes de services — vérifiez les utilisateurs par rapport à des données fiables, et non seulement un formulaire auto-déclaré.
• iGaming — satisfaites aux vérifications d'identité et d'éligibilité pour les joueurs brésiliens avec une piste d'audit.

Comment intégrer Didit

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

1. Flux de travail sans code. Dans la console Didit Business, ouvrez le Workflow Builder, ajoutez le module Database Validation, sélectionnez Brazil → Brazil CPF status check Verification, 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/ indiqué ci-dessus avec services=bra_cpf. Lisez match_type et le bloc de 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 au Brésil ?

Elle valide les données soumises par rapport à 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 correspondent.

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 — les temps d'arrêt 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 la base de données renvoie généralement les résultats 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 dans un flux de travail sans code dans la console Business.

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 au Brésil
• Voir toutes les validations de base de données : Tarification et couverture des validations de base de données
• Commencez à construire : Créez un compte Didit gratuit — 500 vérifications par mois, gratuites.