Error handling for Documents API and Identity API

This is a list of error codes that we recommend to manage. When responding to these errors, an error message should be sent to a user according to the error code to improve user experience in case of failure.

These error codes are relevant for both identification and document signing.

Mobile-ID error codes

1. Error code 6001 

{ 
"status": "error", 
"message": "User does not have a mobile signature.", 
"error_code": 6001 
}

2. Error code 6005 

{ 
"status": "error", 
"message": "Signing session expired.", 
"error_code": 6005 
}

3. Error code 7023 

{ 
"status": "error", 
"message": "Signing canceled by user.", 
"error_code": 7023 
}

Smart-ID error codes 

4. Error code 6005 

{ 
"status": "error", 
"message": "Signing session expired.", 
"error_code": 6005 
}

5. Error code 6006 

{ 
"status": "error", 
"message": "User does not have Smart-ID account.", 
"error_code": 6006 
}

6. Error code 6007 (occurs when user has Smart-ID Basic account and is not allowed to sign documents with it):  

{ 
"status": "error", 
"message": "User can not use Smart-ID account.", 
"error_code": 6007 
}

7. Error code 6008 

{ 
"status": "error", 
"message": "User should view Smart-ID app or self-service portal", 
"error_code": 6008 
}

8. Error code 7023 

{ 
"status": "error", 
"message": "Signing canceled by user.", 
"error_code": 7023 
}

In all other cases, it is enough to display a message that there was an error and suggest to try again. And if the error persists - contact your support.

Should you need the complete list of Dokobit API error list, you can find it here.