Autenticación + Prueba de vida

/v2/identity

Este servicio realiza tanto la validación de la prueba de vivacidad (liveness test) como la validación facial entre dos rostros, ya sean imágenes abiertas o parámetros tokenizados.

Este servicio se adapta a dos tipos de validaciones faciales, dependiendo del widget integrado:

Precaución

• Método 3 WEB: autenticación facial entre una imagen abierta y bestImageToken.

• Método 5 MÓVIL: autenticación facial entre tokenFaceImage y bestImageToken.

Integración Para el tipo de validación 3, se requiere una imagen en formato abierto del frente de la identificación (documento de identidad), donde se encuentra el rostro.

Para el tipo de validación 5, es necesario implementar el widget SelphID Mobile para generar la propiedad TokenFaceImage.

Solicitud (Request):

bash

curl --location '{IDENTITY_API_BASE_URL}/onboarding/v2/identity' \
--header 'x-api-key: {API_KEY}' \
--header 'Content-Type: application/json' \
--data '{
    "token1": "/9j/4AAQSkZJRgABAQAASAB....",
    "bestImageToken": "BAMBAQLNHJoWGPj...",
    "method": "3",
    "tracking": {
        "extraData": "BQABAQG2gBNjuHN...",
        "operationId": "xxxxx-xxxxx-xxxxx-xxxxx-xxxxx"
    }
}'

Parámetros de la solicitud:

Parámetro	Tipo (Contenido)	Obligatorio	Descripción
token1	String (Base64)	Sí	Imagen utilizada como referencia para la comparación facial. Puede ser una imagen en base64 o TokenFaceImage, dependiendo del método.
bestImageToken	String (Base64)	Sí	Propiedad bestImage tokenizada, generada por el widget Selphi y tokenizada utilizando la función nativa.
method	String	Sí	Indica el método de comparación invocado según la siguiente especificación: - Método = “3” - Autenticación facial usando una imagen abierta y bestImage tokenizado (Base64 & bestImageToken) - Método = “5” - Autenticación facial usando el token generado por el recorte de la foto del documento y bestImage tokenizado (tokenFaceImage & bestImageToken)
tracking	Objeto JSON	No	Objeto que representa la información de seguimiento necesaria.
extraData	String (Base64)	No	Token generado por el SDK Mobile/Web. Contiene información de seguimiento tokenizada.
operationId	String (Base64)	No	Identificador de operación generado por el SDK Mobile/Web.

Ejemplo de respuesta (Response):

json

{
    "serviceTransactionId": "2db602ee-3564-4304-af95-92a52eaae12d",
    "serviceResultCode": 0,
    "serviceResultLog": "[identity] Service executed ok",
    "serviceTime": "2235",
    "facialAuthenticationResult": 3,
    "facialAuthenticationLog": "Positive",
    "facialAuthenticationSimilarity": 0.99214232,
    "passiveLivenessResult": 3,
    "passiveLivenessLog": "Live"
}

Campos de la respuesta:

Identificador	Tipo	Descripción
serviceTransactionId	String	Identificador de transacción asociado a la solicitud a la API.
serviceResultCode	Integer	Código que indica el resultado general de la ejecución del servicio.
serviceResultLog	String	Campo descriptivo del resultado de la ejecución del servicio. Proporciona detalles de errores o excepciones cuando estos ocurren.
serviceTime	String	Campo que indica el tiempo de procesamiento (milisegundos).
facialAuthenticationResult	Integer	Código que indica el resultado de la coincidencia facial (matching).
facialAuthenticationLog	String	Campo descriptivo del resultado de la coincidencia facial.
facialAuthenticationSimilarity	Float	Valor que indica la similitud facial entre la foto del documento y el selfie tomado por el usuario. 1.0 = 100%
passiveLivenessResult	Integer	Código que indica el resultado de la prueba de vivacidad pasiva (passive liveness test).
passiveLivenessLog	String	Campo descriptivo del resultado de la prueba de vivacidad pasiva.

---