API de Verificación de Domicilio en Brasil (ES)

Incorporar usuarios en Brasil implica confirmar que son quienes dicen ser. Verifica contra una base de datos combinada de registros electorales. Un documento o un detalle ingresado solo demuestran que los datos existen, no que sean genuinos o pertenezcan a la persona que tiene delante. La Verificación de Domicilio en Brasil cierra esa brecha al verificar los datos con fuentes de datos residenciales y de consumidores autorizadas. 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 Domicilio en Brasil valida la dirección y los datos residenciales con fuentes de datos residenciales y de consumidores autorizadas.
• Qué obtienes a cambio: un match_type normalizado más resultados a nivel de campo que puedes enrutar directamente a una lógica de aprobación / revisión / rechazo.
• Por qué es importante: la verificación de la dirección con datos autorizados confirma que un solicitante realmente vive donde dice —una señal central contra el fraude y el cumplimiento.
• Cómo usarlo: un POST al endpoint de validación de bases de datos de Didit, o un módulo de flujo de trabajo sin código. $0.14 por consulta concluyente, resultados en segundos.

Qué valida la Verificación de Domicilio en Brasil

Verifica contra una base de datos combinada de registros electorales. Didit lo expone a través de un único endpoint para que puedas verificar los datos enviados con fuentes de datos residenciales y de consumidores autorizadas 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é es importante

La verificación de la dirección con datos autorizados confirma que un solicitante realmente vive donde dice —una señal central contra el fraude y el cumplimiento.

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

Detalles técnicos

Didit expone este servicio a través del endpoint unificado de validación de bases 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. Utilice BRA.
services	string	Sí	Identificador de servicio. Utilice bra_residential.
first_name	string	Sí	Nombre.
last_name	string	Sí	Apellido.
date_of_birth	string	Sí	Fecha de nacimiento.
address	string	Sí	Dirección.
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_residential" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "address=123 Sample Street, Sample City, 10001" \
  -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_residential",
      "service_name": "Brazil Residential",
      "source_data": {
        "address": "123 Sample Street",
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "address": "full_match",
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Rendimiento y facturación

• Latencia: normalmente un par de segundos.
• Costo: $0.14 por consulta concluyente. Solo se le factura por los resultados concluyentes —no por el tiempo de 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: confirme un titular de cuenta real y verificable antes de abrir una billetera o extender crédito en Brasil.
• Cripto y Web3: cumpla con los requisitos de incorporación de VASP con la prueba de identidad de una fuente autorizada.
• Préstamos: reduzca el fraude de identidad sintética y el fraude de primera parte con datos verificados en la fuente.
• Mercados y plataformas de trabajo por encargo: verifique a los usuarios con datos autorizados, no solo con un formulario autoinformado.
• iGaming: satisfaga los controles de identidad y elegibilidad para los jugadores de Brasil con un registro auditable.

Cómo integrarse con Didit

Puede ejecutar la Verificación de Domicilio en Brasil de dos maneras:

1. Flujo de trabajo sin código. En la Consola Empresarial de Didit, abra el Constructor de Flujos de Trabajo, agregue el módulo Validación de base de datos, seleccione Brasil → Verificación de Domicilio en Brasil y actívelo. Los usuarios coincidentes se enrutan automáticamente —no se requiere ingeniería.
2. API directa. Llame al endpoint /v3/database-validation/ mostrado anteriormente con services=bra_residential. Lea match_type y el bloque de validation por campo para impulsar su lógica de aprobación / revisión / rechazo.

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

Preguntas frecuentes

¿Qué confirma la verificación de domicilio en Brasil?

Valida los datos enviados con fuentes de datos residenciales y de consumidores autorizadas y devuelve un resultado de coincidencia normalizado, para que sepa si la dirección y los datos residenciales existen en la fuente autorizada y qué campos coincidieron.

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

No se le cobrará. 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ápido es la verificación?

La validación de la base de datos normalmente 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 puede conectarlo a un flujo de trabajo sin código en la Consola Empresarial.

¿Listo para empezar?

Valide su primera dirección y datos residenciales en Brasil hoy mismo.

• Lea la referencia de la API: Verificación de Domicilio en Brasil
• Consulte todas las validaciones de bases de datos: Precios y cobertura de la validación de bases de datos
• Comience a construir: Cree una cuenta gratuita de Didit —500 verificaciones al mes, gratis.