GCL Status codes

HTTP Status Codes

T1C-GCL uses the following HTTP response codes when handling a request.

Code Description Info
200 Success The request was successful
400 Bad Request The request input contains errors (e.g. wrong json)
412 Precondition Failed An application error occurred while handling the request (e.g. pin blocked)

In case of an error (400 or 412) the response will contain a body with more detailed information about the error:

{
  success: false,
  description: "some error description",
  code: "some error code"
}

All possible values of the codes are described below in "Application Status Codes"
The description field contains more information and a stack trace from the exception.

Application Status Codes

Code Description
0 Card reader error
1 No reader found
2 Card reader is not a Belfius reader
Code Description
100 Card error
101 Card not present
102 Wrong card (not an eID)
103 Wrong pin, 2 tries remaining
104 Wrong pin, 1 try remaining
105 Pin blocked
106 Invalid Pin
107 Verify Pin not supported on reader
108 Application locked
109 Verify Pin cancelled
110 Verify Pin timed out
111 Wrong pin, 4 tries remaining
112 Wrong pin, 3 tries remaining
113 PUK blocked

JWT Security errors

Code Description
200 JWT token is malformed
201 No valid certificate available
202 JWT token algorithm is not supported
203 JWT token has an incorrect signature
204 JWT token UID is incorrect
205 JWT token is expired

Library errors

Code Description
300 Failed to load the library

Session errors

Code Description
400 Session error
401 No active session
402 Invalid session id

Agent errors

Code Description
500 Agent error
501 Unknown agent

Input errors

Code Description
800 Invalid json
801 Invalid arguments
802 Invalid HTTP request
803 X-Authentication-Token header missing
804 Invalid X-Authentication-Token header

General errors

Code Description
900 Internal error
901 Invalid configuration
902 Invalid container configuration

T1C-JLIB Status codes

Code Description
1000 Initialization error
Code Description
2000 General error
2001 GCL REST error
2002 GCL Admin REST error
2003 DS REST error
2004 Generic container REST error
2005 Aventra container REST error
2006 LuxID container REST error
2007 LuxTrust container REST error
2008 DNIE container REST error
2009 Portuguese ID container REST error
2010 EMV container REST error
2011 MOBIB container REST error
2012 OCRA container REST error
2013 SafeNet container REST error
2014 OCV REST error
2015 Remote Loading container REST error
2016 PIV container REST error
Code Description
3000 PIN verification error
3001 Container unavailable error
Code Description
4000 Authentication error
5000 Signing error
Code Description
6000 Core error
Code Description
7000 Certificate ordering error

results matching ""

    No results matching ""