Códigos de error del backend

Los siguientes códigos de error del servidor pueden ocurrir durante las llamadas a la API entre el SDK de Thales y el backend de Thales.

Android

Código de error	Caso de uso	Recomendación
SERVER_IS_NOT_ACCESSIBLE	Este error se devuelve cuando el SDK no puede alcanzar el backend de Thales debido a un problema de conexión de red.	Mostrar el mensaje de error al usuario final. Indicar al usuario final que verifique su conexión a Internet.
SERVER_ERROR_CRYPTO_ERROR	Este error se devuelve cuando hay un problema con el almacén de claves.	Mostrar el mensaje de error al usuario final.
SERVER_ERROR_INVALID_TOKEN_STATE	Este error se devuelve cuando el estado del token no es válido.	Mostrar el mensaje de error al usuario final.
SERVER_ERROR_IDV_NOT_AVAILABLE	Este error se devuelve cuando el usuario final selecciona un método de ID&V que no está disponible.	El backend de Thales devuelve un error cuando el SDK envía un POST /idv-method o POST /otp request. The SDK returns this error code to the merchant application via the TokenBindingListener.onIssuerAuthenticationError() callback. Usa IDVSession.getIdvMethods() para obtener la lista de métodos de ID&V que se pueden usar para autenticar al usuario final. Si la sesión permanece activa, la aplicación del comerciante puede seleccionar otro método de ID&V usando IDVSession.selectIdvMethod().
SERVER_ERROR_NO_SESSION_FOUND	Este error se devuelve cuando no se puede encontrar la sesión.	El backend de Thales devuelve un error cuando el SDK envía un POST /idv-method o POST /otp request. The SDK returns this error code to the merchant application via the TokenBindingListener.onError() callback. Llamar VisaCTFHelper.createBinding() nuevamente para crear una nueva sesión antes de que el usuario final seleccione un método de ID&V o verifique el OTP.
SERVER_ERROR_WRONG_OTP_VALUE	Este error se devuelve cuando el usuario final ingresa un OTP incorrecto.	El backend de Thales devuelve un error cuando el SDK envía un POST /otp request. The SDK returns this error code to the merchant application via the TokenBindingListener.onIssuerAuthenticationError() callback. La sesión permanece activa y la aplicación del comerciante puede reintentar o seleccionar otro método de ID&V usando el IDVSession objeto.
SERVER_ERROR_EXPIRED_OTP	Este error se devuelve cuando el usuario final ingresa un OTP caducado.	El backend de Thales devuelve un error cuando el SDK envía un POST /otp request. El SDK devuelve este código de error a la aplicación del comerciante a través del TokenBindingListener.onIssuerAuthenticationError() callback. La sesión permanece activa y la aplicación del comerciante puede reintentar o seleccionar otro método de ID&V usando el IDVSession objeto.
SERVER_ERROR_RETRY_LIMIT_EXCEEDED	Este error se devuelve cuando el usuario final excede el número de reintentos permitidos.	El backend de Thales devuelve un error cuando el SDK envía un POST /otp request. The SDK returns this error code to the merchant application via the TokenBindingListener.onIssuerAuthenticationError() callback. La sesión permanece activa y la aplicación del comerciante puede reintentar o seleccionar otro método de ID&V usando el IDVSession objeto.
SERVER_ERROR_TOO_MANY_REQUEST	Este error se devuelve cuando se envían demasiadas solicitudes en un período de tiempo determinado.	Mostrar el mensaje de error al usuario final.
SERVER_ERROR_RETRYABLE	Este error se devuelve cuando el servidor no puede manejar la solicitud debido a una sobrecarga temporal o mantenimiento.	Mostrar el mensaje de error al usuario final. Reintentar la solicitud.
SERVER_ERROR	Este error se devuelve cuando ocurre un error del servidor y no encaja en ninguno de los códigos de error anteriores.	Mostrar el mensaje de error al usuario final.

iOS

Código de error	Caso de uso	Recomendación
TMGError.serverIsNotAccessible	Este error se devuelve cuando el SDK no puede alcanzar el backend de Thales debido a un problema de conexión de red.	Mostrar el mensaje de error al usuario final. Indicar al usuario final que verifique su conexión a Internet.
TMGError.serverErrorCryptoError	Este error se devuelve cuando hay un problema con el almacén de claves.	Mostrar el mensaje de error al usuario final.
TMGError.serverErrorInvalidTokenState	Este error se devuelve cuando el estado del token no es válido.	Mostrar el mensaje de error al usuario final.
TMGError.serverErrorIdvNotAvailable	Este error se devuelve cuando el usuario final selecciona un método de ID&V que no está disponible.	El backend de Thales devuelve un error cuando el SDK envía un POST /idv-method o POST /otp request. The SDK returns this error code to the merchant application via the completion handler. Usa PendingBindingSession.getIdvMethods() para obtener la lista de métodos de ID&V que se pueden usar para autenticar al usuario final. Si la sesión permanece activa, la aplicación del comerciante puede seleccionar otro método de ID&V usando PendingBindingSession.select().
TMGError.serverErrorNoSessionFound	Este error se devuelve cuando no se puede encontrar la sesión.	El backend de Thales devuelve un error cuando el SDK envía un POST /idv-method o POST /otp request. The SDK returns this error code to the merchant application via the completion handler. Llamar VisaCTFHelper.createBinding() nuevamente para crear una nueva sesión antes de que el usuario final seleccione un método de ID&V o verifique el OTP.
TMGError.serverErrorWrongOTP	Este error se devuelve cuando el usuario final ingresa un OTP incorrecto.	El backend de Thales devuelve un error cuando el SDK envía un POST /otp request. The SDK returns this error code to the merchant application via the completion handler. La sesión permanece activa y la aplicación del comerciante puede reintentar o seleccionar otro método de ID&V usando el PendingBindingSession objeto.
TMGError.serverErrorExpiredOTP	Este error se devuelve cuando el usuario final ingresa un OTP caducado.	El backend de Thales devuelve un error cuando el SDK envía un POST /otp request. El SDK devuelve este código de error a la aplicación del comerciante a través del manejador de finalización. La sesión permanece activa y la aplicación del comerciante puede reintentar o seleccionar otro método de ID&V usando el PendingBindingSession objeto.
TMGError.serverErrorRetryLimitExceeded	Este error se devuelve cuando el usuario final excede el número de reintentos permitidos.	El backend de Thales devuelve un error cuando el SDK envía un POST /otp request. The SDK returns this error code to the merchant application via the completion handler. La sesión permanece activa y la aplicación del comerciante puede reintentar o seleccionar otro método de ID&V usando el PendingBindingSession objeto.
TMGError.serverErrorTooManyRequest	Este error se devuelve cuando se envían demasiadas solicitudes en un período de tiempo determinado.	Mostrar el mensaje de error al usuario final.
TMGError.serverRetryable	Este error se devuelve cuando el servidor no puede manejar la solicitud debido a una sobrecarga temporal o mantenimiento.	Mostrar el mensaje de error al usuario final. Reintentar la solicitud.
TMGError.serverError(let httpStatusCode, let additionalMessage)	Este error se devuelve cuando ocurre un error del servidor y no encaja en ninguno de los códigos de error anteriores. El httpStatusCode y additionalMessage proporcionan más detalles sobre el error.	Mostrar el mensaje de error al usuario final.