Identities codes
Beta
Last updated: October 15, 2025
Identities checks can have the following statuses, attempt statuses, and response codes.
Information
When we add new response codes, we always ensure backward compatibility. However, we recommend basing your business logic on the status, and then using response codes as additional information.
Checks can have the following statuses in API responses and webhooks:
Status | Description | Recommended action |
---|---|---|
| The check was successful and the applicant is approved. Applies to:
Response code – | Accept the applicant's request. |
| The applicant is capturing their ID document and/or face. Applies to:
| Wait for the next status. |
| Checkout.com is processing the check. Applies to:
| Wait for the next status. |
| You successfully created the check. Applies to:
| Create an attempt. |
| The check was not successful and the applicant is declined. Applies to:
Response codes:
| Refuse the applicant's request, or create a new check. |
| Checkout.com could not complete the check and you can no longer retry. Applies to:
Response code – | No action is available. |
| You successfully created an attempt and the attempt URL is available. Applies to:
Response code – | Redirect the applicant to the attempt. |
| For ID Document Verification, Checkout.com is checking the document image quality. | Wait for the next status. |
| The applicant refused to start the attempt. Applies to:
Response code – | Suggest an alternative to the applicant. |
| Checkout.com could not complete the check. Applies to:
Response codes:
| Create a new attempt. |
| For AML Screening, the risk score is | Investigate the case. |
| For AML Screening, Checkout.com is screening databases and generating the risk score. | Wait for the next status. |
Each attempt can have the following statuses in API responses and webhooks:
Status | Description |
---|---|
| The applicant abandoned the attempt without capturing their ID document and/or face. Applies to:
|
| The applicant is capturing their ID document and/or face. Applies to:
|
| The applicant explicitly refused to perform the capture. Applies to:
|
| Checkout.com could not complete the check and you can no longer retry. Applies to:
|
| Checkout.com is processing the check. Applies to:
|
| The applicant successfully completed the attempt. Applies to:
|
| The attempt URL expired. Applies to:
|
| The attempt is created, but the applicant has not yet been redirected. Applies to:
|
| For ID Document Verification, Checkout.com is checking for authenticity. |
| For ID Document Verification, the document images are insufficient quality to perform the verification, and the attempt is closed. |
| The attempt is closed because you created a new attempt. Applies to:
|
Response codes provide more information about check statuses as follows:
Response code | Summary | Description |
---|---|---|
|
| The check was successful and the applicant is approved. Applies to:
|
Response code | Summary | Description | |
---|---|---|---|
User engagement issue | |||
|
| The applicant was not redirected to or did not start the attempt. Applies to:
| |
|
| The applicant clicked a button to state they wanted to perform the check later. Applies to:
| |
|
| For Identity Verification, the applicant clicked a button to state they did not have their ID document with them. | |
|
| The applicant did not give access to their device camera when instructed. Applies to:
| |
|
| The applicant abandoned the attempt before capturing their ID document and/or face and the attempt URL expired. Applies to:
| |
Technical issue | |||
|
| The applicant's connection was too poor to capture their ID document and/or face. Applies to:
| |
|
| The applicant's browser was not suitable for video streaming. Applies to:
| |
|
| The applicant's device did not have a camera. Applies to:
| |
|
| The applicant switched tabs or applications during the attempt. | |
|
Deprecated | The applicant did not receive the SMS. | |
Document capture issue | |||
|
| The applicant's document video or image was too blurry. Applies to:
| |
|
| The applicant performed the document capture in poor light. Applies to:
| |
|
| For ID Document Verification, the applicant did not capture their ID document in color. | |
|
| The applicant did not capture the front of the document. Applies to:
| |
|
| The applicant did not capture the back of the document. Applies to:
| |
|
| Part of the document was hidden in the capture. Applies to:
| |
|
| For Identity Verification, the applicant did not move the document dynamically. | |
|
Deprecated | The document's barcode was not readable. | |
Secondary document capture issue | |||
|
| For Identity Verification, the applicant's secondary document is too blurry. | |
|
| For Identity Verification, the applicant performed the secondary document capture under poor lighting conditions. | |
|
| For Identity Verification, the applicant did not capture the front of the secondary document. | |
|
| For Identity Verification, the applicant did not capture the back of the secondary document. | |
|
| For Identity Verification, the applicant hid part of the secondary document. | |
|
| For Identity Verification, the applicant did not move the secondary document sufficiently. | |
Face capture issue | |||
|
| The face video was too blurry. Applies to:
| |
|
| The applicant captured the face video in poor light. Applies to:
| |
|
| The applicant did not present their face to the camera. Applies to:
| |
|
| The applicant did not present a full-frontal view of their face. Applies to:
| |
|
| The applicant did not move enough to prove liveness. Applies to:
| |
|
Deprecated | The applicant also captured another person's face. | |
Internal error | |||
|
| Checkout.com could not complete the check due to an internal error. Applies to:
| |
|
| The videos received could not be played. |
Response code | Summary | Description | |||
---|---|---|---|---|---|
Document issue | |||||
|
| The applicant presented an expired document. Applies to:
| |||
|
| The applicant presented an unsupported document. Applies to:
| |||
|
| The applicant presented a damaged document. Applies to:
| |||
|
| The applicant's document contains an unsupported alphabet. Only the Latin alphabet is supported. Applies to:
| |||
|
| The applicant presented a photocopy of the document. Applies to:
| |||
|
| The applicant presented a screenshot of the document. Applies to:
| |||
Secondary document issue | |||||
|
| For Identity Verification, the applicant presented an expired secondary document. | |||
|
| For Identity Verification, the applicant presented an unsupported secondary document. | |||
|
| For Identity Verification, the applicant presented a damaged secondary document. | |||
|
| For Identity Verification, the applicant's secondary document contains an unsupported alphabet. Only the Latin alphabet is supported. | |||
|
| For Identity Verification, the applicant presented a photocopy of the secondary document. | |||
|
| For Identity Verification, the applicant presented a screenshot of the secondary document. | |||
Identity fraud | |||||
|
| The applicant presented a counterfeit or falsified document. Applies to:
| |||
|
| The applicant presented a document that has been declared lost or stolen. Applies to:
| |||
|
| The applicant presented the front and back of two different documents. Applies to:
| |||
|
| For Identity Verification, the applicant's face in the face video did not match the document portrait. | |||
|
| The applicant presented a physical or digital photo or video of another person's face. Applies to:
| |||
|
| The applicant altered their appearance. Applies to:
| |||
|
| The document and/or face videos are digitally altered. Applies to:
| |||
|
| For Face Authentication, the face video does not match any previous face authentication for this applicant. | |||
|
| For Identity Verification, the applicant presented a counterfeit or falsified secondary document. | |||
|
| For Identity Verification, the applicant presented a secondary document that has been declared lost or stolen. | |||
|
| The applicant presented the front and back of two different secondary documents. Applies to:
| |||
|
| For Identity Verification, the applicant is not the holder of the secondary document. | |||
|
| For certified Identity Verification, the verification is fraudulent. | |||
Suspicious behavior | |||||
|
| The applicant's identity did not match the details they provided. Applies to:
| |||
|
| The applicant used a device that has been technically altered. Applies to:
| |||
|
| The applicant appears to have captured their document and/or face under coercion. Applies to:
| |||
|
| The applicant presented multiple documents. Applies to:
| |||
|
| The applicant is known to have previously attempted fraud. Applies to:
|
Response code | Summary | Description |
---|---|---|
|
| The applicant clicked a button to refuse to perform the check. |
Response code | Summary | Description |
---|---|---|
|
| You closed the attempt and the attempt URL is no longer valid. |