Skip to main content

​
Resumen

Las APIs ID Verification, Face Match y Liveness (KYC por sesión) devuelven un campo warnings cuando el proveedor de verificación señala incidencias no bloqueantes o banderas de riesgo. warnings es un array de cadenas con códigos de riesgo (por ejemplo "POSSIBLE_DUPLICATED_USER", "LOW_FACE_MATCH_SIMILARITY"). Los clientes pueden usar estos códigos para:
  • Visualización: Asignar cada código a un mensaje legible (p. ej. con i18n propio o las descripciones siguientes).
  • Lógica: Actuar según el código (p. ej. distinta UX para DOCUMENT_EXPIRED frente a POSSIBLE_DUPLICATED_USER).
Los códigos son por servicio: ID Verification, Face Match y Liveness tienen cada uno su propio conjunto. Abajo se listan los valores posibles de cada uno.
Si el proveedor devuelve un código no listado aquí, igual puede aparecer en warnings. Tratá los códigos desconocidos como advertencias genéricas y mostrá el código o un mensaje de respaldo.

​
ID Verification

Se devuelve en POST /api/kyc/id-verification y GET /api/kyc/id-verification/verifications/:id en el array warnings.
CódigoDescripción
ID_DOCUMENT_IN_BLOCKLISTEl documento coincide con una entrada de su lista de documentos bloqueados (fraudulentos, robados o problemáticos).
BARCODE_NOT_DETECTEDNo se pudo encontrar o leer el código de barras del documento (calidad de imagen o tipo no soportado).
BARCODE_VALIDATION_FAILEDEl código de barras no pudo validarse con el resto de los datos del documento.
QR_NOT_DETECTEDNo se pudo encontrar o leer el código QR del documento.
QR_VALIDATION_FAILEDEl código QR no pudo validarse con el resto de los datos del documento.
MRZ_NOT_DETECTEDNo se encontró o leyó la zona de lectura mecánica (MRZ) del documento.
MINIMUM_AGE_NOT_METLa edad del usuario está por debajo del mínimo requerido.
DATA_INCONSISTENTLos datos OCR y del chip NFC no coinciden; posible alteración o inconsistencia.
COULD_NOT_RECOGNIZE_DOCUMENTNo se pudo confirmar la autenticidad o validez del documento.
PORTRAIT_IMAGE_NOT_DETECTEDNo se pudo identificar o procesar la foto del documento.
DOCUMENT_NUMBER_NOT_DETECTEDNo se pudo localizar o leer el número de documento.
DATE_OF_BIRTH_NOT_DETECTEDNo se pudo identificar la fecha de nacimiento en el documento.
EXPIRATION_DATE_NOT_DETECTEDNo se pudo identificar la fecha de vencimiento en el documento.
NAME_NOT_DETECTEDNo se pudo identificar el nombre y/o apellido en el documento.
MRZ_AND_DATA_EXTRACTED_FROM_OCR_NOT_SAMEHay diferencias entre el MRZ y los datos extraídos por OCR; posible alteración del documento.
MRZ_VALIDATION_FAILEDEl MRZ no cumple el formato esperado o contiene datos inválidos.
INVALID_DATEUna o más fechas del documento no son válidas o no coinciden con el formato esperado.
DOCUMENT_EXPIREDLa fecha de vencimiento del documento ya pasó.
DOCUMENT_NOT_SUPPORTED_FOR_APPLICATIONEl tipo de documento no está aceptado en este proceso de verificación.
DOCUMENT_SIDES_MISMATCHLas caras del documento no coinciden con el formato esperado.
COULD_NOT_DETECT_DOCUMENT_TYPENo se pudo determinar el tipo de documento enviado.
DOCUMENT_NAME_DIFFERENT_FROM_OTHER_APPROVED_DOCUMENTSEl nombre en este documento no coincide con el de otros documentos ya verificados para este usuario.
POSSIBLE_DUPLICATED_USEREl sistema identificó un posible usuario duplicado con documentos aprobados en otra sesión; se requiere investigación.
LOW_FRONT_CAMERA_FACE_MATCH_SIMILARITYEl rostro capturado no coincide suficientemente con la foto del documento.
FULL_NAME_MISMATCH_WITH_PROVIDEDEl nombre completo proporcionado no coincide con el extraído del documento.
DOB_MISMATCH_WITH_PROVIDEDLa fecha de nacimiento proporcionada no coincide con la del documento.
GENDER_MISMATCH_WITH_PROVIDEDEl género proporcionado no coincide con el del documento.
COUNTRY_MISMATCH_WITH_PROVIDEDEl país proporcionado no coincide con el del documento.
NATIONALITY_MISMATCH_WITH_PROVIDEDLa nacionalidad proporcionada no coincide con la del documento.
IDENTIFICATION_NUMBER_MISMATCH_WITH_PROVIDEDEl número de identificación proporcionado no coincide con el del documento.
SCREEN_CAPTURE_DETECTEDEl documento parece ser una captura de pantalla o foto de un documento en pantalla, no el físico.
PRINTED_COPY_DETECTEDEl documento parece ser una copia impresa, no el original oficial.
PORTRAIT_MANIPULATION_DETECTEDSe detectó posible manipulación del área de la foto del documento.
UNPARSED_ADDRESSLa dirección del documento no pudo interpretarse o geolocalizarse.
DOCUMENT_NUMBER_FORMAT_MISMATCHEl número de documento no coincide con el formato esperado para este tipo.
PERSONAL_NUMBER_FORMAT_MISMATCHEl número personal no coincide con el formato esperado para este tipo de documento.
ID_VERIFICATION_DATA_MISMATCH_BETWEEN_DOCUMENTSLos datos extraídos de varios documentos de esta sesión no coinciden (nombre o fecha de nacimiento).

​
Face Match

Se devuelve en POST /api/kyc/face-match y GET /api/kyc/face-match/verifications/:id en el array warnings.
CódigoDescripción
LOW_FACE_MATCH_SIMILARITYLos rasgos faciales de la imagen no coinciden lo suficiente con la imagen de referencia.
NO_REFERENCE_IMAGEFalta una imagen de referencia para la comparación facial.

​
Liveness (KYC por sesión)

Se devuelve en las respuestas de validación KYC por sesión (p. ej. validación actual, listado) cuando se realizan chequeos de vivacidad. El array warnings del payload puede contener estos códigos.
CódigoDescripción
FACE_IN_BLOCKLISTEl rostro coincide con una entrada de su lista de rostros bloqueados.
POSSIBLE_FACE_IN_BLOCKLISTEl sistema identificó un posible rostro en la lista de bloqueados.
LOW_LIVENESS_SCOREEl chequeo de vivacidad obtuvo una puntuación baja.
NO_FACE_DETECTEDNo se identificó un rostro durante el chequeo de vivacidad.
LIVENESS_FACE_ATTACKSe detectó un posible intento de evadir el chequeo de vivacidad.
DUPLICATED_FACESe identificó un rostro duplicado de otra sesión aprobada.
POSSIBLE_DUPLICATED_FACEEste rostro podría coincidir con otro usuario ya aprobado en el sistema.
MULTIPLE_FACES_DETECTEDSe detectaron varios rostros en la imagen. Se usa el más grande para la verificación. (Solo Liveness pasivo)
LOW_FACE_QUALITYLa calidad de la imagen facial está por debajo del umbral aceptable. (Solo Liveness pasivo)
LOW_FACE_LUMINANCELa imagen facial es demasiado oscura. (Solo Liveness pasivo)
HIGH_FACE_LUMINANCELa imagen facial está demasiado brillante o sobreexpuesta. (Solo Liveness pasivo)

​
Ejemplo de respuesta (ID Verification)

{
  "status": "approved",
  "verificationId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "requestId": "req_abc",
  "extractedData": { "fullName": "Jane Doe", "documentNumber": "12345678" },
  "warnings": ["POSSIBLE_DUPLICATED_USER"]
}

​
Ejemplo de respuesta (Face Match)

{
  "match": true,
  "score": 85,
  "status": "approved",
  "verificationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "warnings": []
}

ID Verification

Verificar frente/reverso del documento y extraer datos

Face Match

Comparar retrato del documento y selfie