Guide technique sur l’IBAN

Calcul des chiffres de contrôle IBAN MOD 97 : formule, exemple et code

Un IBAN respecte son checksum lorsque le reste vaut 1 après réorganisation et conversion de ses caractères. Le calcul peut se faire chiffre par chiffre, sans créer un entier gigantesque.

Suivez un exemple GB complet, découvrez le calcul des clés à partir d’une BBAN au format national et consultez des exemples en JavaScript et Python. Un checksum valide porte sur une chaîne de caractères : il ne prouve pas qu’une banque a ouvert le compte.

Illustration éditoriale d’une suite de caractères IBAN transformée en flux numérique pour vérifier un reste MOD 97
Le checksum réorganise et développe les caractères de l’IBAN avant de contrôler le reste.

Ce que vérifie le checksum MOD 97 de l’IBAN

Un IBAN associe un code pays de deux lettres, deux chiffres de contrôle et une BBAN propre au pays. MOD 97 vérifie la relation mathématique de contrôle de cette chaîne ; il ne contacte ni une banque ni un réseau de paiement.

Traitez séparément la syntaxe, la longueur et le motif BBAN enregistrés pour le pays, puis le checksum. Swift publie le registre IBAN ISO 13616 des formats nationaux. ISO/IEC 7064 décrit des systèmes de caractères de contrôle qui aident à détecter les erreurs courantes de saisie ou de copie.

CoucheQuestion traitéeExemple d’échec
Syntaxe d’entréeLes caractères et les espaces sont-ils admis ?Une barre oblique, une ponctuation ou un symbole non pris en charge apparaît.
Format nationalCe pays utilise-t-il cette longueur et ce motif BBAN ?Le code pays est associé à une longueur totale incorrecte.
Checksum MOD 97Les caractères respectent-ils la relation de contrôle ?Un caractère modifié fait que le reste n’est plus égal à 1.
Vérification bancaire ou du paiementLe compte existe-t-il et peut-il recevoir le paiement ?Il faut une banque ou un service autorisé, pas MOD 97.

Checksum IBAN MOD 97 : les quatre étapes du calcul

Partez de la forme électronique de l’IBAN : retirez les espaces d’affichage autorisés et mettez les lettres ASCII en majuscules, mais refusez les autres signes. Déplacez ensuite les quatre premiers caractères à la fin. Remplacez chaque lettre de A à Z par sa valeur décimale de 10 à 35 ; les chiffres restent inchangés.

Parcourez les chiffres obtenus de gauche à droite. Partez de zéro et calculez reste = (reste × 10 + chiffre) mod 97. Le reste demeure entre 0 et 96 : aucun grand entier n’est nécessaire. Un reste final de 1 satisfait la relation du checksum.

Schéma en quatre étapes : déplacer le préfixe IBAN, convertir les lettres en nombres, traiter les chiffres modulo 97 et comparer le reste à un
Le schéma résume la transformation ; l’exemple détaillé ci-dessous donne la chaîne et les calculs exacts.
  1. NormaliserRetirez les espaces autorisés, passez les lettres ASCII en majuscules et refusez les caractères non admis.
  2. Faire pivoterDéplacez les quatre premiers caractères de l’IBAN à la fin.
  3. Développer les lettresRemplacez A–Z par 10–35 et conservez les chiffres décimaux.
  4. Calculer modulo 97Mettez à jour le reste pour chaque chiffre ; le checksum passe si le résultat final vaut 1.

Exemple détaillé : vérifier GB82 WEST 1234 5698 7654 32

Cette valeur est un exemple mathématique, pas une recherche de compte. Après retrait des espaces et déplacement des quatre premiers caractères, on obtient WEST12345698765432GB82. En remplaçant W=32, E=14, S=28, T=29, G=16 et B=11, on obtient 3214282912345698765432161182.

Le tableau traite cette suite par blocs. Chaque nouveau bloc est ajouté au reste précédent selon sa largeur décimale ; il n’est donc pas nécessaire de former un entier gigantesque.

  • Conservez les zéros en tête de chaque bloc ; ces blocs sont du texte de calcul, pas des numéros de compte à normaliser.
  • Le reste final vaut 1. Cela ne prouve pas que la valeur corresponde à un compte bancaire actif.
Point du calculChiffres traitésReste
Après le premier bloc321428291223
Ajouter les 10 chiffres suivants345698765458
Ajouter les 8 derniers chiffres321611821
Résultat final3214282912345698765432161182 mod 97Checksum cohérent

Générer les chiffres de contrôle IBAN depuis une BBAN

La validation part d’un IBAN complet contenant déjà ses deux chiffres de contrôle. La génération commence avec un code pays et une BBAN conforme au format national enregistré. Le checksum ne permet pas de choisir le compte ni les coordonnées bancaires à utiliser.

Pour calculer les chiffres, formez une valeur provisoire avec le code pays, 00 et la BBAN. Déplacez ses quatre premiers caractères, développez les lettres et calculez le reste r modulo 97. Les chiffres de contrôle valent 98 − r, sur deux positions. Insérez-les après le code pays puis vérifiez l’IBAN complet : son reste doit être 1. Pour la BBAN GB WEST12345698765432, la valeur provisoire GB00... donne un reste de 16. Ainsi, 98 − 16 = 82 et l’IBAN obtenu est GB82WEST12345698765432. Ce calcul produit des chiffres, pas des coordonnées bancaires vérifiées.

  1. Partir de la bonne BBANUtilisez les champs bancaires selon le format national enregistré.
  2. Insérer des chiffres provisoiresFormez code pays + 00 + BBAN, puis déplacez et développez les caractères.
  3. Calculer deux chiffresSoustrayez le reste de 98 et ajoutez un zéro si nécessaire.
  4. Vérifier le résultatInsérez les chiffres et confirmez que l’IBAN complet donne un reste de 1.

Implémentation JavaScript sans grand entier

Cette fonction vérifie la syntaxe de base et le checksum. En production, vérifiez aussi la longueur et le motif BBAN actuels du pays.

function ibanMod97Remainder(input) {
  const iban = input.replace(/ /g, "").toUpperCase();
  if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]+$/.test(iban)) {
    throw new Error("Syntaxe IBAN invalide");
  }

  let remainder = 0;
  const rotated = iban.slice(4) + iban.slice(0, 4);
  for (const character of rotated) {
    const expanded = character >= "A" && character <= "Z"
      ? String(character.charCodeAt(0) - 55)
      : character;
    for (const digit of expanded) {
      remainder = (remainder * 10 + Number(digit)) % 97;
    }
  }
  return remainder;
}

ibanMod97Remainder("GB82 WEST 1234 5698 7654 32"); // 1

Distinguez une erreur de checksum d’une erreur de syntaxe ou de format national ; le code ne vérifie pas un compte bancaire.

Calcul incrémental en Python

La même boucle à reste borné fonctionne en Python. Cet exemple conserve l’IBAN sous forme de texte et laisse les contrôles nationaux à un registre tenu à jour.

import re

source = "GB82 WEST 1234 5698 7654 32"
iban = re.sub(r" ", "", source).upper()
if re.fullmatch(r"[A-Z]{2}[0-9]{2}[A-Z0-9]+", iban) is None:
    raise ValueError("Syntaxe IBAN invalide")

rotated = iban[4:] + iban[:4]
remainder = 0
for character in rotated:
    expanded = str(ord(character) - 55) if "A" <= character <= "Z" else character
    for digit in expanded:
        remainder = (remainder * 10 + int(digit)) % 97
print(remainder)  # 1
  • L’exemple renvoie 1 ; un programme de production doit distinguer les erreurs d’analyse de celles du checksum.

Gardez le calcul du checksum testable séparément lorsque les données de format national évoluent.

Tests et limites d’une implémentation du checksum IBAN

Testez le calcul et son analyseur avec des exemples étiquetés, des saisies mal formées et des valeurs synthétiques. La normalisation peut retirer les espaces autorisés et mettre l’ASCII en majuscules ; elle ne doit ni supprimer toute ponctuation, ni remplacer des caractères ressemblants, ni deviner une valeur manquante.

  • Utilisez des valeurs synthétiques dans les tests et masquez les données bancaires réelles dans les diagnostics. MOD 97 détecte des erreurs ; il n’authentifie pas et n’autorise pas un paiement.
TestRésultat attenduCouche
Exemple connu cohérent avec le checksumReste 1Checksum
Un caractère modifiéSignaler un reste différent de 1Checksum
Zéro initial dans un champ numériqueConserver le zéroAnalyse et checksum
Longueur incorrecte ou ponctuation interditeSignaler une erreur de format ou de syntaxeValidation d’entrée

Ce qu’un checksum IBAN MOD 97 valide ne prouve pas

Un reste de 1 prouve uniquement que les caractères respectent la relation du checksum. Il ne démontre pas qu’une banque a attribué l’IBAN, que le compte est ouvert, que le destinataire en est titulaire ou qu’il peut recevoir un paiement.

Un processus de production peut demander le registre national à jour, la confirmation du destinataire ou un service de vérification autorisé. Gardez des états distincts, par exemple : format accepté, checksum réussi, coordonnées non vérifiées. Pour un virement, utilisez un IBAN fourni par la banque ; ne modifiez pas les chiffres pour forcer la réussite.

FAQ sur le checksum IBAN MOD 97

MOD 97 revient-il à vérifier le compte bancaire ?

Non. Le calcul contrôle la cohérence mathématique des caractères de l’IBAN. Il ne contacte pas une banque et ne confirme ni l’attribution, ni l’état, ni le titulaire, ni l’identité du destinataire, ni la possibilité de paiement.

Quel reste doit donner un IBAN cohérent avec son checksum ?

Après avoir déplacé les quatre premiers caractères et développé les lettres, le reste final doit être 1. Vérifiez séparément la longueur et la BBAN du pays.

Comment calculer les chiffres de contrôle IBAN depuis une BBAN ?

Formez code pays + 00 + BBAN, déplacez les quatre premiers caractères, développez les lettres et calculez le reste. Soustrayez-le de 98, complétez sur deux chiffres, insérez-les et vérifiez l’IBAN complet.

Faut-il appliquer cet algorithme à tous les formats nationaux ?

L’étape internationale du checksum est commune, mais la longueur et la structure BBAN dépendent du pays. Consultez un registre à jour, comme le registre IBAN publié par Swift, avant de valider le format complet.

Liste de contrôle de l’implémentation

Normalisez uniquement les saisies admises, vérifiez le format national, déplacez et développez les caractères, puis calculez MOD 97. N’acceptez le checksum que si le reste final vaut 1.

Pour une vérification pratique, ouvrez le vérificateur IBAN ; pour générer des chiffres depuis une BBAN, utilisez le calculateur IBAN. Aucun ne remplace une vérification bancaire.

Références sur les normes et les formats