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:

Statuts simulation	Filename
Pending	pending_bank_account_verification.{pdf\|jpg\|png}
Approved	approved_bank_account_verification.{pdf\|jpg\|png}
Declined	declined_bank_account_verification.{pdf\|jpg\|png}
Inconclusive	inconclusive_bank_account_verification.{pdf\|jpg\|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, 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 bank_account_verification.done event you will also receive a webhook notification.