Skip to main content

​
Errors

​
biometrics_sensor_error

There was an error with the biometric sensor on the device. This usually means that the biometric sensor is currently unavailable for use.

​
device_credentials_not_allowed

This means that allowDeviceCredentials was set to false in register(), but allowDeviceCredentials was set to true in authenticate(). Consider changing these parameters to be the same.

​
device_hardware_error

The device’s hardware does not support biometrics. This might be because the hardware is unavailable for use, or there is a security vulnerability with the hardware.

​
internal_error

An internal error has occurred. Please contact Stytch if this occurs.

​
key_invalidated

The biometrics enrollment on the device has changed, so biometric authentication cannot use the current registration. Try deleting the registration and authenticating again.

​
keystore_unavailable

The Android keystore is unavailable on the device. Learn more about the Android Keystore here.

​
no_biometrics_enrolled

No biometric factor is enrolled on the device. Consider encouraging the user to enroll in biometrics on their device.

​
no_biometrics_registration

No valid biometrics registration exists on the device. Please use the register method to create a new biometric registration.

​
session_expired

There is currently no valid session token. Consider encouraging the user to log in.

​
user_cancellation

The user canceled the biometric prompt. Consider providing other methods of authentication, and a way for the user to return to the biometric prompt.

​
user_locked_out

The user has been locked out from authentication using biometrics due to too many failed attempts. Consider providing other methods of authentication.