VU Cloud Services

Extrae los datos del documento y valida frente y dorso

Un documento armado con el frente de una persona y el dorso de otra pasa cualquier control que solo mire si la lectura funcionó. ID Analysis es un servicio que puedes consumir vía API para leer el frente y el dorso a partir de una foto, identificar el tipo de documento y validar que el dorso corresponda al documento del frente.

Para generar tu API Key, necesitas un plan de pago de VU.

Documento de identidadFrente
Foto del titular en el frente del documento
Mismo documentoDorso
"code": 200 · "message": "Operation end successfully.""frontBackTemplateValidation": trueCorresponde al frente · sigues con los datos

Seguridad respaldada por certificaciones y ensayos independientes

Conforme a iBeta PAD Nivel 3

ISO/IEC 30107-3 · Prueba de vida

ISO/IEC 27001:2022

Gestión de seguridad de la información

ISO/IEC 27017:2015

Seguridad en servicios de nube

El problema

Leer ambas caras no garantiza que sean del mismo documento

Si alguien combina el frente de un documento con el dorso de otro, el OCR extrae datos de cada cara y la respuesta llega sin errores. Lo mismo ocurre con una foto en la que no hay ningún documento legible: la API responde con código 200, con un mensaje distinto y sin datos. Un flujo que solo verifica el código de estado aceptará ambos casos.

  • La API respondió✓ 200
  • El mensaje es de éxito✓ "Operation end successfully."
  • Se leyeron datos del dorso✓ leídos
  • ¿El dorso corresponde al frente?false
Nuestra solución

Los datos del documento, con frente y dorso validados.

Del frente, ID Analysis extrae los campos impresos, lee la zona MRZ y el código de barras (si el documento los incluye), identifica el tipo de documento y recorta el rostro. Del dorso, extrae los datos disponibles y valida que correspondan al frente. La decisión de aceptar al cliente no es automática: recibes los datos y las validaciones, y tu política define qué aceptar.

Caso 01

Ya cuentas con otro proveedor

No es necesario migrar toda tu operación para incorporar la lectura de documentos. Puedes consumir únicamente esta API, en paralelo con tu proveedor actual.

Caso 02

Recibes documentos de distintos países

Identifica el tipo de documento a partir de un catálogo de más de 90 plantillas de la región. Antes de integrarla, puedes consultar qué campos incluye cada una.

Caso 03

Estás desarrollando tu propio onboarding

Necesitas leer el documento y recortar el rostro para compararlo con la selfie. Combinas esta API con Face Analysis y mantienes el control sobre el resto del proceso.

Características principales

Tres fuentes de datos, cruzadas entre sí

Lee la zona visual, el MRZ y el código de barras cuando el documento los tiene, y te dice cuánto coinciden entre ellos, campo por campo.

Lee de
  • Zona visual (VIZ)Los campos impresos del documento
  • Código de barrasCuando el documento lo trae
  • MRZLa zona de lectura mecánica, con sus dígitos verificadores
Devuelve
  • POST /frontTipo de documento"id": "VU-ARG-ID-04"Contra más de 90 plantillas de la región
  • POST /frontRecorte del rostroListo para comparar con Face Analysis
  • POST /backValidación frente y dorso"frontBackTemplateValidation": true¿El dorso es del mismo documento?
  1. Zona visual (VIZ)Los campos impresos del documento
  2. POST /frontTipo de documento"id": "VU-ARG-ID-04"Contra más de 90 plantillas de la región
  3. POST /frontRecorte del rostroListo para comparar con Face Analysis
  4. Código de barrasCuando el documento lo trae
  5. MRZLa zona de lectura mecánica, con sus dígitos verificadores
  6. POST /backValidación frente y dorso"frontBackTemplateValidation": true¿El dorso es del mismo documento?

Los datos que trae, y cuánto confiar en cada uno

Consistencia entre fuentes

Compara entre sí la MRZ, el código de barras y la zona visual, con un porcentaje de coincidencia de 0 a 100 para cada campo. El servicio no impone un umbral: tú decides en cada campo, según los datos que alimentan tu proceso.

Catálogo de plantillas

Consultas qué campos, MRZ y código de barras incluye cada documento, y haces pruebas con imágenes de muestra anonimizadas antes de usar documentos reales.

Integración

No reemplaza a Identity Link cuando necesitas una verificación completa. Puedes usarlo de forma independiente o combinarlo con otros servicios de VU Cloud Services.

Antispoofing del documento (opcional)

Analiza si la imagen corresponde a un documento real o a una reproducción, y si la foto del titular fue adulterada. El resultado es informativo: la respuesta llega con código 200 y tu sistema decide qué hacer.

La integración

Dos llamadas y una regla de decisión.

Llamadas HTTP desde tu backend: la clave nunca queda expuesta en una app móvil ni en el navegador.

ElementoCómo funciona
POST /frontAnaliza el frente y devuelve el uuid que engancha con el dorso
POST /backAnaliza el dorso y lo cruza con el frente, usando ese uuid como relatedUuid
GET /listTemplatesLos documentos soportados. Con /{templateId}/details, qué campos esperar de cada uno, y con /{templateId}/images, imágenes de muestra anonimizadas
GET /versionVerifica conectividad. Se evalúa el código de estado, no el cuerpo
AutenticaciónCabecera Api-Key. Cada servicio tiene su propia clave, por ambiente
URL baseVU la entrega junto con la clave, según el ambiente
Entradainfo como referencia de negocio e image en base64. En el dorso, además, relatedUuid
Salidauuid, id (el tipo de documento), front y back con los datos, crossMatchConfidence, code y message
PeticiónPOST /back
// Cabecera: Api-Key: <tu clave del servicio>
{
  "info": "onboarding-12345",
  "image": "<foto del dorso en base64, sin prefijo>",
  "relatedUuid": "<el uuid que devolvió POST /front>"
}
  • "frontBackTemplateValidation": trueEl dorso corresponde al frente. Revisas la consistencia de los datos y decides.
  • "frontBackTemplateValidation": falseEs el dorso de otro documento. No aceptas.
  • "message": "Cant get document fields"En el frente: no se pudo leer el documento. Pides otra captura.
La regla de decisiónTu backend
// Frente: aceptar exige las tres condiciones.
const frenteOk =
    status === 200 &&
    body.message === "Operation end successfully." &&
    body.id !== "unknown";

// Dorso: además de lo anterior.
const dorsoOk = body.back.frontBackTemplateValidation === true;
// Y revisas body.crossMatchConfidence antes de dar por buenos los datos.

Un 200 no significa datos extraídos

Una foto sin documento legible también responde 200, con el mensaje "Cant get document fields" y el tipo de documento en "unknown". Y un dorso que no corresponde al frente responde 200 con "Operation end successfully.". Si decides solo por el código de estado, aceptas documentos ilegibles y documentos armados con caras de dos documentos distintos.

Requisitos de la imagen

La foto decide cuántos campos se pueden leer.

AspectoValor
ResoluciónMínimo 480 × 480. Hasta 1920 px de lado mejora la lectura*
EncuadreEl documento completo, apoyado y sin reflejos
FormatoJPEG o PNG. Si es JPEG, calidad 90 o superior
Codificaciónbase64 sin prefijo data: y sin saltos de línea

*Por debajo de 480 × 480 la API devuelve error. Por encima de 1920 px la imagen se reduce sola, así que enviar más no mejora la lectura.

Los reflejos vacían camposLos brillos sobre el laminado y los dedos tapando datos son la primera causa de campos vacíos y de documentos ilegibles. Guía la captura antes de enviarla: documento completo, apoyado y sin reflejos.
Cómo empiezas

Autogestionable, conecta esta API sin intermediarios

Con un plan pago, generas la clave desde el panel de VU y llamas al servicio desde tu backend.

  1. 02

    Confirmas el accesocon el método que te ofrezca el panel

  2. 03

    Abres Cloud Servicesen el menú lateral

  3. 04

    Eliges ID Analysisentre los servicios disponibles

  4. 05

    Generas la API keycon un plan pago, para el ambiente que vas a usar

  5. 06

    Copias la clave y llamas a GET /versionpara confirmar la red. La clave se prueba con el primer /front

Genera tu API Key

Para generar tu API Key, necesitas un plan de pago de VU.

Preguntas frecuentes

No. Puedes consumirla de forma independiente, con su propia clave, sobre el flujo que elijas. Convive con el proveedor que ya tienes instalado.
ID Analysis cuenta con un catálogo de más de 90 plantillas de documentos de la región. Con GET /listTemplates puedes consultar los documentos soportados, los campos, la MRZ y el código de barras que incluye cada uno, y obtener imágenes de muestra anonimizadas para hacer pruebas antes de usar documentos reales.
Puedes analizar solo el frente con POST /front y obtener los datos de esa cara. En ese caso, la validación entre frente y dorso no aplica.
Sí, si lo solicitas. El antispoofing del documento analiza si la imagen corresponde a un documento real o a una reproducción, y si la foto del titular fue adulterada. El resultado es informativo: la respuesta llega con código 200 y tu sistema decide qué hacer.
En la cabecera Api-Key de cada petición. Cada servicio tiene su propia clave para cada ambiente, y VU la proporciona junto con la URL base correspondiente.
Si en la foto no hay ningún documento legible, la API responde con código 200, con un mensaje distinto y sin datos. Por eso, tu flujo no debe basarse solo en el código de estado: revisa también code, message y que los datos esperados estén presentes.

Ya tienes los documentos. Falta leerlos y cruzarlos.

Genera tu clave y prueba con un documento que ya conoces, o con las imágenes de muestra del catálogo.

Genera tu API Key

Para generar tu API Key, necesitas un plan de pago de VU.