API de verificació de l'estat del CPF al Brasil (CA)

Incorporar usuaris al Brasil significa confirmar que són qui diuen ser. Retorna l'estat del CPF (regular, suspès, cancel·lat), nom i data de naixement de la Receita Federal via SERPRO. Un document o una dada introduïda només demostra que la dada existeix, no que sigui genuïna o que pertanyi a la persona que teniu al davant. La verificació de l'estat del CPF al Brasil tanca aquesta bretxa comprovant les dades amb l'autoritat fiscal nacional. Aquesta guia explica què fa la verificació, els detalls tècnics exactes i com integrar-la en minuts.

Punts clau:

• Què verifica — La verificació de l'estat del CPF al Brasil valida la identificació fiscal amb l'autoritat fiscal nacional.
• Què s'obté — un match_type normalitzat més resultats a nivell de camp que podeu dirigir directament a la lògica d'aprovació / revisió / rebuig.
• Per què és important — La validació d'identificació fiscal vincula un sol·licitant a una identitat fiscal verificable, reduint el frau d'identitat sintètica i de primera part.
• Com utilitzar-lo — una POST a l'endpoint de validació de base de dades de Didit, o un mòdul de flux de treball sense codi. 0,20 $ per consulta concloent, resultats en segons.

Què valida la verificació de l'estat del CPF al Brasil

Retorna l'estat del CPF (regular, suspès, cancel·lat), nom i data de naixement de la Receita Federal via SERPRO. Didit ho exposa a través d'un únic endpoint perquè pugueu verificar les dades enviades amb l'autoritat fiscal nacional i rebre un resultat estructurat i normalitzat, no un bolcat de registre en brut que hagueu de processar vosaltres mateixos.

Una resposta concloent retorna les source_data coincidents i un bloc de validation per camp, de manera que el vostre motor de risc obté un veredicte clar i llegible per màquina.

Per què és important

La validació d'identificació fiscal vincula un sol·licitant a una identitat fiscal verificable, reduint el frau d'identitat sintètica i de primera part.

Per a empreses regulades al Brasil — fintechs, plataformes de criptomonedes, prestadors, mercats i operadors de jocs — la comprovació amb una font autoritzada produeix un registre defensable i auditable que la identitat va ser confirmada a la font, no només capturada d'un formulari o una foto.

Detalls tècnics

Didit exposa aquest servei a través de l'endpoint unificat de validació de base de dades. És un únic POST, sense necessitat d'SDK.

Endpoint

POST /v3/database-validation/

Paràmetres de la sol·licitud

Paràmetre	Tipus	Obligatori	Descripció
issuing_state	string	Sí	Codi de país ISO 3166-1 alfa-3. Utilitzeu BRA.
services	string	Sí	Identificador de servei. Utilitzeu bra_cpf.
tax_number	string	Sí	Número d'identificació fiscal.
first_name	string	No	Nom (comprovació creuada opcional).
last_name	string	No	Cognom (comprovació creuada opcional).
date_of_birth	string	No	Data de naixement (comprovació creuada opcional).

Exemple de sol·licitud

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 resposta (coincidència concloent)

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

Rendiment i facturació

• Latència: normalment un parell de segons.
• Cost: 0,20 $ per consulta concloent. Se us factura només pels resultats concloents; no hi ha càrrec per temps d'inactivitat de la font, camps que falten o rebuigs previs a la font.
• Fiabilitat: funciona amb la infraestructura de Didit amb un objectiu de temps d'activitat trimestral del 99,9%.

Casos d'ús

• Fintechs i neobancs — confirmeu un titular de compte real i verificable abans d'obrir una cartera o estendre crèdit al Brasil.
• Cripto i Web3 — compliu els requisits d'incorporació de VASP amb una prova d'identitat de font autoritzada.
• Préstecs — reduïu el frau d'identitat sintètica i de primera part amb dades verificades per la font.
• Mercats i plataformes de serveis — verifiqueu els usuaris amb dades autoritzades, no només un formulari autoinformat.
• iGaming — satisféu les comprovacions d'identitat i elegibilitat per als jugadors del Brasil amb un registre auditable.

Com integrar-se amb Didit

Podeu executar la verificació de l'estat del CPF al Brasil de dues maneres:

1. Flux de treball sense codi. A la Consola de Negocis de Didit, obriu el Creador de Fluxos de Treball, afegiu el mòdul Validació de Base de Dades, seleccioneu Brasil → Verificació de l'estat del CPF al Brasil i activeu-lo. Els usuaris coincidents es dirigeixen automàticament, sense necessitat d'enginyeria.
2. API directa. Truqueu a l'endpoint /v3/database-validation/ mostrat anteriorment amb services=bra_cpf. Llegiu match_type i el bloc de validation per camp per impulsar la vostra lògica d'aprovació / revisió / rebuig.

Cada compte de Didit inclou 500 verificacions gratuïtes al mes, de manera que podeu provar tot el flux de principi a fi abans de pagar per una sola consulta.

Preguntes freqüents

Què confirma la verificació de l'estat del CPF al Brasil?

Valida les dades enviades amb l'autoritat fiscal nacional i retorna un resultat de coincidència normalitzat, de manera que sabeu si la identificació fiscal existeix a la font autoritzada i quins camps han coincidit.

Què passa si la font no està disponible temporalment?

No se us cobrarà. La facturació només s'aplica als resultats concloents: el temps d'inactivitat de la font, els camps que falten i els rebuigs previs a la font són gratuïts.

Quina rapidesa té la comprovació?

La validació de la base de dades normalment es retorna en un parell de segons, de manera que s'adapta a un flux d'incorporació en temps real.

Necessito un SDK?

No. La comprovació és una única POST HTTPS a un endpoint. També podeu connectar-la a un flux de treball sense codi a la Consola de Negocis.

Llestos per començar?

Valideu la vostra primera identificació fiscal brasilera avui mateix.

• Llegiu la referència de l'API: Verificació de l'estat del CPF al Brasil
• Vegeu totes les validacions de base de dades: Preus i cobertura de la validació de base de dades
• Comenceu a construir: Creeu un compte Didit gratuït — 500 verificacions al mes, gratuïtes.