API de Verificación de Registro Fiscal de Perú (SUNAT) (ES)

Incorporar usuarios en Perú significa confirmar que son quienes dicen ser. Verifica los datos de entrada contra SUNAT. Un documento o un detalle escrito solo prueba que los datos existen, no que sean genuinos o pertenezcan a la persona que tiene enfrente. La Verificación de Registro Fiscal de Perú (SUNAT) cierra esa brecha verificando los datos contra SUNAT. 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 de Perú (SUNAT) valida la identificación fiscal contra SUNAT.
• Qué obtiene a cambio — un match_type normalizado más resultados a nivel de campo que puede dirigir directamente a la lógica de aprobación / revisión / rechazo.
• Por qué es importante — La validación de la identificación fiscal vincula a un solicitante con una identidad fiscal verificable, reduciendo el fraude de identidad sintética y de primera parte.
• Cómo usarlo — una solicitud POST al endpoint de validación de base de datos de Didit, o un módulo de flujo de trabajo sin código. $1.79 por consulta concluyente, resultados en segundos.

Qué valida la Verificación de Registro Fiscal de Perú (SUNAT)

Verifica los datos de entrada contra SUNAT. Didit lo expone a través de un único endpoint para que pueda verificar los datos enviados contra la autoridad tributaria nacional y recibir un resultado estructurado y normalizado, no un volcado de registro en bruto que tenga que analizar usted mismo.

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

Por qué es importante

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

Para las empresas reguladas en Perú — 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 se confirmó en la fuente, no simplemente 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 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 ISO 3166-1 alfa-3. Use PER.
services	string	Sí	Identificador de servicio. Use per_tax_registration.
first_name	string	Sí	Primer nombre.
last_name	string	Sí	Apellido.
date_of_birth	string	Sí	Fecha de nacimiento.
personal_number	string	Sí	Número personal.

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_tax_registration" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "personal_number=1111111"

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_tax_registration",
      "service_name": "Peru Tax Registration (SUNAT)",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "name_match_score": "1.000",
        "verifications": {
          "date_of_birth": true,
          "full_name": true,
          "identification_number": true
        }
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Rendimiento y facturación

• Latencia: típicamente un par de segundos.
• Costo: $1.79 por consulta concluyente. Se le factura solo 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 — confirme un titular de cuenta real y verificable antes de abrir una billetera o extender crédito en Perú.
• Cripto y Web3 — cumpla con los requisitos de incorporación de VASP con prueba de identidad de fuente autoritativa.
• Préstamos — reduzca el fraude de identidad sintética y de primera parte con datos verificados en la fuente.
• Mercados y plataformas de trabajo temporal — verifique usuarios contra datos autoritativos, no solo un formulario autoinformado.
• iGaming — satisfaga las verificaciones de identidad y elegibilidad para jugadores de Perú con un rastro auditable.

Cómo integrar con Didit

Puede ejecutar la Verificación de Registro Fiscal de Perú (SUNAT) de dos maneras:

1. Flujo de trabajo sin código. En la Consola de Negocios de Didit, abra el Creador de Flujos de Trabajo, agregue el módulo de Validación de Base de Datos, seleccione Perú → Verificación de Registro Fiscal de Perú (SUNAT) y actívelo. Los usuarios coincidentes se dirigen automáticamente — no se requiere ingeniería.
2. API directa. Llame al endpoint /v3/database-validation/ mostrado arriba con services=per_tax_registration. 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 el flujo completo de principio a fin antes de pagar una sola consulta.

Preguntas frecuentes

¿Qué confirma la Verificación de Registro Fiscal de Perú (SUNAT)?

Valida los datos enviados contra SUNAT y devuelve un resultado de coincidencia normalizado, para que sepa si la identificación fiscal existe en la fuente autoritativa y qué campos coincidieron.

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

No se le 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 cabe 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 puede conectarlo a un flujo de trabajo sin código en la Consola de Negocios.

¿Listo para empezar?

Valide su primera identificación fiscal de Perú hoy mismo.

• Lea la referencia de la API: Verificación de Registro Fiscal de Perú (SUNAT)
• Vea todas las validaciones de bases de datos: Precios y cobertura de validación de bases de datos
• Empiece a construir: Cree una cuenta gratuita de Didit — 500 verificaciones al mes, gratis.