Datos de respuesta

Estructura de datos de respuesta producida por Landi

Estructura de callback

A continuación, se presenta una descripción detallada de la estructura de datos utilizada en nuestro sistema y los detalles específicos de cada campo de datos, incluyendo su tipo, propósito y restricciones.

Morfología:

{
  "transactionId": "TRANSACTION_ID",
  "dni": "DOCUMENT_NUMBER",
  "clientData": "CLIENT_DATA",
  "deviceInfo": "DEVICE_INFO",
  "resultJSON": {
    "DocumentData": {
      "serviceTransactionId": "TRANSACTION_ID",
      "serviceDocument": {
        "DOC_MODEL": "DOCUMENT_MODEL",
        "BACKSIDE": "DOCUMENT_BACKSIDE",
        "FRONTSIDE": "DOCUMENT_FRONTSIDE",
        "DECOMPOSED": "DOCUMENT_DECOMPOSE",
        "CHECKS": "DOCUMENT_CHECKS",
        "SCORING": "DOCUMENT_SCORING",
      }
    },
    "DocumentValidation": "DOCUMENT_VALIDATION",
    "imageFront": "FRONT_BASE64_IMAGE",
    "imageBack": "BACK_BASE64_IMAGE",
    "FacialAuthentication": "AUTHENTICATION_DATA",
    "PassiveLiveness": "PASSIVE_LIVENESS_DATA",
    "imageSelfie": "SELFIE_BASE64_IMAGE",
    "imageFrontRaw": "/9j/4AAQSkZJRgAB...",
    "imageBackRaw": "/9j/4AAQSkZJRgAB...",
    "rawTemplateSelfie": "BAEBAQJi/8ZtRtF/UV+p4Ued+Z...",
    "rawTemplateFacialCapture": "BAEBAQJQ/8ZtRtF/UV+p4Ued+Z..."
  }
}

Ejemplo:

{
  "transactionId": "00000000-0000-0000-0000-000000000000",
  "dni": "00000000A",
  "clientData": { ... },
  "deviceInfo": { ... },
  "resultJSON": {
    "DocumentData": {
      "serviceTransactionId": "00000000-0000-0000-0000-000000000000",
      "serviceDocument": {
        "DOC_MODEL": "CHILE - ID CARD (2013)",
        "BACKSIDE": { ... },
        "FRONTSIDE": { ... },
        "DECOMPOSED": { ... },
        "CHECKS": { ... },
        "SCORING": { ... },
      }
    },
    "DocumentValidation": { ... },
    "FacialAuthentication": { ... },
    "PassiveLiveness": { ... },
    "imageFront": "/9j/4AAQSkZJRgAB...",
    "imageBack": "/9j/4AAQSkZJRgAB...",
    "imageSelfie": "/9j/4AAQSkZJRgAB...",
    "imageFrontRaw": "/9j/4AAQSkZJRgAB...",
    "imageBackRaw": "/9j/4AAQSkZJRgAB...",
    "rawTemplateSelfie": "BAEBAQJi/8ZtRtF/UV+p4Ued+Z...",
    "rawTemplateFacialCapture": "BAEBAQJQ/8ZtRtF/UV+p4Ued+Z..."
  }
}

---

Listado de parámetros

Esta es una colección de ejemplos de los datos que se envían:

TRANSACTION_ID

ID único de la transacción.

Detalles:

• ¿Puede estar vacío?: No.

Ejemplo:

"00000000-0000-0000-0000-000000000000"

---

DOCUMENT_NUMBER

Almacena el número de documento asociado a un cliente.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: No hay un número de documento; esto podría deberse a que el servicio no pudo extraer el número de documento o hubo un problema durante el proceso de extracción de datos.

Ejemplo:

"00000000A"

"0000000"

undefined

---

CLIENT_DATA

Almacena la información de un cliente que ha completado el proceso de alta.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: No hay datos del cliente; esto podría deberse a que no se ha iniciado una sesión o hubo un problema durante el proceso de la sesión.

Morfología:

{
  "customerId": "CUSTOMER_ID"
}

Ejemplo:

{
  "customerId": "0d8d7059"
}

{}

Referencia de campo:

CUSTOMER_ID

Este identificador se utiliza para distinguir a cada usuario en el sistema. Este identificador puede ser proporcionado por la empresa contratante o generado internamente.

Ejemplo:

"0d8d7059"

"0034666666666"

"00000000-0000-0000-0000-000000000000"

---

DEVICE_INFO

Almacena información sobre el dispositivo utilizado por el cliente durante el proceso de alta.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: No hay información del dispositivo; esto podría deberse a que la información del dispositivo no se ha enviado o hubo un problema durante el proceso del evento.

Morfología:

{
  "osName": "OS_NAME",
  "osVersion": "OS_VERSION",
  "model": "DEVICE_MODEL",
  "brand": "DEVICE_BRAND",
  "browser": "DEVICE_BROWSER"
}

Ejemplo:

{
  "osVersion": "114.0.0.0",
  "model": "114.0.0.0",
  "brand": "Chrome",
  "browser": "Chrome",
  "osName": "Mac OS"
}

{}

Referencia de campos:

OS_NAME

Almacena información sobre el nombre del sistema operativo.

Ejemplo:

"114.0.0.0"

OS_VERSION

Almacena información sobre la versión del sistema operativo.

Ejemplo:

"114.0.0.0"

DEVICE_MODEL

Almacena información sobre el modelo del dispositivo.

Ejemplo:

"Chrome"

DEVICE_BRAND

Almacena información sobre la marca del dispositivo.

Ejemplo:

"Chrome"

DEVICE_BROWSER

Almacena información sobre el navegador del dispositivo.

Ejemplo:

"Mac OS"

---

DOCUMENT_MODEL

Almacena el modelo o tipo de documento.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: No se detectó ningún modelo de documento; esto podría deberse a que el servicio no pudo detectar el modelo de documento o hubo un problema durante el proceso de extracción de datos.

Ejemplo:

"CHILE - ID CARD (2013)"

undefined

---

DOCUMENT_BACKSIDE

Almacena la información y los detalles específicos relacionados con el reverso o la parte posterior de un documento.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: No hay una imagen del reverso del documento; esto podría deberse a que es un pasaporte, la identificación no requiere una imagen del documento, la imagen no se ha enviado o hubo un problema durante el proceso de extracción de datos.

Ejemplo:

{
  "FIELD_DATA": { ... },
  "MRZ_DATA": { ... }
}

undefined

---

DOCUMENT_FRONTSIDE

Almacena la información y los detalles específicos relacionados con el anverso de un documento.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: No hay una imagen del anverso del documento; esto podría deberse a que la identificación no requiere una imagen del documento, la imagen no se ha enviado o hubo un problema durante el proceso de extracción de datos.

Ejemplo:

{
  "FIELD_DATA": { ... },
  "MRZ_DATA": { ... }
}

undefined

---

DOCUMENT_DECOMPOSE

Almacena fragmentos o recortes de las imágenes del documento.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: No hay información del dispositivo; esto podría deberse a que la información del dispositivo no se ha enviado o hubo un problema durante el proceso del evento.

Morfología:

{
  "FACE": "DOCUMENT_PORTRAIT_BASE64_IMAGE"
}

Ejemplo:

{
  "FACE": "/9j/4AAQSkZJRgAB..."
}

undefined

Referencia de campos:

DOCUMENT_PORTRAIT_BASE64_IMAGE

Almacena el recorte o fragmento de la foto del documento que muestra exclusivamente la cara del usuario.

Ejemplo:

"/9j/4AAQSkZJRgAB..."

---

DOCUMENT_CHECKS

Almacena una colección de campos de los pasos que han sido verificados o comprobados durante el proceso de extracción de datos.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: No hay comprobaciones de datos; esto podría deberse a que el servicio no genera comprobaciones de datos o hubo un problema durante el proceso de extracción de datos.

Ejemplo:

{
  "PERSONAL_NUMBER_SIDE_MATCH": false,
  "NATIONALITY_SIDE_MATCH": true
}

undefined

---

DOCUMENT_SCORING

Almacena una colección de puntuaciones que evalúan la fiabilidad de los datos extraídos de un documento.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: No hay datos de puntuación; esto podría deberse a que el servicio no genera datos de puntuación o hubo un problema durante el proceso de extracción de datos.

Ejemplo:

 {
  "FIELDS_RETURNED": 20,
  "FIELDS_TOTAL": 20,
  "OVERALL_RATING": 100,
  "BACK_SHA256": "SHA_CODE",
  "FRONT_SHA256": "SHA_CODE"
}

undefined

---

DOCUMENT_VALIDATION

Almacena información relacionada con la validación del documento.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: No hay datos de validación del documento; esto podría deberse a que el servicio no está habilitado o hubo un problema durante el proceso de validación del documento.

Morfología:

{
  "scanReference": "DOCUMENT_VALIDATION_REFERENCE",
  "type": "DOCUMENT_VALIDATION_TYPE",
  "timestamp": "DOCUMENT_VALIDATION_TIME",
}

Ejemplo:

{
  "scanReference": "00000000-0000-0000-0000-000000000000",
  "type": "3",
  "timestamp": "1970-01-01T00:00:00.000Z",
}

{}

Referencia de campos:

DOCUMENT_VALIDATION_REFERENCE

Almacena información relacionada con la referencia de validación del documento.

Ejemplo:

"00000000-0000-0000-0000-000000000000"

DOCUMENT_VALIDATION_TYPE

Almacena información relacionada con el estado de validación del documento.

Ejemplo:

"3"

DOCUMENT_VALIDATION_TIME

Almacena información relacionada con la fecha de validación del documento.

Ejemplo:

"1970-01-01T00:00:00.000Z"

---

FRONT_BASE64_IMAGE

Almacena la imagen del anverso de un documento.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: No hay una imagen del anverso del documento; esto podría deberse a que la imagen no se ha enviado o hubo un problema durante el guardado.

Ejemplo:

"/9j/4AAQSkZJRgAB..."

undefined

---

BACK_BASE64_IMAGE

Almacena la imagen del reverso de un documento.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: No hay una imagen del reverso del documento; esto podría deberse a que la imagen no se ha enviado o hubo un problema durante el guardado.

Ejemplo:

"/9j/4AAQSkZJRgAB..."

undefined

---

AUTHENTICATION_DATA

Almacena información relacionada con la autenticación de la persona.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: No hay datos de autenticación facial; esto podría deberse a que hubo un problema durante el proceso de autenticación facial.

Morfología:

{
  "serviceResultLog": "AUTHENTICATION_STATUS",
  "serviceFacialSimilarityResult": "AUTHENTICATION_SIMILARITY"
}

Ejemplo:

{
  "serviceResultLog": "POSITIVE",
  "serviceFacialSimilarityResult": 0.9923387765884399
}

{}

Referencia de campos:

AUTHENTICATION_STATUS

Almacena el estado de autenticación.

Ejemplo:

"POSITIVE"

AUTHENTICATION_SIMILARITY

Almacena la medida de similitud o el nivel de coincidencia obtenido durante el proceso de autenticación de una persona.

Ejemplo:

0.9923387765884399

0.6823991719034381

---

PASSIVE_LIVENESS_DATA

Almacena información relacionada con la prueba de vida pasiva de la persona.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: No hay datos de prueba de vida pasiva; esto podría deberse a que hubo un problema durante el proceso de prueba de vida pasiva.

Morfología:

{
  "serviceResultLog": "PASSIVE_LIVENESS_RESULT"
}

Ejemplo:

{
  "serviceResultLog": "NO_LIVE"
}

{}

Referencia de campos:

PASSIVE_LIVENESS_RESULT

Almacena el resultado de la prueba de vida pasiva.

Ejemplo:

"NO_LIVE"

---

SELFIE_BASE64_IMAGE

Almacena la imagen del selfie de una persona.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: No hay una imagen de selfie; esto podría deberse a que la imagen no se ha enviado o hubo un problema durante el guardado.

Ejemplo:

"/9j/4AAQSkZJRgAB..."

undefined

---

FRONT_RAW_BASE64_IMAGE

Almacena el fotograma completo del anverso del documento en formato base64.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: Es posible que la imagen del anverso del documento no se haya enviado, o hubo un problema durante el proceso de extracción.

Ejemplo:

"/9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1..."

undefined

---

BACK_RAW_BASE64_IMAGE

Almacena el fotograma completo del reverso del documento en formato base64.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: Es posible que la imagen del reverso del documento no se haya enviado, o hubo un problema durante el proceso de extracción.

Ejemplo:

"/9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1..."

undefined

---

RAW_TEMPLATE_SELFIE (templateRaw)

Almacena la plantilla biométrica en bruto del selfie (templateRaw) en formato base64.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: Es posible que la plantilla del selfie no se haya enviado, o hubo un problema durante el proceso de extracción biométrica.

Ejemplo:

"BAEBAQJi/8ZtRtF/UV+p4Ued+Z..."

undefined

---

RAW_TEMPLATE_FACIAL_CAPTURE

Almacena la plantilla en bruto de la captura facial del documento (rawTemplateFacialCapture) en formato base64.

Detalles:

• ¿Puede estar vacío?: Sí.

• Razón: Es posible que la plantilla de captura facial no se haya enviado, o hubo un problema durante el proceso de extracción biométrica.

Ejemplo:

"BAEBAQJQ/8ZtRtF/UV+p4Ued+Z..."

undefined

---

Ejemplo de callback

Respuesta de Callback Exitosa

Este caso de uso describe el escenario en el que un cliente completa con éxito el proceso de alta en una plataforma o servicio.

{
  "transactionId": "213d0fd9-57fb-4a87-8237-2778015c94d5",
  "dni": "00000000",
  "clientData": {
    "customerId": "0d8d7059"
  },
  "resultJSON": {
    "DocumentData": {
      "serviceTransactionId": "3442d94c-9610-41ea-b228-5c4823020153",
      "serviceResultCode": 0,
      "serviceResultLog": "Service request successfully processed",
      "serviceDocument": {
        "CHECKS": {
          "BIRTH_DATE_SIDE_MATCH": true,
          "RUN_SIDE_MATCH": true,
          "IDENTITY_NUMBER_SIDE_MATCH": true,
          "SURNAME_SIDE_MATCH": true,
          "EXPIRATION_DATE_SIDE_MATCH": true,
          "NAME_SIDE_MATCH": true,
          "NATIONALITY_SIDE_MATCH": false
        },
        "BACKSIDE": {
          "FIELD_DATA": {},
          "MRZ_DATA": {
            "NATIONALITY": "XXX",
            "SERIAL_NUMBER": "000000000",
            "SURNAME": "DOE",
            "EXPIRATION_DATE": "01/01/1970",
            "SEX": "F",
            "BIRTH_DATE": "01/01/1970",
            "ISSUING_COUNTRY": "XXX",
            "IDENTITY_NUMBER": "000000000",
            "PERSONAL_NUMBER": "000",
            "RUN": "00000000-0",
            "NAME": "SUSAN"
          }
        },
        "FRONTSIDE": {
          "FIELD_DATA": {
            "NATIONALITY": "UNKNOWN",
            "SURNAME": [
              "DOE"
            ],
            "EXPIRATION_DATE": "01/01/1970",
            "BIRTH_DATE": "01/01/1970",
            "IDENTITY_NUMBER": "000.000.000",
            "RUN": "00.000.000-0",
            "EXPEDITION_DATE": "01/01/1970",
            "NAME": "SUSAN"
          }
        },
        "DECOMPOSED": {
          "SIGNATURE": "{Base64}",
          "FACE": "{Base64}"
        },
        "SCORING": {
          "FIELDS_TOTAL": 27,
          "FIELDS_RETURNED": 27,
          "OVERALL_RATING": 100
        },
        "DOC_MODEL": "NEW"
      },
      "serviceTime": "250"
    },
    "DocumentValidation": {
      "scanReference": "572c05a2-faf7-42c2-a583-c0e85a73a263",
      "type": "3",
      "timestamp": "1970-01-01T00:00:00.000Z"
    },
    "FacialAuthentication": {
      "serviceTransactionId": "eb61872d-381f-4759-8cfd-799071c759ae",
      "serviceResultCode": 0,
      "serviceFacialAuthenticationResult": 3,
      "serviceResultLog": "Positive",
      "serviceFacialAuthenticationHash": "{SHA}",
      "serviceFacialSimilarityResult": 0.9917689,
      "serviceTime": "250"
    },
    "PassiveLiveness": {
      "serviceResultCode": 0,
      "serviceResultLog": "Spoof",
      "serviceTime": "250",
      "serviceTransactionId": "752fa584-dfce-498c-a6c3-4ec79394e722",
      "serviceLivenessResult": 1
    },
    "imageFront": "{Base64}",
    "imageBack": "{Base64}",
    "imageSelfie": "{Base64}",
    "imageFrontRaw": "{Base64}",
    "imageBackRaw": "{Base64}",
    "rawTemplateSelfie": "{Base64}",
    "rawTemplateFacialCapture": "{Base64}"
  },
  "deviceInfo": {
    "osVersion": "16.3",
    "model": "16.3",
    "brand": "Mobile Safari",
    "browser": "Mobile Safari",
    "osName": "iOS"
  },
}

Respuesta de Callback Vacía

Este caso de uso aborda el escenario en el que todas las opciones o alternativas posibles carecen de contenido o están vacías:

{
  "transactionId": "213d0fd9-57fb-4a87-8237-2778015c94d5",
  "clientData": {},
  "deviceInfo": {},
  "resultJSON": {
    "DocumentData": {
      "serviceTransactionId": "3442d94c-9610-41ea-b228-5c4823020153",
      "serviceDocument": {},
    "DocumentValidation": {},
    "FacialAuthentication": {},
    "PassiveLiveness": {},
  },
}