Identity Verification response codes
Beta

Last updated: June 26, 2024

The response payload for your Identity Verification request will contain the status of your request. The payload will also contain response codes and summary if the status is one of the following:

retry_required
declined
refused
approved

Sample webhook payload


1{
2  "response-codes": [
3    {
4      "code": 61310,
5      "summary": "document_front_not_captured"
6    },
7    {
8      "code": 62102,
9      "summary": "document_not_accepted"
10    }
11  ]
12}

We ensure backward compatibility when adding new response codes. However, we encourage building your business rules based on the status value and using the response codes as additional information.

Status	Code	Summary	Description
`approved`	`10000`	`approved`	Identity verification approved
`refused`	`63001`	`applicant_refusal`	User explicitly refused to do the verification process by clicking the dedicated button
User engagement issue
`retry_required`
	`61101`	`applicant_never_started`	User was probably not redirected to the application and did not start the flow
	`61111`	`applicant_not_ready`	User explicitly stated that they wanted to perform the identity verification later by clicking the dedicated button
	`61112`	`applicant_no_document`	User explicitly stated that they did not have their document with them by clicking on the dedicated button
	`61113`	`camera_access_refused`	User did not give access to the camera despite the dedicated instructions to do so
	`61121`	`applicant_drop`	User left the process before the capture phase and the verification URL expired (by default the expiration time is 15 minutes)
Technical issue
`retry_required`	`61201`	`connexion_insufficient`	User's connection was insufficient to perform the capture
	`61202`	`browser_not_supported`	User's browser was not suitable for video streaming
	`61203`	`camera_not_found`	User's device did not have any camera
	`61204`	`focus_lost`	User switched tabs or applications while performing the identity verification
	`61205`	`sms_not_received`	User did not receive the SMS
Document capture issue
`retry_required`	`61301`	`document_video_blurry`	User's document video is too blurry (Mostly due to too much movement but if this error persists, the camera quality may be an issue)
	`61302`	`document_video_lighting_issue`	User performed the document capture under poor lighting conditions
	`61310`	`document_front_not_captured`	User has not captured the front of the document
	`61311`	`document_back_not_captured`	User has not captured the back of the document
	`61312`	`document_partially_hidden`	Part of the document is hidden in the capture
	`61313`	`document_not_tilted`	User did not present a dynamic view of the document
	`61315`	`document_barcode_unreadable`	Barcode of the document is not readable
Face capture issue
`retry_required`	`61401`	`face_video_blurry`	User's video of their face is too blurry (Mostly due to too much movement but if this error persists, the camera quality may be an issue)
	`61402`	`face_video_lighting_issue`	User performed their identity verification under poor lighting conditions
	`61410`	`face_not_captured`	User has not presented a face
	`61411`	`face_partially_hidden`	User did not show the full front view of their face
	`61412`	`face_not_turned`	User did not sufficiently move to prove liveness
	`61414`	`various_faces_detected`	User also captured another person face
Internal error
`retry_required`	`61901`	`internal error`	An internal error prevents us from completing the verification - we do our best to reduce how often this occurs
`retry_required`	`61911`	`corrupted videos`	The video received could not be played
Document issue
`declined`	`62101`	`document_expired`	User presented an expired document
	`62102`	`document_not_accepted`	User presented a document which is not accepted
	`62103`	`document_damaged`	User has submitted a damaged document
Copy issue
`declined`	`62201`	`document_photocopy`	User presented a photocopy of the document
`declined`	`62202`	`document_screenshot`	User presented the document as a screenshot
Identity fraud
`declined`	`62301`	`document_counterfeit`	User has submitted a counterfeit or falsified document
	`62302`	`document_stolen`	User presented a document that has been declared as stolen or lost
	`62303`	`document_swap`	User presented the front and back of two different documents
	`62304`	`face_mismatch`	User does not match the photograph of the document
	`62305`	`face_not_live`	User has presented a photography or a video of someone else's face on a screen or physical medium
	`62306`	`face_alteration`	User has altered their appearance
	`62307`	`videos_digital_alteration`	User has digitally altered the videos
Suspicious behavior
`declined`	`62401`	`declared_identity_mismatch`	User's identity does not match with the expected one
	`62402`	`suspicious_device`	User used a device that has been technically altered
	`62403`	`consent_unclear`	User seems to have performed the capture against their will
Programmatic actions
`inconclusive`	`64001`	`forcibly closed`	You closed the verification attempt – the `verification_url` is no longer valid

List of response codes