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"
Indicates that the user's device is not connected to the internet.
40002
"Unable to proceed due to network timeout, please check your connection"
Indicates that the network request timed out, possibly due to a slow or unstable internet connection.
40003
"Unable to proceed, ensure authorization method is correct and token is not expired"
Indicates that the provided authorization token is invalid or has expired.
50005
"Unknown error occurred, please try again later"
A general error indicating an unknown issue that requires further investigation.
50006
"Unknown error occurred during color flash image upload, please try again later"
The system encountered an unknown error while uploading the color flash image during the liveness process. This may be caused by a temporary network or system issue.
60003
"Unknown error while generating hash"
Indicates an issue occurred while generating a hash, typically during a secure operation.
70001
"Unable to proceed, the functionality will not work without Camera permissions"
Indicates that the SDK does not have the required camera permissions to proceed.
70002
"Unable to proceed, failed to download face landmark models"
Indicates a failure in downloading the required face landmark models, possibly due to network issues.
70003
"Unable to proceed, browser or device doesn't support this functionality"
Indicates that the user's browser or device does not meet the technical requirements to run the SDK.
70004
"Unable to proceed, failed to process video frames"
Indicates that the video frames could not be processed, possibly due to hardware limitations or other issues.
70005
"Unable to proceed, No camera device found"
Indicates that no camera device is detected on the user's system.
70006
"Image capture process has failed"
Indicates that the process to capture an image from the camera has failed.
70007
"Detection timed out"
Indicates that the liveness detection process timed out before completion.
70008
"User cancelled liveness process by closing the modal"
Indicates that the user canceled the liveness detection process by closing the modal dialog.
70009
"Camera start process is failed"
Indicates that the process to start the camera has failed.
70010
"Maximum attempt to retry liveness has exhausted, Try again later"
Indicates that the user has exceeded the maximum number of retry attempts for the liveness process.
VIDA Backend Error
1000
Something went wrong!
1039
Liveness service error
1041
Liveness check failed
YES
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