• 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## 12500001 Authentication Failed
8
9**Error Message**
10
11Authentication failed.
12
13**Possible Causes**
14
15The credential does not match the credential enrolled.
16
17**Solution**
18
19Initiate authentication again.
20
21## 12500002 General Operation Error
22
23**Error Message**
24
25General operation error.
26
27**Possible Causes**
28
291. An error occurs when the NAPI layer parses parameters.
302. The process of the user authentication service is not started.
313. The proxy client fails to write data over IPC.
324. The stub server fails to parse data over IPC.
335. The driver service is not obtained.
34
35**Solution**
36
37Call the API again later or restart the device.
38
39## 12500003 Authentication Canceled
40
41**Error Message**
42
43Authentication canceled.
44
45**Possible Causes**
46
47The authentication operation has been canceled.
48
49**Solution**
50
51Initiate the authentication again.
52
53## 12500004 Authentication Timed Out
54
55**Error Message**
56
57Authentication timeout.
58
59**Possible Causes**
60
61The authentication is not complete within the specified time.
62
63**Solution**
64
65Initiate the authentication again.
66
67## 12500005 Unsupported Authentication Type
68
69**Error Message**
70
71The authentication type is not supported.
72
73**Possible Causes**
74
751. 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.
762. 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.
77
78**Solution**
79
80Check the authentication type parameter and call the API again.
81
82## 12500006 Unsupported Authentication Trust Level
83
84**Error Message**
85
86The authentication trust level is not supported.
87
88**Possible Causes**
89
901. The **authTrustLevel** value in **getAvailableStatus** or **getAuthInstance** of the **userAuth** module is not in the range [ATL1, ATL2, ATL3, ATL4].
912. 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.
92
93**Solution**
94
95Check that the **authTrustLevel** passed in is within the value range, and the device supports the specified authentication trust level.
96
97## 12500007 Authentication Service Unavailable
98
99**Error Message**
100
101Authentication service is busy.
102
103**Possible Causes**
104
105Another authentication is initiated when the current authentication has not been finished yet.
106
107**Solution**
108
109Initiate authentication again later.
110
111## 12500009 Authentication Locked
112
113**Error Message**
114
115Authentication is lockout.
116
117**Possible Causes**
118
119The number of authentication failures exceeds the limit.
120
121**Solution**
122
123Initiate authentication later.
124
125## 12500010 Credential Not Enrolled
126
127**Error Message**
128
129The type of credential has not been enrolled.
130
131**Possible Causes**
132
133The **authType** parameter set in **getAvailableStatus** of the **userAuth** module is **FACE**, but no facial credential is enrolled in the device.
134**start()** is called to initiate facial authentication, but no facial credential is enrolled in the device.
135
136**Solution**
137
138Check that the related type of credential has been enrolled in the device.
139
140## 12700001 Failed to Enroll Faces
141
142**Error Message**
143
144The operation is failed.
145
146**Possible Causes**
147
1481. The facial authentication service is not started when **setSurfaceId()** of the **userAuth** module is called.
1492. The proxy client fails to write data over IPC.
1503. The stub server fails to parse data over IPC.
1514. An error occurs when the facial authentication driver is invoked.
152
153**Solution**
154
155Call the API again later or restart the device.
156