Skip to main content

Validaciones de Documentos

Descripción​

Las Validaciones de Documentos son el sistema central de verificación dentro de Verifik que procesa y valida los documentos de identidad de los usuarios durante el proceso de registro en la app. Piénsalas como el sistema de control de calidad que garantiza que los documentos sean auténticos, legibles y coincidan con la identidad declarada del usuario.

Cómo funcionan las Validaciones de Documentos​

Cada Validación de Documento representa una sesión única de verificación que procesa los documentos de identidad enviados por el usuario. Cuando alguien sube o escanea su cédula, pasaporte o licencia, Verifik crea una Validación de Documento para analizar el documento, extraer información y verificar su autenticidad.

Actualmente, las Validaciones de Documentos admiten estos tipos:

  • validation - Proceso estándar de verificación de documentos
  • login - Verificación de documentos para flujos de inicio de sesión
  • signup - Verificación de documentos para registro de nuevos usuarios
  • ocr - Procesamiento de reconocimiento óptico de caracteres
  • demo - Fines de demostración y pruebas

Qué registran las Validaciones de Documentos​

Las Validaciones de Documentos son sistemas de verificación integrales que procesan todos los aspectos de los documentos de identidad:

Información del documento​

  • Tipo y categoría del documento (cédula, pasaporte, licencia)
  • Número de documento y detalles de identificación
  • Verificación de país y nacionalidad
  • Extracción de información de edad y género

Proceso de verificación​

  • Método de ingreso (cámara, carga de archivo o no establecido)
  • Evaluación de calidad y legibilidad del documento
  • Extracción y validación de texto por OCR
  • Verificación de características de seguridad

Resultados de la validación​

  • Verificación de autenticidad del documento
  • Validación de exactitud de la información
  • Detección de características de seguridad
  • Evaluación y puntaje de riesgo

Endpoints de la API​

Crear una Validación de Documento​

POST https://api.verifik.co/v2/document-validations

Listar todas las Validaciones de Documentos​

GET https://api.verifik.co/v2/document-validations

Recuperar una Validación de Documento​

GET https://api.verifik.co/v2/document-validations/{validationId}

Actualizar una Validación de Documento​

PUT https://api.verifik.co/v2/document-validations/{validationId}

Eliminar una Validación de Documento​

DELETE https://api.verifik.co/v2/document-validations/{validationId}

Estructura del Objeto Validación de Documento​

{
    "id": "validation_123456789",
    "documentType": "passport",
    "status": "completed",
    "documentInfo": {
        "documentNumber": "123456789",
        "country": "US",
        "nationality": "American",
        "firstName": "John",
        "lastName": "Doe",
        "dateOfBirth": "1990-01-15",
        "gender": "Male"
    },
    "verificationResults": {
        "authenticity": "passed",
        "quality": "good",
        "ocrAccuracy": 0.98,
        "securityFeatures": "detected"
    },
    "riskScore": 0.15,
    "createdAt": "2024-01-15T10:30:00Z",
    "completedAt": "2024-01-15T10:32:00Z"
}

Casos de uso​

  • Verificación de identidad: Verifica la identidad del usuario mediante validación de documentos
  • Cumplimiento: Cumple requisitos regulatorios para verificación de documentos
  • Prevención de fraude: Detecta documentos fraudulentos o manipulados
  • Extracción de datos: Extrae datos estructurados de documentos de identidad