Testing bank account verification in Sandbox

This guide will explain how to test the bank account document verification without incurring charges in the Sandbox environment.

In the Sandbox, we do not perform real verification but we will provide you a simulated experience that closely mirrors the production behavior.

When initiating a bank account document 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 simulationFilename
Pendingpending_bank_account_verification.{pdf|jpg|jpeg|png}
Verifiedverified_bank_account_verification.{pdf|jpg|jpeg|png}
Verified_anonymizedverified_anonymized_bank_account_verification.{pdf|jpg|jpeg|png}
Failedfailed_bank_account_verification.{pdf|jpg|jpeg|png}
Failed_anonymizedfailed_anonymized_bank_account_verification.{pdf|jpg|jpeg|png}
Inconclusiveinconclusive_bank_account_verification.{pdf|jpg|jpeg|png}
Inconclusive_anonymizedinconclusive_anonymized_bank_account_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 any impact on 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.bank_account.done event you will also receive a webhook notification.