Error Codes
In this section, you'll find the common errors that may occur during the development and operation of your application. This covers both the error from the SDK and the VIDA backend.
SDK Errors
40001
Unable to proceed please check your connection
40002
Unable to proceed due to network timeout, please check your connection or <Empty message in some cases>
YES
40003
Unable to proceed, ensure that the authorization method is correct
YES
40004
Unable to proceed due to unknown network, please reconnect again
YES
40005
Unable to proceed, please check your internet connection
YES
40006
Unable to proceed, please check your internet connection or <actual error message >
YES
40007
Unable to proceed please check your connection
YES
50001
Received a null response from the server
50002
Internal server error
YES
50003
Something went wrong, please try again later
50004
Invalid parameters %1$s
50005
Something went wrong, please try again later
50007
Something went wrong, please try again later
50008
Something went wrong, please try again later
50009
Unable to parse the information
50010
Something went wrong, please try again later
50012
Liveness detection is in progress
50013
License key not found
50014
Something went wrong, please try again later
50017
Internal Server Error
50018
Something went wrong, please try again later
50019
Liveness SDK is not initialized. Initialize it first
50020
Liveness check is not configured, please check with support team
50021
Landscape orientation not supported.
Please rotate in portrait orientation.
50022
Liveness image upload failed color flash flow
50023
Back camera not supported for the selected configuration (color flash flow)
60001
Crypto error. Unable to encrypt request
60002
Crypto error. Unable to decrypt response
60003
Unknown error while generating hash
60004
Unknown error while encrypting the data
60005
Unknown error while fetching store key
60006
Device Id not found in the keychain
60007
Device ID could not be decrypted. Device ID or Keychain might be tampered.
70001
Unable to proceed, the functionality will not work without Camera permissions
70002
Face detection failed with error : %1$s
70003
Failed to get image result
70004
Liveness detection is canceled
70005
Retrying liveness detection activity
70006
Image capture process has failed
70007
Detection timed out
70008
User canceled liveness process by clicking back button
70009
Camera start process is failed
70010
Maximum attempt to retry liveness has exhausted
70011
You cannot use the zoomFace gesture with other gestures. Please refer to documentation for more details
70012
Liveness detection failed
70013
Please make sure to add ID Fraud shield SDK dependency
70013
ID fraud shield clientID is missing, please check with support team
70014
Liveness detection interrupted
VIDA Backend Error
1000
Something went wrong!
1039
Liveness service error
1041
Liveness check failed
YES
1047
Unable to detect face from selfie image
1057
Something went wrong!
1058
Please ensure the shot is well-lit and clear
YES
1060
Keep your face straight
YES
1062
Please ensure to open your eyes
YES
1074
The selfie is too dark, ensure the photo is well-lit and clear
YES
1075
The selfie is too bright, ensure the photo is well-lit and clear
YES
Color Flash Error
1801
Passive liveness evaluation failed
Passive liveness failed
1802
Image manipulation evaluation failed
Image manipulation failed
1803
Color captcha evaluation failed
Color captcha failed
1804
Multiple model failures
Multi Model Failure
1805
All model evaluations failed
Complete model failure
1806
Face Color Issue
Face has no color reflection
YES
1807
Upstream Service Error
The request to the document service failed.
1808
Upstream Service Error
Received an empty or invalid response from the document service.
1809
Not Found
Captcha payload not found for the given transactionId. The session may have expired.
1810
Upstream Service Error
The document service returned fewer pre-signed URLs than requested.
1811
Encryption Failed
Failed to encrypt/decrypt payload.
1812
Color Palette Size Issue
Color Palette Size Issue
Invalid Request or Image Error
1064
JSON invalid
Invalid JSON input
1065
Image path invalid
Invalid image path
1066
HMAC key missing
Image quality low
1067
HMAC key invalid format
HMAC key format is invalid
1068
HMAC key invalid length
HMAC key length is invalid
1069
HMAC not present in EXIF
HMAC signature missing in EXIF metadata
1070
HMAC signature mismatch
HMAC signature validation failed
1071
HMAC verification error
Error verifying HMAC signature
1072
S3 role resolution failed
Unable to resolve AWS role for S3 access
1073
S3 region resolution failed
Unable to resolve AWS region for S3
1081
S3 role assume denied
AssumeRole denied for S3 access
1082
S3 access denied
Access denied by S3
1083
S3 no such key
S3 object key not found
1084
S3 read failed
Failed to read object from S3
1085
Input encoding failed
Failed to encode input
1087
Internal error
Unexpected internal error occurred
4004
HMAC signature does not match
HMAC verification failed
1006
Missing required parameter
Validation Failed
1007
Bad Request
The request body is malformed or contains invalid data types.
1008
Remote Service Error
A downstream service is unavailable or returned an unhandled error.
1056
No Image Detected
JPEG decoding error
1041
message: Smart liveness score is below threshold
Image Quality Error
1086
Face IQA error
Face Image Quality Assessment error
1051
Detect Un-standardized Image Quality
Face Occluded
1052
Detect Un-standardized Image Quality
Face too small
1053
Detect Un-standardized Image Quality
Image quality low
1054
Detect Un-standardized Image Quality
More than one face
1055
Detect Un-standardized Image Quality
No face detected
1074
Image Quality Is Below Threshold
Under Exposure
1075
Image Quality Is Below Threshold
Over Exposure
1063
Image Quality Is Below Threshold
Unnatural colour
1076
Image Quality Is Below Threshold
Image Is Blur
Last updated