Consumer Authentication

/

Mobile SDKs

/

React Native SDK reference

/

Biometrics

/

Errors

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.