Skip to main content

Veritran Docs

Innovatrics

Esta integración te permite habilitar el SDK de Innovatrics en la plataforma y acceder a sus funcionalidades.

Nota

Es posible que la integración descrita en este artículo no se implemente en tu ambiente ni esté habilitada para todos tus clientes. Comunícate con tu administrador para recibir ayuda. Ponte en contacto con tu administrador para obtener ayuda.

Detalles técnicos

ID de API

508

Código de la API

INNOVATRICS

Versión de la Call API

2

SDK Version

iOS: [1.1.4] DotDocument, [3.3.1] DotFacePassiveLiveness. Última actualización: Sept 2020

Android: [2.3.0] DotDocument, [3.7.1] DotFacePassiveLiveness. Última actualización: Jul 2021

Versión de la app

6.5.x

Objetivo

Acceso a las funcionalidades de Innovatrics

Disponible para

Android, iOS

Uso de la integración de Innovatrics en Studio

Las siguientes funciones están disponibles para que las uses en tus procesos legacy y también puedes usarlas como bloques en los procesos lambda. Haz clic en cada función para obtener más detalles. Haga clic en cada función para ver más detalles.

Get Status

Obtiene los datos básicos de la Call API.

Face Capture

Busca una captura de rostro para realizar la verificación.

Liveness Check 2

Realiza una verificación de usuarios reales en el modo 2, con un objeto moviéndose en pantalla.

Face detector

Permite la detección de rostro en una imagen.

Template Verifier

Compara una plantilla de imagen con una imagen móvil tomada por el usuario para la verificación.

Face Image Verifier

Compara la plantilla de una imagen con una imagen almacenada en un ID para la verificación.

Document Autocapture

Captura una imagen.

Liveness Check

Realiza una verificación de usuarios reales en el modo 1, con un objeto moviéndose en pantalla.

Get Status

Con esta función, se obtienen los datos básicos de la Call API.

Configuración del parámetro

Esta función no requiere la configuración de ningún parámetro.

ID de la función

Registro

Valor

110

1

Registros de salida

Registro

Descripción

Valor

112

Resultado de la Call

000

NO_ERROR

001

API_GENERIC_ERROR

003

API_SDK_NOT_INITIALIZED

290

API Version

Devuelve la versión de la Call API.

291

SDK Version

Devuelve la versión del SDK.

292

License ID

Devuelve el ID de la licencia del SDK.

293

Is Initialized

Devuelve true o false, ya sea que se haya iniciado o no la Call API.

Face Capture

Con esta función, se obtiene una imagen del rostro apta para ser verificada.

Configuración del parámetro

Esta función no requiere la configuración de ningún parámetro obligatorio. Lea Registros de entrada para obtener información sobre los parámetros opcionales que puede configurar.

ID de la función

Registro

Valor

110

2

Registros de entrada

Registro

Descripción

Obligatorio

Valor

390

Parámetros de captura de rostro

No

Parámetros en formato JSON. Por ejemplo:

{ 
   'cameraFacing':'CAMERA_FACING_FRONT',
   'cameraPreviewScaleType':'CENTER_INSIDE'
}

Nota

Para obtener más información sobre los parámetros que puede utilizar para esta función, consulte la documentación para desarrolladores de Innovatrics. Tenga en cuenta que este es un sitio de documentación de terceros.

391

ID de la imagen capturada

No

ID donde se almacena la imagen capturada. Por defecto, el ID es "faceCapture".

392

Porcentaje de compresión

No

Los valores van del 0 al 100; el 0 es la compresión máxima y el 100 es la ausencia de compresión. El valor por defecto es 70. El valor por defecto es 70.

393

Proveedores de calidad

No

Lista de proveedores de calidad separados por una coma. Si desea agregar nuevos proveedores de calidad, debe agregar POSICIÓN, PROXIMIDAD, LUZ y FACE_CONFIDENCE.

Registros de salida

Registro

Descripción

Valor

112

Resultado de la Call

000

NO_ERROR

001

API_GENERIC_ERROR

002

API_WRONG_PARAMETERS_ERROR

003

API_SDK_NOT_INITIALIZED

004

INTERRUPTED

005

CAMERA_INIT_FAILED

006

CAMERA_ACCESS_FAILED

007

NO_CAMERA_PERMISSION

014

COMPRESSION_PARAMETER_NOT_IN_RANGE. Solo disponible para iOS.

Liveness Check 2

Mediante esta función, se lleva a cabo una verificación de usuarios reales en el segundo modo, donde hay un objeto en movimiento o que desaparece en pantalla.

Configuración del parámetro

Esta función no requiere la configuración de ningún parámetro obligatorio. Lea Registros de entrada para obtener información sobre los parámetros opcionales que puede configurar.

ID de la función

Registro

Valor

110

3

Registros de entrada

Registro

Descripción

Obligatorio

Valor

390

Parámetros de la verificación de usuarios reales

No

Parámetros en formato JSON. Por ejemplo:

{ 
   'cameraFacing':'CAMERA_FACING_FRONT',
   'cameraPreviewScaleType':'CENTER_INSIDE'
}

Nota

Para obtener más información sobre los parámetros que puede utilizar para esta función, consulte la documentación para desarrolladores de Innovatrics. Tenga en cuenta que este es un sitio de documentación de terceros.

391

ID de la imagen capturada

No

ID donde se almacena la imagen capturada. Por defecto, el ID es «livenessCheck2».

392

Lista de ID para cada una de las imágenes capturadas del segmento.

No

Esta cadena contiene los ID donde se almacenan las imágenes de todos los segmentos. Los ID se separan con comas. Por defecto, los ID que se utilizan son: livenessCheck21, livenessCheck22, livenessCheck23, livenessCheck24, livenessCheck25, livenessCheck26, livenessCheck27.

393

Lista de segmentos

No

Esta cadena contiene una lista de segmentos que se utilizan durante la comprobación de vivacidad, separados por comas. Los posibles segmentos a utilizar son: TOP_LEFT, TOP_RIGHT, BOTTOM_LEFT y BOTTOM_RIGHT.

394

Segmentos mínimos

No

Valor numérico entre 4 y 7 que determina la cantidad de segmentos que deben estar disponibles después de la verificación de usuarios reales para que esta se considere válida. El número por defecto es 4, que es el valor mínimo. El número predeterminado es 4, que es el valor mínimo.

395

Porcentaje de compresión

No

Los valores van del 0 al 100; el 0 es la compresión máxima y el 100 es la ausencia de compresión. El valor por defecto es 70. El valor por defecto es 70.

Registros de salida

Registro

Descripción

Valor

112

Resultado de la Call

000

NO_ERROR

001

API_GENERIC_ERROR

002

API_WRONG_PARAMETERS_ERROR

003

API_SDK_NOT_INITIALIZED

004

INTERRUPTED

005

CAMERA_INIT_FAILED

006

CAMERA_ACCESS_FAILED

007

NO_CAMERA_PERMISSION

008

NO_MORE_SEGMENTS

009

EYES_NOT_DETECTED

010

FACE_TRACKING_FAILED

013

LESS_SEGMENTS_THAN_REQUIRED

014

COMPRESSION_PARAMETER_NOT_IN_RANGE. Solo disponible para iOS.

290

Puntaje de verificación de usuarios reales

Face Detector

Esta función permite la detección de un rostro en una imagen.

Configuración del parámetro

Esta función no requiere la configuración de ningún parámetro obligatorio. Lea Registros de entrada para obtener información sobre los parámetros opcionales que puede configurar.

ID de la función

Registro

Valor

110

4

Registros de entrada

Registro

Descripción

Obligatorio

Valor

390

Cantidad máxima de rostros que se detectarán

No

El número por defecto es 5 y el número máximo es 10.

391

ID que almacena la imagen que se analizará.

No

El ID por defecto es «documentAutocapture».

Registros de salida

Registro

Descripción

Valor

112

Resultado de la Call

000

NO_ERROR

001

API_GENERIC_ERROR

002

API_WRONG_PARAMETERS_ERROR

003

API_SDK_NOT_INITIALIZED

012

NO_FACES_DETECTED

290

JSON que contiene los datos de un rostro detectado en una imagen.

<<JSONObject>>. <<JSONObject>>. Al final del archivo JSON, hay un campo «image identifier» desde el que puedes obtener el ID donde se almacena la imagen analizada.

Nota

Si se detectan más caras en la imagen, los resultados se almacenarán en un parámetro de salida que oscila entre 291 y 299. Si no se detectan caras, el resultado será la respuesta 012 como se muestra en la tabla anterior.

Template Verifier

Con esta función, se compara una plantilla ya almacenada en el dispositivo con una imagen recién capturada del usuario para su verificación.

Configuración del parámetro

Esta función no requiere la configuración de ningún parámetro obligatorio. Lea Registros de entrada para obtener información sobre los parámetros opcionales que puede configurar.

ID de la función

Registro

Valor

110

5

Registros de entrada

Registro

Descripción

Obligatorio

Valor

390

ID de la plantilla almacenada

Por defecto, el ID es «livenessCheck2Template».

Por defecto, el valor de la compresión de imágenes dentro de esta función es 70 y no puede modificarse.

Registros de salida

Registro

Descripción

Valor

112

Resultado de la Call

000

NO_ERROR

001

API_GENERIC_ERROR

002

API_WRONG_PARAMETERS_ERROR

003

API_SDK_NOT_INITIALIZED

004

INTERRUPTED

005

CAMERA_INIT_FAILED

006

CAMERA_ACCESS_FAILED

007

NO_CAMERA_PERMISSION

011

TEMPLATE_INCOMPATIBLE

290

Puntaje de verificación

La imagen capturada que se comparará con la plantilla para la verificación se guardará en el token «templateVerifier» de la app.

Face Image Verifier

Con esta función, se compara una plantilla ya almacenada en el dispositivo con una imagen almacenada en otro ID de la app.

Configuración del parámetro

Esta función no requiere la configuración de ningún parámetro obligatorio. Lea Registros de entrada para obtener información sobre los parámetros opcionales que puede configurar.

ID de la función

Registro

Valor

110

6

Registros de entrada

Registro

Descripción

Obligatorio

Valor

390

ID de la plantilla almacenada

Por defecto, el ID es «livenessCheck2Template».

391

ID de la imagen que se comparará con el ID de la plantilla.

Por defecto, el ID es «faceImageVerifier».

Registros de salida

Registro

Descripción

Valor

112

Resultado de la Call

000

NO_ERROR

001

API_GENERIC_ERROR

002

API_WRONG_PARAMETERS_ERROR

003

API_SDK_NOT_INITIALIZED

004

INTERRUPTED

011

TEMPLATE_INCOMPATIBLE

290

Puntaje de verificación

Document Autocapture

Esta función se usa para capturar y almacenar la imagen de un documento.

Configuración del parámetro

Esta función no requiere la configuración de ningún parámetro obligatorio. Lea Registros de entrada para obtener información sobre los parámetros opcionales que puede configurar.

ID de la función

Registro

Valor

110

7

Registros de entrada

Registro

Descripción

Obligatorio

Valor

390

ID de la imagen capturada

Por defecto, el ID es «documentAutocapture».

391

Etapa de análisis de documentos

El valor por defecto es 0.

Posibles valores:

0: Sin encabezado.

1: 1: Encabezado con una ayuda visual para capturar el anverso del documento.

2: 2: Encabezado con una ayuda visual para capturar el reverso del documento.

392

Porcentaje de compresión

Los valores van del 0 al 100; el 0 es la compresión máxima y el 100 es la ausencia de compresión. El valor por defecto es 70. El valor por defecto es 70.

Registros de salida

Registro

Descripción

Valor

112

Resultado de la Call

000

NO_ERROR

001

API_GENERIC_ERROR

002

API_WRONG_PARAMETERS_ERROR

003

API_SDK_NOT_INITIALIZED

004

INTERRUPTED

005

CAMERA_INIT_FAILED

006

CAMERA_ACCESS_FAILED

007

NO_CAMERA_PERMISSION

014

COMPRESSION_PARAMETER_NOT_IN_RANGE. Solo disponible para iOS.

Liveness Check

Mediante esta función se lleva a cabo una verificación de usuarios reales en el modo 1, donde hay un objeto en movimiento o que desaparece en pantalla.

Configuración del parámetro

Esta función no requiere la configuración de ningún parámetro obligatorio. Lea Registros de entrada para obtener información sobre los parámetros opcionales que puede configurar.

ID de la función

Registro

Valor

110

8

Registros de entrada

Registro

Descripción

Obligatorio

Valor

390

Parámetros de la verificación de usuarios reales

Parámetros en formato JSON. Por ejemplo:

{ 
   'cameraFacing':'CAMERA_FACING_FRONT',
   'cameraPreviewScaleType':'CENTER_INSIDE'
}

Nota

Para obtener más información sobre los parámetros que puede utilizar para esta función, consulte la documentación para desarrolladores de Innovatrics. Tenga en cuenta que este es un sitio de documentación de terceros.

391

Lista de ID para cada una de las imágenes capturadas del segmento.

Esta cadena contiene los ID donde se almacenan las imágenes de todos los segmentos. Los ID se separan con comas. Por defecto, los ID que se utilizan son: livenessCheck21, livenessCheck22, livenessCheck23, livenessCheck24, livenessCheck25, livenessCheck26, livenessCheck27.

392

Lista de segmentos

Esta cadena contiene una lista de segmentos que se utilizan durante la comprobación de vivacidad, separados por comas. Los posibles segmentos a utilizar son: TOP_LEFT, TOP_RIGHT, BOTTOM_LEFT y BOTTOM_RIGHT.

393

Segmentos mínimos

Valor numérico entre 4 y 7 que determina la cantidad de segmentos que deben estar disponibles después de la verificación de usuarios reales para que esta se considere válida. El número por defecto es 4, que es el valor mínimo. El número predeterminado es 4, que es el valor mínimo.

394

Porcentaje de compresión

Los valores van del 0 al 100; el 0 es la compresión máxima y el 100 es la ausencia de compresión. El valor por defecto es 70. El valor por defecto es 70.

Registros de salida

Registro

Descripción

Valor

112

Resultado de la Call

000

NO_ERROR

001

API_GENERIC_ERROR

002

API_WRONG_PARAMETERS_ERROR

003

API_SDK_NOT_INITIALIZED

004

INTERRUPTED

005

CAMERA_INIT_FAILED

006

CAMERA_ACCESS_FAILED

007

NO_CAMERA_PERMISSION

008

NO_MORE_SEGMENTS

009

EYES_NOT_DETECTED

010

FACE_TRACKING_FAILED

013

LESS_SEGMENTS_THAN_REQUIRED

014

COMPRESSION_PARAMETER_NOT_IN_RANGE. Solo disponible para iOS.

290

Puntaje de verificación de usuarios reales