API de Verificación de Registro Fiscal Brasileño (CPF/CNPJ) (ES)

Incorporar usuarios en Brasil significa confirmar que son quienes dicen ser. Verifica contra la base de datos de CPF/CNPJ. Un documento o un detalle escrito solo prueba que los datos existen —no que sean genuinos o que pertenezcan a la persona que tienes delante. La Verificación de Registro Fiscal Brasileño (CPF/CNPJ) cierra esa brecha al verificar los datos con CPF/CNPJ. Esta guía explica qué hace la verificación, los detalles técnicos exactos y cómo integrarla en minutos.

Puntos clave:

• Qué verifica — La Verificación de Registro Fiscal Brasileño (CPF/CNPJ) valida la identificación fiscal contra CPF/CNPJ.
• Qué obtienes — un match_type normalizado más resultados a nivel de campo que puedes dirigir directamente a la lógica de aprobar / revisar / rechazar.
• Por qué importa — la validación del ID fiscal vincula a un solicitante a una identidad fiscal verificable, reduciendo el fraude de identidad sintética y de primera parte.
• Cómo usarlo — un POST al endpoint de validación de base de datos de Didit, o un módulo de flujo de trabajo sin código. $0.08 por consulta concluyente, resultados en segundos.

Qué valida la Verificación de Registro Fiscal Brasileño (CPF/CNPJ)

Verifica contra la base de datos de CPF/CNPJ. Didit la expone a través de un único endpoint para que puedas verificar los datos enviados con la autoridad fiscal nacional y recibir un resultado estructurado y normalizado —no un volcado de registro sin procesar que tengas que analizar tú mismo.

Una respuesta concluyente devuelve los source_data coincidentes y un bloque de validation por campo, para que tu motor de riesgo obtenga un veredicto claro y legible por máquina.

Por qué importa

La validación del ID fiscal vincula a un solicitante a una identidad fiscal verificable, reduciendo el fraude de identidad sintética y de primera parte.

Para las empresas reguladas en Brasil — fintech, plataformas de criptomonedas, prestamistas, mercados y operadores de juegos — la verificación con una fuente autorizada produce un registro defendible y auditable de que la identidad se confirmó en la fuente, no solo se capturó de un formulario o una foto.

Detalles técnicos

Didit expone este servicio a través del endpoint unificado de validación de base de datos. Es un único POST —no se requiere SDK.

Endpoint

POST /v3/database-validation/

Parámetros de solicitud

Parámetro	Tipo	Requerido	Descripción
issuing_state	string	Sí	Código de país alfa-3 ISO 3166-1. Utiliza BRA.
services	string	Sí	Identificador del servicio. Utiliza bra_tax_registration.
first_name	string	Sí	Nombre.
last_name	string	Sí	Apellido.
date_of_birth	string	Sí	Fecha de nacimiento.
tax_number	string	Sí	Número de identificación fiscal.

Ejemplo de solicitud

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=BRA" \
  -F "services=bra_tax_registration" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "tax_number=1111111"

Ejemplo de respuesta (coincidencia concluyente)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "bra_tax_registration",
      "service_name": "Brazil Tax Registration (CPF/CNPJ)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "identification_number": "SAMPLE-ID-12345",
        "name_match_score": "1.000",
        "verifications": {
          "date_of_birth": true,
          "identification_number": true
        }
      },
      "validation": {
        "date_of_birth": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Rendimiento y facturación

• Latencia: normalmente un par de segundos.
• Costo: $0.08 por consulta concluyente. Solo se te factura por los resultados concluyentes —no se cobra por la inactividad de la fuente, los campos faltantes o los rechazos previos a la fuente.
• Fiabilidad: se ejecuta en la infraestructura de Didit con un objetivo de tiempo de actividad trimestral del 99.9%.

Casos de uso

• Fintech y neobancos — confirma un titular de cuenta real y verificable antes de abrir una billetera o extender crédito en Brasil.
• Cripto y Web3 — cumple con los requisitos de incorporación de VASP con una prueba de identidad de fuente autorizada.
• Préstamos — reduce el fraude de identidad sintética y de primera parte con datos verificados en la fuente.
• Mercados y plataformas de trabajo ocasional — verifica a los usuarios con datos autorizados, no solo con un formulario autoinformado.
• iGaming — cumple con los controles de identidad y elegibilidad para jugadores de Brasil con un rastro auditable.

Cómo integrarse con Didit

Puedes ejecutar la Verificación de Registro Fiscal Brasileño (CPF/CNPJ) de dos maneras:

1. Flujo de trabajo sin código. En la Consola de negocios de Didit, abre el Constructor de flujos de trabajo, agrega el módulo Validación de base de datos, selecciona Brasil → Verificación de Registro Fiscal Brasileño (CPF/CNPJ) y actívalo. Los usuarios coincidentes se enrutan automáticamente —no se requiere ingeniería.
2. API directa. Llama al endpoint /v3/database-validation/ mostrado anteriormente con services=bra_tax_registration. Lee match_type y el bloque de validation por campo para impulsar tu lógica de aprobar / revisar / rechazar.

Cada cuenta de Didit incluye 500 verificaciones gratuitas por mes, para que puedas probar todo el flujo de principio a fin antes de pagar por una sola consulta.

Preguntas frecuentes

¿Qué confirma la Verificación de Registro Fiscal Brasileño (CPF/CNPJ)?

Valida los datos enviados con CPF/CNPJ y devuelve un resultado de coincidencia normalizado, para que sepas si la identificación fiscal existe en la fuente autorizada y qué campos coincidieron.

¿Qué sucede si la fuente está temporalmente no disponible?

No se te cobra. La facturación solo se aplica a los resultados concluyentes —el tiempo de inactividad de la fuente, los campos faltantes y los rechazos previos a la fuente son gratuitos.

¿Qué tan rápida es la verificación?

La validación de la base de datos normalmente se devuelve en un par de segundos, por lo que encaja en un flujo de incorporación en tiempo real.

¿Necesito un SDK?

No. La verificación es un único POST HTTPS a un endpoint. También puedes conectarlo a un flujo de trabajo sin código en la Consola de negocios.

¿Listo para empezar?

Valida tu primera identificación fiscal brasileña hoy mismo.

• Lee la referencia de la API: Verificación de Registro Fiscal Brasileño (CPF/CNPJ)
• Consulta todas las validaciones de base de datos: Precios y cobertura de la validación de base de datos
• Empieza a crear: Crea una cuenta Didit gratuita — 500 verificaciones al mes, gratis.