• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1#  User Authentication Error Codes
2
3> **NOTE**
4>
5> This topic describes only module-specific error codes. For details about universal error codes, see [Universal Error Codes](errorcode-universal.md).
6
7## 201 Permission Verification Failed
8
9For details, see [Universal Error Codes](./errorcode-universal.md).
10
11## 202 Invoker Is Not a System Application
12
13For details, see [Universal Error Codes](./errorcode-universal.md).
14
15## 401 Parameter Check Failed.
16
17For details, see [Universal Error Codes](./errorcode-universal.md).
18
19## 12500001 Authentication Failed
20
21**Error Message**
22
23Authentication failed.
24
25**Possible Causes**
26
27The credential does not match the credential enrolled.
28
29**Solution**
30
31Initiate authentication again.
32
33## 12500002 General Operation Error
34
35**Error Message**
36
37General operation error.
38
39**Possible Causes**
40
411. An error occurs when the NAPI layer parses parameters.
422. The process of the user authentication service is not started.
433. The proxy client fails to write data over IPC.
444. The stub server fails to parse data over IPC.
455. The driver service is not obtained.
46
47**Solution**
48
49Call the API again later or restart the device.
50
51## 12500003 Authentication Canceled
52
53**Error Message**
54
55Authentication canceled.
56
57**Possible Causes**
58
59The authentication operation has been canceled.
60
61**Solution**
62
63Initiate the authentication again.
64
65## 12500004 Authentication Timed Out
66
67**Error Message**
68
69Authentication timeout.
70
71**Possible Causes**
72
73The authentication is not complete within the specified time.
74
75**Solution**
76
77Initiate the authentication again.
78
79## 12500005 Unsupported Authentication Type
80
81**Error Message**
82
83The authentication type is not supported.
84
85**Possible Causes**
86
871. The input authentication type parameter is not supported. For example, if the authentication type passed in **getAvailableStatus** of the **userAuth** module is not **FACE** or **FINGERPRINT**, error code 12500005 is returned.
882. The device does not support the authentication type. For example, if fingerprint authentication is initiated on a device that has no fingerprint sensor, error code 12500005 is returned.
89
90**Solution**
91
92Check the authentication type parameter and call the API again.
93
94## 12500006 Unsupported Authentication Trust Level
95
96**Error Message**
97
98The authentication trust level is not supported.
99
100**Possible Causes**
101
1021. The **authTrustLevel** value in **getAvailableStatus** or **getAuthInstance** of the **userAuth** module is not in the range [ATL1, ATL2, ATL3, ATL4].
1032. The device does not support the authentication trust level. For example, if facial authentication for payment is initiated on a device that has only 2D cameras, error code 12500006 is returned.
104
105**Solution**
106
107Check that the **authTrustLevel** passed in is within the value range, and the device supports the specified authentication trust level.
108
109## 12500007 Authentication Service Unavailable
110
111**Error Message**
112
113Authentication service is busy.
114
115**Possible Causes**
116
117Another authentication is initiated when the current authentication has not been finished yet.
118
119**Solution**
120
121Initiate authentication again later.
122
123## 12500009 Authentication Locked
124
125**Error Message**
126
127Authentication is lockout.
128
129**Possible Causes**
130
131The number of authentication failures exceeds the limit.
132
133**Solution**
134
135Initiate authentication later.
136
137## 12500010 Credential Not Enrolled
138
139**Error Message**
140
141The type of credential has not been enrolled.
142
143**Possible Causes**
144
145The **authType** parameter set in **getAvailableStatus** of the **userAuth** module is **FACE**, but no facial credential is enrolled in the device.
146**start()** is called to initiate facial authentication, but no facial credential is enrolled in the device.
147
148**Solution**
149
150Check that the related type of credential has been enrolled in the device.
151
152## 12700001 Failed to Enroll Faces
153
154**Error Message**
155
156The operation is failed.
157
158**Possible Causes**
159
1601. The facial authentication service is not started when **setSurfaceId()** of the **userAuth** module is called.
1612. The proxy client fails to write data over IPC.
1623. The stub server fails to parse data over IPC.
1634. An error occurs when the facial authentication driver is invoked.
164
165**Solution**
166
167Call the API again later or restart the device.
168