Result Reference
Quick links: Overview | Building the SDK | Start Liveness Verification | UI Customization | Installation | Current Version | Requirements | Source Code | Result Reference | Release Notes | FAQ
CafFaceLivenessLiteResult – Success Event
signedResponse
Opaque JWT returned by async route. Forward it to your backend; the SDK does not return isAlive or images.
From 2.0.0, a successful capture starts an async transaction. Use signedResponse with your backend to obtain the final liveness outcome.
CafErrorType – Error Handling
Common error types returned via didFinishWithError(type:description:):
unsupportedDevice
Device does not meet minimum HW/SW requirements
cameraPermission
Camera permission not granted
networkException
Network-related error (no internet, timeout, etc.)
serverException
Server-side processing error
tokenException
Invalid or expired token
captureAlreadyActiveException
A previous capture is still active
userTimeoutException
User did not complete the capture in time
imageNotFoundException
Capture image not found
tooManyRequestsException
Rate limiting / too many requests
invalidResponseException
Invalid or malformed server response
permissionException
Generic OS permission error
libraryException
Underlying library failure
unexpectedErrorException
Unexpected internal error
unknownException
Unspecified error
cameraException
Camera hardware error
certificateException
Certificate validation failed
invalidOptionsException
Invalid SDK configuration options provided
securityException
Security violation detected (triggered when enableSecurity: true and instrumentation or hooking is detected)
CafFailureType – Failure References
Available feedback codes returned via didFinishWithFailure(type:description:signedResponse:):
unknown
Try again
✅
❌
tooMuchMovement
Keep still
✅
❌
tooBright
Move somewhere darker
✅
❌
tooDark
Move somewhere brighter
✅
❌
misalignedFace
Keep your face in the oval
✅
❌
faceTooFar
Move your face closer to the screen
✅
❌
faceTooClose
Move your face farther from the screen
✅
❌
sunglasses
Remove sunglasses
✅
❌
systemError
System Error
⚠️
✅
rejected
Transaction could not be completed
⚠️
✅
faceNotFound
Align your face in the oval and then try to keep still
⚠️
✅
obscuredFace
Make sure your whole face is visible and remove any accessories that might cover your face
✅
✅
timeout
System timeout
⚠️
✅
eyewear
Remove your eyewear
⚠️
✅
multipleFaces
Ensure only one person is visible
✅
✅
eyesClosed
Make sure your eyes are open
✅
✅
userNotFound
Transaction could not be completed
⚠️
✅
lightingIssues
Make sure your face is well lit and free from glare
⚠️
✅
framesBlurry
Align your face in the oval and then try to keep still
⚠️
✅
deviceIssue
Try a different device
⚠️
✅
motionIssue
Align your face in the oval and then try to keep still
⚠️
✅
backgroundIssue
Move to a different location with a neutral background
⚠️
✅
deviceRestart
Please restart your device and try again
⚠️
✅
processingFault
Please try again
⚠️
✅
Key: ✅ = will be returned, ❌ = will not be returned, ⚠️ = may be returned in the future
Last updated