API de Verificación Residencial en Portugal

Incorporar usuarios en Portugal significa confirmar que son quienes dicen ser. Verifica los datos de entrada contra una fuente de datos combinada de propiedad y registros de autoridades públicas. Un documento o un detalle escrito solo prueba que los datos existen, no que sean genuinos o pertenezcan a la persona que tienes delante. La Verificación Residencial de Portugal cierra esa brecha al cotejar los datos con fuentes autorizadas de datos residenciales y de consumidores. 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 Residencial de Portugal valida la dirección y los datos residenciales contra fuentes autorizadas de datos residenciales y de consumidores.
• Qué obtienes — un match_type normalizado más resultados a nivel de campo que puedes dirigir directamente a la lógica de aprobación / revisión / rechazo.
• Por qué es importante — La verificación de direcciones contra datos autorizados confirma que un solicitante realmente vive donde dice, una señal fundamental antifraude y de cumplimiento.
• 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. $1.02 por consulta concluyente, resultados en segundos.

Qué valida la Verificación Residencial de Portugal

Verifica los datos de entrada contra una fuente de datos combinada de propiedad y registros de autoridades públicas. Didit lo expone a través de un único endpoint para que puedas verificar los datos enviados contra fuentes autorizadas de datos residenciales y de consumidores y recibir un resultado estructurado y normalizado, no un volcado de registro en bruto 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 direcciones contra datos autorizados confirma que un solicitante realmente vive donde dice, una señal fundamental antifraude y de cumplimiento.

Para empresas reguladas en Portugal —fintechs, plataformas de criptomonedas, prestamistas, mercados y operadores de juegos— la verificación contra una fuente autorizada produce un registro defendible y auditable de que la identidad fue confirmada en la fuente, no meramente capturada 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 ISO 3166-1 alpha-3. Usar PRT.
services	string	Sí	Identificador del servicio. Usar prt_residential.
first_name	string	Sí	Primer nombre.
last_name	string	Sí	Apellido.
address	string	Sí	Dirección.
date_of_birth	string	No	Fecha de nacimiento (verificación cruzada opcional).

Ejemplo de solicitud

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=PRT" \
  -F "services=prt_residential" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "address=123 Sample Street, Sample City, 10001"

Ejemplo de respuesta (coincidencia concluyente)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "PRT",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "prt_residential",
      "service_name": "Portugal Residential",
      "source_data": {
        "address": "123 Sample Street",
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "address": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

Rendimiento y facturación

• Latencia: típicamente un par de segundos.
• Costo: $1.02 por consulta concluyente. Solo se te factura por resultados concluyentes; no hay cargo por inactividad de la fuente, campos faltantes o 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 Portugal.
• Cripto y Web3 — cumple con los requisitos de incorporación de VASP con prueba de identidad de fuente autorizada.
• Préstamos — reduce el fraude de identidad sintética y de primera parte con datos verificados por la fuente.
• Mercados y plataformas de trabajo temporal — verifica a los usuarios contra datos autorizados, no solo un formulario autoinformado.
• iGaming — satisface las verificaciones de identidad y elegibilidad para jugadores de Portugal con un rastro auditable.

Cómo integrar con Didit

Puedes ejecutar la Verificación Residencial de Portugal de dos maneras:

1. Flujo de trabajo sin código. En la Consola de Negocios de Didit, abre el Creador de Flujos de Trabajo, añade el módulo de Validación de Base de Datos, selecciona Portugal → Verificación Residencial de Portugal y actívalo. Los usuarios coincidentes se enrutan automáticamente, sin necesidad de ingeniería.
2. API directa. Llama al endpoint /v3/database-validation/ mostrado arriba con services=prt_residential. Lee match_type y el bloque de validation por campo para impulsar tu lógica de aprobación / revisión / rechazo.

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

Preguntas frecuentes

¿Qué confirma la verificación residencial de Portugal?

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

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

No se te cobra. La facturación se aplica solo a resultados concluyentes; la 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 generalmente devuelve resultados en un par de segundos, por lo que se ajusta a 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 dirección y datos residenciales de Portugal hoy mismo.

• Lee la referencia de la API: Verificación Residencial de Portugal
• Consulta todas las validaciones de base de datos: Precios y cobertura de validación de base de datos
• Empieza a construir: Crea una cuenta gratuita de Didit — 500 verificaciones al mes, gratis.