Skip to main content

Veritran Docs

Authenticate-3D

This function authenticates a user against a previous enrollment. The externalDatabaseRefID is used as a unique identifier (the citizenship ID for example) to search for a previous enrollment with which to compare.

Note

It's required to initialize the SDK (Initialize function) to be able to use the rest of the FaceTec functions.

Parameter Configuration

This function allows you to configure input values as described in the Input Registers table. The externalDatabaseRefID input value is required; without it, the function will have no one to compare the user with and will return an error.

Function ID

Register

Value

110

2

Input Registers

Register

Description

Mandatory

Value

390

externalDatabaseRefID: Unique Identifier, compare current user FaceMap with the FaceMap stored with the externalDatabaseRefID identifier. The function will fail if no value is configured.

Yes

[Unique identifier]

394

Output Image ID. Register ID where the user image will be saved. If not set, the image won't be saved.

No

[Image ID]

Output Registers

Register

Description

Value

112

Call Result

000

API_NO_ERROR

001

API_WRONG_PARAMETERS_ERROR

010

API_GENERIC_ERROR

020

ERR_CUSTOM_API_NOT_IMPLEMENTED

021

ERR_CUSTOM_API_WRONG_OUTPUT_PARAMETERS

100

ERR_INVALID_MODE

101

ERR_STATUS_NOT_OS_SUPPORTED

102

ERR_STATUS_NO_FRONT_CAMERA

106

ERR_STATUS_PERMISSION_NOT_ALLOWED

109

ERROR_SESSION_TOKEN

112

ERROR_EXIT_REASON_ABORTED

115

ERROR_EXIT_REASON_GENERIC_ERROR

120

ERROR_CANT_GET_FACE_IMAGE

307

ERROR_SDK_STATUS_LICENSE_EXPIRED_OR_INVALID

308

ERROR_SDK_STATUS_ENCRYPTION_KEY_INVALID

311

ERROR_SDK_NOT_INITIALIZED

313

ERROR_NO_EXTERNAL_DATABASE

314

ERROR_NOT_FOUND_EXTERNAL_DATABASE_REFID

290

SessionID

ID for this enrollment

291

ImageBase64

AuditTrailImage in base64

292

externalDatabaseRefID

externalDatabaseRefID used in the session