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.
| Couche | Question traitée | Exemple d’échec |
|---|---|---|
| Syntaxe d’entrée | Les caractères et les espaces sont-ils admis ? | Une barre oblique, une ponctuation ou un symbole non pris en charge apparaît. |
| Format national | Ce pays utilise-t-il cette longueur et ce motif BBAN ? | Le code pays est associé à une longueur totale incorrecte. |
| Checksum MOD 97 | Les 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 paiement | Le 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.
- NormaliserRetirez les espaces autorisés, passez les lettres ASCII en majuscules et refusez les caractères non admis.
- Faire pivoterDéplacez les quatre premiers caractères de l’IBAN à la fin.
- Développer les lettresRemplacez A–Z par 10–35 et conservez les chiffres décimaux.
- 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 calcul | Chiffres traités | Reste |
|---|---|---|
| Après le premier bloc | 3214282912 | 23 |
| Ajouter les 10 chiffres suivants | 3456987654 | 58 |
| Ajouter les 8 derniers chiffres | 32161182 | 1 |
| Résultat final | 3214282912345698765432161182 mod 97 | Checksum 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.
- Partir de la bonne BBANUtilisez les champs bancaires selon le format national enregistré.
- Insérer des chiffres provisoiresFormez code pays + 00 + BBAN, puis déplacez et développez les caractères.
- Calculer deux chiffresSoustrayez le reste de 98 et ajoutez un zéro si nécessaire.
- 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.
| Test | Résultat attendu | Couche |
|---|---|---|
| Exemple connu cohérent avec le checksum | Reste 1 | Checksum |
| Un caractère modifié | Signaler un reste différent de 1 | Checksum |
| Zéro initial dans un champ numérique | Conserver le zéro | Analyse et checksum |
| Longueur incorrecte ou ponctuation interdite | Signaler une erreur de format ou de syntaxe | Validation 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
- Registre IBAN Swift et numéro de compte bancaire international — Swift publie le registre ISO 13616 des spécifications nationales de format IBAN.
- Systèmes de caractères de contrôle ISO/IEC 7064:2003 — La page officielle présente des systèmes de contrôle destinés à détecter les erreurs de copie et de saisie.