Testing Image Identity Verification in Sandbox

This guide explains how to test Image Identity Verification in the Sandbox environment without incurring charges.

In the Sandbox, real verification is not performed. Instead, you will experience a simulated experience that closely mirrors the production behavior.

When initiating an Image Identity Verification, you must upload a file with a specific filename using the file parameter. This filename determines the status result that will be simulated, and you can also test the anonymized version of the status:

Statuts simulation	Filename
Pending	pending_id_document_verification.{pdf\|jpg\|jpeg\|png}
Verified	verified_id_document_verification.{pdf\|jpg\|jpeg\|png}
Verified_anonymised	verified_anonymized_id_document_verification.{pdf\|jpg\|jpeg\|png}
Failed	failed_id_document_verification.{pdf\|jpg\|jpeg\|png}
Failed_anonymised	failed_anonymized_id_document_verification.{pdf\|jpg\|jpeg\|png}
Inconclusive	inconclusive_id_document_verification.{pdf\|jpg\|jpeg\|png}
Inconclusive_anonymised	inconclusive_anonymized_id_document_verification.{pdf\|jpg\|jpeg\|png}

ℹ️ If you name the test file incorrectly, the API won’t recognize it, and the verification will fail. However, the file extension does not matter, you can use .pdf, .jpg, .jpeg or .png without affecting the result.

Once the verification initiation has been done, you can retrieve the results through the designated endpoint.

Also, if you have subscribed in the Sandbox to the verification.identity_document.done event you will also receive a webhook notification.