Skip to main content

IBAN validation

Frihet checks the IBANs you type so that a mistyped account does not end up on an invoice or an employee record. The check runs in your browser and does not query any bank.

What is checked​

The validation follows these steps:

  1. It ignores spaces and converts the text to uppercase.
  2. It checks that the country code is in the IBAN registry. Frihet recognises 89 country formats.
  3. It checks that the length matches that country.
  4. It checks that the rest of the number has the format that country uses.
  5. It verifies the check digits with the standard IBAN calculation.

An IBAN passing validation means it is well formed. It does not confirm that the account exists or belongs to who you think.

Where it applies​

ScreenWhat it does with an invalid IBAN
Settings → Billing, block Default payment method (Business IBAN)Shows "The IBAN is not valid. Check the country, length and check digits". It does not let you save the payment method. Frihet never prints on an invoice an IBAN that fails validation.
People, an employee's payroll profileShows "Invalid IBAN" and does not let you save the form.
Bank connection form, IBAN (optional) fieldWarns and still lets you save.

Business IBAN on invoices​

The IBAN under Default payment method is printed for bank transfers and in the SEPA QR code on invoices that have no payment method of their own. If you choose bank transfer, the IBAN is required. Frihet accepts spaces, hyphens and dots when you type it and removes them when normalising it.

Bank connection form​

When you leave the IBAN (optional) field, Frihet validates the number. If it is correct, it rewrites it with a space every four characters and shows the country below it and, when it can be extracted, the bank code. If it is not, it shows a warning without blocking the save:

WarningCause
Incorrect length for an IBAN of the given countryCharacters are missing or extra.
Incorrect IBAN format for the given countryThe rest of the number does not match the country format.
The IBAN check digits are incorrectThere is a typing error.
Country code not found in the IBAN registryThe country is not in the registry.