API de Verificación Residencial en Perú (ES)

Incorporar usuarios en Perú implica confirmar su identidad. Los datos de entrada se verifican con una fuente que comprende múltiples conjuntos de datos de registros de consumidores, telefónicos y postales. 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 en Perú 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 en Perú valida la dirección y los datos residenciales con 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 tu lógica de aprobación / revisión / rechazo.
• Por qué es importante — La verificación de direcciones con datos autorizados confirma que un solicitante realmente vive donde dice, una señal central 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.86 por consulta concluyente, resultados en segundos.

Qué valida la Verificación Residencial en Perú

Los datos de entrada se verifican con una fuente que comprende múltiples conjuntos de datos de registros de consumidores, telefónicos y postales. Didit lo expone a través de un único endpoint para que puedas verificar los datos enviados con 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 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 con datos autorizados confirma que un solicitante realmente vive donde dice, una señal central antifraude y de cumplimiento.

Para las empresas reguladas en Perú (fintechs, 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 fue confirmada en la fuente, no simplemente 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 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 PER.
services	string	Sí	Identificador de servicio. Usar per_residential.
first_name	string	Sí	Primer nombre.
last_name	string	Sí	Apellido.
address	string	Sí	Dirección.
phone	string	No	Teléfono (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=PER" \
  -F "services=per_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": "PER",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "per_residential",
      "service_name": "Peru Residential",
      "source_data": {
        "address": "123 Sample Street",
        "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.86 por consulta concluyente. Solo se te factura por resultados concluyentes; no hay cargo por tiempo de inactividad de la fuente, campos faltantes o rechazos previos a la fuente.
• Fiabilidad: funciona en la infraestructura de Didit con un objetivo de tiempo de actividad trimestral del 99.9%.

Casos de uso

• Fintechs y neobancos — confirma un titular de cuenta real y verificable antes de abrir una billetera o extender crédito en Perú.
• Cripto y Web3 — cumple 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 en la fuente.
• Mercados y plataformas de trabajo temporal — verifica usuarios con datos autorizados, no solo un formulario autoinformado.
• iGaming — satisface las comprobaciones de identidad y elegibilidad para jugadores peruanos con un registro auditable.

Cómo integrar con Didit

Puedes ejecutar la Verificación Residencial en Perú 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 Perú → Verificación Residencial en Perú y actívalo. Los usuarios coincidentes se dirigen automáticamente, no se requiere ingeniería.
2. API directa. Llama al endpoint /v3/database-validation/ mostrado arriba con services=per_residential. Lee match_type y el bloque 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 por una sola consulta.

Preguntas frecuentes

¿Qué confirma la verificación residencial en Perú?

Valida los datos enviados con 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; 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 generalmente devuelve en un par de segundos, por lo que encaja dentro de 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 en Perú hoy mismo.

• Lee la referencia de la API: Verificación Residencial en Perú
• Ver 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.