Testing Bank Account IBAN Verification in Sandbox

This guide will explain how to test the Bank Account IBAN Verification without incurring charges in the Sandbox environment.

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

When initiating a Bank Account IBAN Verification, you must use one of the IBANs below in the iban parameter. The IBAN value determines the status result that will be simulated, and you can also test the anonymized version of the status:

Simulate a verification from an IBAN

The IBAN alone determines the simulated result — each one behaves identically whether the expected holder is a natural person or a legal person.

{
    "workspace_id": null,
    "iban": "FR7630004005506782866644202",
    "natural_person": {
        "first_name": "John",
        "last_name": "Doe"
    }
}

{
    "workspace_id": null,
    "iban": "FR7630004005506782866644202",
    "legal_person": {
        "company_name": "Youtrust"
    }
}

FR8930004005501234567890143 simulates a close match: on top of the BALV_1330 status code, it discloses the name the bank holds for the account.

{
    "status": "failed",
    "status_codes": ["BALV_1330"],
    "data": {
        "extracted_from_document": null,
        "account_holder": "John P Waldo"
    }
}

Simulate statuses from a file

To simulate statuses of Bank Account IBAN Verifications from a File you can upload a file with the following filenames to yield the desired status.

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_lookup.done event, you will also receive a webhook notification.