Manejo de errores

Todo el manejo de errores del SDK de Android está centralizado en esta sección. El callback onErrorAcessoBio recibe un objeto ErrorBio con code (Int) y description (String).

Manejo del callback

Kotlin

override fun onErrorAcessoBio(error: ErrorBio) {
  when (error.code) {
    73002 -> { /* camera permission denied — redirect to app settings */ }
    73006 -> { /* running on emulator — physical device required */ }
    73100 -> { /* no internet connection */ }
    else -> { /* generic error handling */ }
  }
}

Java

@Override
public void onErrorAcessoBio(ErrorBio error) {
  switch (error.getCode()) {
    case 73002: /* camera permission denied — redirect to app settings */ break;
    case 73006: /* running on emulator — physical device required */ break;
    case 73100: /* no internet connection */ break;
    default: /* generic error handling */
  }
}

Callbacks de ciclo de vida

Además de onErrorAcessoBio, el SDK también activa:

• onUserClosedCameraManually() — el usuario cerró la cámara manualmente.
• onSystemClosedCameraTimeoutSession() — la sesión expiró por tiempo de espera.
• onSystemChangedTypeCameraTimeoutFaceInference() — no se detectó ningún rostro durante 13 segundos; el SDK cambia a captura manual.

Códigos de error

Todos los códigos de error provienen del enum UnicoException y se entregan mediante ErrorBio(code, message). El campo message contiene la cadena exacta del SDK — no la modifique ni localice.

Código	Mensaje	Descripción
73001	Context invalid	Contexto de Android no válido pasado al SDK
73002	Did not grant permission to open camera	El usuario denegó el permiso de cámara
73003	The lest API is 21(LOLLIPOP	El nivel de API del dispositivo está por debajo del mínimo requerido (API 21)
73004	Could not find implementation interface callback iAcessoBioSelfie	Interfaz iAcessoBioSelfie no implementada
73005	Could not find implementation interface callback iAcessoBioDocument	Interfaz iAcessoBioDocument no implementada
73006	Unable to open camera on emulators	El SDK no funciona en emuladores — use un dispositivo físico
73007	Unknown and unexpected error in WebApp…	Error genérico de WebApp (cámara, almacenamiento, seguridad, red)
73100	Unable to connect to internet.	Sin conexión a internet
73200	Please inform the config object or json file name	Objeto de configuración o archivo JSON no proporcionado
73202	Unable to parse json file	El archivo de configuración JSON está malformado
73204	Unable to initialize the SDK, please configure the environment on setEnviroment method of build	setEnvironment() no fue llamado antes de la inicialización
73300	Unable to get unico authentication object	Error al recuperar el objeto de autenticación
73301	Unable to parse object	Error al analizar la respuesta de autenticación
73302	Could not find the unico token	Token de autenticación de Unico no encontrado
73303	Current host is not registered	Identificador de bundle no registrado en la SDK Key
73400	Could not initialize camera	Error en la inicialización de la cámara
73701	Could not find active liveness import	Módulo de liveness activo no encontrado
73703	Unable to get active liveness session	Error al obtener una sesión de liveness
73718	The Session was cancelled because of an unknown and unexpected error…	Error interno desconocido en la sesión
73721	The Session can't be performed: attempts limit exceeded.	Sesión cancelada — límite de intentos de captura alcanzado
73722	The Session can't be performed: face alignment timeout.	Sesión cancelada — tiempo de espera de alineación facial
73726	An error happened during video recording	Error de grabación de vídeo durante el liveness
73727	No actions found in a video	No se detectaron acciones de liveness en el vídeo
73740	The user pressed the do not consent button and did not complete the Session.	El usuario rechazó el consentimiento
73800	Could not build encrypted key.	Error al construir el JWT cifrado
73801	The Session of SDK was cancelled because of an unknown and unexpected error.	Error interno desconocido en la sesión del SDK
73802	The Session was cancelled because of an unknown and unexpected error…	Sesión cancelada — campos obligatorios del JWT ausentes
73900	Erro ao analisar imagem	Error al analizar la imagen capturada
73901	É necessário implementar a interface AcessoBioListener	Interfaz AcessoBioListener no implementada
73902	É necessário insirir um valor maior que 40 segundos no método: setTimeoutSession.	El valor de setTimeoutSession debe ser mayor de 40 segundos
73903	Arquivo de configuração corrompido. Verifique o arquivo json e tente novamente.	Archivo de configuración dañado — verifique e inténtelo de nuevo
73904	Erro ao finalizar processo	Error al finalizar el proceso de captura
73905	Unable to open document camera	No se pudo abrir la cámara de documentos
73906	Document type uninformed	Tipo de documento no especificado
74001	onSuccess: not implemented when using open:webAppToken:	Callback onSuccess no implementado para User Journey
74100	Could not prepare SDK-S	Error al preparar los componentes del SDK
74101	No URL token was provided.	No se proporcionó token de URL para la jornada
74102	Environment type was not specified.	Entorno (PROD/UAT) no configurado
737120	Unable to initialize liveness	La actividad de liveness no pudo inicializarse
737220	Capture could not start	El proceso de captura no pudo iniciarse
737320	Transaction could not start	La transacción no pudo iniciarse
737321	The Session was cancelled because of an unknown and unexpected error. This return value is a catch-all for errors experienced during normal usage of these APIs. Try again.	Error genérico del proveedor de sesión — inténtelo de nuevo

Códigos de error de la REST API

Los códigos anteriores son errores de callback del SDK. Los códigos de error de la REST API (familias de estado HTTP) están documentados por separado en Referencia de API > Códigos de error.