This section describes only module-specific error codes. For details about universal error codes, please refer to Universal Error Codes.
Message
Invalid parameters.
Description
This error code is generated when a parameter is incorrect.
Possible causes
The input parameter is empty or in an incorrect format.
The parameter type does not match.
Mandatory parameters are left unspecified.
Solution
Check whether the input parameters are correct.
Check whether the parameter type meets the API requirements.
Ensure that all mandatory parameters are correctly set.
Message
The user does not record biometric features or the authentication module is abnormal.
Description
This error code is generated when the user has not enrolled any biometric feature or the authentication module is abnormal.
Possible causes
The user has not enrolled biometric features such as fingerprint or face.
The BioAuthn module is abnormal.
The biometric authentication service is unavailable.
Solution
Instruct the user to enroll biometric features.
Restart the device and try again.
Message
The user canceled the operation.
Description
This error code is generated when the user cancels the operation.
Possible causes
The user taps the cancel button during the authentication.
The user cancels the operation during biometric authentication.
The operation is automatically canceled due to timeout.
Solution
No special handling is required. This is an intentional user action.
If the user wants to retry, prompt the user to perform the operation again.
Message
The key alias has been used.
Description
This error code is returned when the key alias has been used.
Possible causes
The key alias has been used by another key.
The same key alias is used repeatedly.
Solution
Use a different key alias.
Delete the existing key and then use the alias.
Message
The key is invalid.
Description
This error code is returned when the key is invalid.
Possible causes
The key has expired.
The key format is incorrect.
The key has been damaged or tampered with.
Solution
Check whether the key is valid.
Generate or import a valid key.
Check whether the key format meets the requirements.
Message
The security level of the authenticator on the device is lower than ATL4.
Description
This error code is returned when the security level of the authenticator on the device is lower than ATL4.
Possible causes
The security level of the BioAuthn on the device is insufficient.
The device hardware does not support advanced security authentication.
Solution
Use a device that supports advanced security authentication.
Use another authentication method that meets the security level requirements.
Message
Unknown error.
Description
This error code is reported when an unknown error occurs.
Possible causes
Internal system error.
An unexpected exception occurs.
Solution
Message
The DID does not exist.
Description
This error code is returned when the DID does not exist.
Possible causes
The specified DID is not created or has been deleted.
The DID identifier is incorrect.
Solution
Check whether the DID exists.
Check whether the DID identifier is correct.
If you need to use the DID, create or import a DID first. For details, please refer to [Enabling the Digital Identity].
Message
Failed to decrypt the credential.
Description
This error code is returned when a credential fails to be decrypted.
Possible causes
The decryption key is incorrect.
The credential data is damaged.
The encryption algorithm does not match.
Solution
Check whether the decryption key is correct.
Check the integrity of the credential data.
Use the correct encryption algorithm.
Message
The credential does not exist.
Description
This error code is returned when the credential does not exist.
Possible causes
The specified credential has not been imported or has been deleted.
The credential ID is incorrect.
Solution
Check whether the credential exists.
Check whether the credential ID is correct.
If you need to use it, create or import a DID first. For details, see [Enabling the Digital Identity].
Message
The application does not have permission to perform this operation.
Description
This error code is returned when an application that is not the DID or credential owner attempts to perform an operation without permission.
Possible causes
Solution
Message
The number of did keys has reached the maximum limit.
Description
This error code is returned when the number of DID keys reaches the upper limit (500).
Possible causes
The number of DID keys stored on the device exceeds the upper limit.
The number of DID keys reaches the upper limit when you attempt to create a new DID key.
Solution
Delete unnecessary DID keys.
Use existing DID keys.
Message
The number of DIDs has reached the maximum limit.
Description
This error code is returned when the number of DIDs reaches the upper limit (50).
Possible causes
The number of DIDs stored on the device exceeds the upper limit.
The number of DIDs reaches the upper limit when you attempt to create a new DID.
Solution
Delete unnecessary DIDs.
Use existing DIDs.
Message
The number of credentials has reached the maximum limit.
Description
This error code is generated when the number of credentials reaches the upper limit (1000).
Possible causes
The number of credentials stored on the device exceeds the upper limit.
The number of credentials to be imported has reached the upper limit.
Solution
Delete unnecessary credentials.
Use existing credentials.