Error Codes

This page list out all the error codes, which app may encounter while performing credential exchange.

Consolidated Error Code List

This section defines the standardised error codes across all face authentication and capture flows.

✅ 0–99: Success & Match Status

Code	Message
000	Image capture or match performed successfully
001	Face match failed

🔍 100–199: Request Validation / Input Errors

Code	Message
100	Invalid request input (PidOptions/XML). Should strictly adhere to spec
101	txn not present
102	Duplicate transaction ID
103	Please install the correct app
110	Signed profile document has expired. Please refresh your profile to perform face authentication
111	Invalid AUA Code
112	Invalid subAUA Code
113	Invalid intent Code
114	Invalid langauge Code
150	Invalid hint. No matching profile available
160	Invalid value for timeout
161	Time expired request
190	Invalid value for pidFormat
191	Unable to interpret the QR Code
192	Unauthorised callback domain (reserved)
193	Invalid issuer of the JWT. Please check iss value
194	Duplicate face capture request
195	Invalid app id
196	Verification failed. Invalid app signature
197	Invalid audience of the JWT. Please check aud value

📦 200–299: Protocol / Format Handling

Code	Message
200	Invalid Demo structure (Reserved)
210	Protobuf format not supported

📸 730–739: Capture Flow Errors

Code	Message
730	Capture failed. Please improve lighting
731	User abort
732	Capture failed. Please move to better lighting
733	Capture failed. Please improve lighting and hold still
734	Capture failed. Please check background
736	Capture failed. Please blink during capture
738	Capture failed. Please focus towards the camera

📱 800–859: Credential Share Errors

Code	Message
801	Invalid Credential request
802	Unauthorised claim request
803	Invalid claim request

📱 850–899: Application Environment / Policy Enforcement

Code	Message
850	Unsupported application version. Please upgrade
860	Application seems to be corrupted. Please reinstall
861	Please lock your bootloader
862	Please restore to factory ROM
863	Please lock your bootloader and restore to factory ROM
864	Please retry after {n} hrs
870–879	Application not allowed on this device – {xxx}
880	Application not allowed. Please upgrade Google Play Services
881	Unsupported Android version. Please upgrade
890	Application blocked due to low resources
891	Not supported below Android 8
892	USB Debugging enabled — application blocked

⚙️ 900–909: Runtime and Network Issues

Code	Message
901	Resource out of memory
902	Device not connected to internet
903	Failed to connect to server (Timed out)
904	Failed due to network-related issues
905	Callback failed. HTTP {status}. {reason}. Please check with verifier app/portal administrator

🖼️ 9700–9999: Device/SDK Capture Failures

Code Range	Message
9601 to 9699	“Error in performing Online FaceAuth - {AUTH API 2.5 Error Codes}"
9701 to 9799	“Failed to capture image - {xxxx}"
9801 to 9899	“Failed to capture image - {xxxx}"
9901 to 9999	“Failed to capture image - {xxxx}"

🔖 Notes