Guide de validation IBAN

Validation IBAN : vérifier un IBAN en toute sécurité

La validation IBAN est un contrôle par couches d'une chaîne fournie par une banque : format du pays, longueur attendue, caractères autorisés et relation des chiffres de contrôle MOD-97. Une méthode claire permet de repérer les erreurs de copie sans confondre un format cohérent avec un compte réel.

Ce guide explique comment valider un IBAN, lire les erreurs fréquentes et savoir quand demander l'aide de la banque ou du prestataire de paiement. Il s'adresse aux équipes de paiement, au support, à la QA et aux développeurs qui doivent séparer la syntaxe de la vérification d'un compte.

Illustration éditoriale d'une validation IBAN séparant format national, longueur et contrôle MOD-97
La validation IBAN teste une chaîne structurée ; elle n'interroge pas publiquement un compte.

Ce que signifie la validation IBAN

La validation IBAN vérifie si un numéro de compte bancaire international est cohérent avec le format enregistré d'un pays. Elle cherche notamment un préfixe plausible, la bonne longueur, des caractères autorisés et des chiffres de contrôle qui respectent la règle MOD-97. Ce contrôle est utile car un caractère manquant, une inversion ou un mauvais préfixe peut faire rejeter un formulaire avant même qu'une banque ne traite le paiement.

Le mot validation recouvre plusieurs niveaux qu'il faut distinguer. Un contrôle de format n'est ni une interrogation bancaire, ni une correspondance du nom du bénéficiaire, ni un contrôle de sanctions, ni la garantie qu'un virement sera reçu. Dans un rapport, indiquez exactement ce qui a réussi : « format du pays et checksum corrects » est plus précis que « ce compte est valide ». Pour obtenir un résultat immédiat, utilisez le vérificateur IBAN ; cet article explique comment comprendre son résultat et ses limites.

La source doit être une valeur fournie par la banque. Ne construisez jamais un IBAN personnel à partir d'un nom, d'une carte, d'un compte local ou d'un exemple public. Un générateur peut produire des données synthétiques de développement, mais il ne peut pas découvrir un compte privé. Cette séparation protège les paiements et évite que les fixtures de test se retrouvent en production.

CoucheQuestion traitéeCe qui n'est pas prouvé
SyntaxeLe préfixe et les caractères ont-ils la forme d'un IBAN ?Que la chaîne provient d'une banque.
Format nationalLe pays utilise-t-il cette longueur et ce BBAN ?Que chaque champ national est actif.
MOD-97Les chiffres de contrôle correspondent-ils au reste ?Que le compte existe ou appartient au bénéficiaire.
Vérification autoriséeLa banque ou le prestataire peut-il confirmer la relation ?Que le paiement est garanti dans toutes les conditions.

Les couches de validation : pays, longueur, BBAN et MOD-97

Commencez par le code pays. Les deux premières lettres désignent une spécification nationale et les deux chiffres suivants sont les chiffres de contrôle internationaux. Le reste est le Basic Bank Account Number, ou BBAN. Un BBAN allemand, français, britannique ou néerlandais peut avoir des positions, des caractères et une longueur différents. Le vérificateur doit donc choisir la règle du pays avant d'évaluer la chaîne.

Comparez ensuite la longueur de la valeur normalisée avec la longueur enregistrée. Supprimez uniquement les espaces d'affichage, gardez les zéros initiaux et refusez la ponctuation ou les caractères cachés qui ne font pas partie du contrat d'entrée. Une longueur correcte est nécessaire mais faible : beaucoup de chaînes erronées ont le même nombre de caractères. Le motif BBAN ajoute le contrôle des chiffres, des lettres, des identifiants bancaires, des agences et des clés nationales selon chaque position.

Enfin, effectuez le calcul MOD-97. Déplacez les quatre premiers caractères à la fin, remplacez A à Z par les valeurs 10 à 35, puis traitez les chiffres avec un reste courant. Un IBAN complet est généralement cohérent lorsque le reste final vaut 1. Le checksum détecte les erreurs de copie, mais reste une relation mathématique entre des caractères.

Schéma éditorial des quatre étapes de validation IBAN : normaliser, vérifier le pays, calculer MOD-97 et confirmer la source
Appliquez les contrôles structurels dans l'ordre et gardez la confirmation bancaire séparée.
  1. Choisir la règle du paysLisez le préfixe à deux lettres et chargez la longueur et le motif BBAN enregistrés.
  2. Normaliser l'affichageSupprimez les espaces, mettez les lettres en majuscules si autorisé et refusez les signes inattendus.
  3. Contrôler le checksumFaites tourner la chaîne, développez les lettres et calculez le reste modulo 97.
  4. Noter la limiteÉtiquetez le résultat comme format ou checksum, sauf si une vérification bancaire autorisée a aussi réussi.

Valider un IBAN étape par étape

Obtenez d'abord la valeur complète sur un relevé, dans une session bancaire authentifiée, l'application officielle ou une instruction vérifiée. Conservez la présentation d'origine pour pouvoir comparer si le contrôle échoue. Si un message modifie des coordonnées de paiement, confirmez-le par un second canal fiable. Une validation de format ne détecte pas toutes les fraudes : une valeur frauduleuse peut être parfaitement formée.

Normalisez ensuite l'entrée selon le contrat de l'outil ou du prestataire. Les espaces imprimés sont généralement des séparateurs et peuvent être retirés dans un champ électronique. Ne complétez pas un caractère manquant, ne remplacez pas une lettre par un chiffre ressemblant et ne supprimez pas les zéros initiaux. Refusez une étiquette « IBAN », une barre, un tiret ou un caractère non ASCII si le parseur ne les accepte pas explicitement.

Validez enfin par couches et conservez la première erreur utile. Un pays non pris en charge ne doit pas être présenté comme un échec de checksum. Une mauvaise longueur doit conduire à recopier la valeur avant de déboguer MOD-97. Si le checksum échoue après le format, comparez chaque caractère avec la source et vérifiez qu'un espace ou un saut de ligne n'a pas été copié comme donnée.

  1. 1. Confirmer la sourceUtilisez une source bancaire actuelle et vérifiez le nom du compte et la devise.
  2. 2. Normaliser prudemmentRetirez seulement les espaces, gardez lettres et chiffres et refusez les signes inattendus.
  3. 3. Appliquer le format nationalComparez le pays, la longueur, les classes de caractères et les positions BBAN.
  4. 4. Exécuter MOD-97Utilisez la chaîne complète et attendez un reste final de 1 pour la cohérence du checksum.
  5. 5. Escalader correctementDemandez à la banque ou au prestataire une confirmation lorsque la syntaxe ne suffit pas.

Lire les résultats de réussite et d'échec

Un bon validateur renvoie un état expliqué, pas seulement un badge vert. « Pays non pris en charge » signifie que le registre ne connaît pas le préfixe ou qu'il est mal copié ; ce n'est pas une raison pour choisir un autre pays. « Longueur incorrecte » indique que le nombre de caractères normalisés diffère de la spécification. « Caractères invalides » pointe souvent vers une ponctuation, une étiquette copiée, une espace insécable ou un caractère hors alphabet. Corrigez la source au lieu de deviner.

Un checksum en échec signifie que la chaîne tournée et développée ne produit pas le reste attendu. Recopiez la valeur, comparez les quatre premiers caractères et recherchez une inversion. Un checksum réussi signifie seulement que la relation mathématique est cohérente. Il ne prouve ni l'ouverture du compte, ni le nom du bénéficiaire, ni l'acceptation du paiement par la banque réceptrice.

  • Ne changez jamais les chiffres pour obtenir un checksum positif ; vous perdriez la trace de l'erreur.
  • Conservez séparés les échecs du format national et ceux du checksum dans vos mesures.
  • Affichez « format accepté » plutôt que d'affirmer qu'une banque a confirmé le compte.
RésultatSens probableAction suivante
Pays non pris en chargeLe préfixe manque au registre ou est mal écrit.Confirmer le préfixe bancaire et la couverture du registre.
Mauvaise longueurLe nombre de caractères ne correspond pas à la règle.Recopier la valeur ; ne pas ajouter de zéros.
Échec du motifUn caractère ou un champ ne correspond pas au BBAN.Comparer la source et les instructions du pays.
Checksum en échecMOD-97 échoue après normalisation.Vérifier la copie, les espaces et la rotation.
Format acceptéLa chaîne est cohérente selon les règles testées.Utiliser une vérification bancaire pour la décision de compte.

Ce que la validation IBAN ne peut pas prouver

Un validateur de format peut examiner une chaîne sans contacter une banque. Il détecte généralement les caractères interdits, une longueur incorrecte, un mauvais couple pays/BBAN et un checksum MOD-97 en échec. Cela aide les formulaires et le nettoyage de données, mais répond à une question technique limitée. Une chaîne peut passer toutes les règles locales et être pourtant non attribuée, clôturée, placée dans le mauvais champ ou inadaptée au moyen de paiement.

La validation ne dit pas non plus qui possède le compte. Elle ne déduit pas l'IBAN d'une personne à partir de son nom, de sa carte, de son adresse ou d'un compte local partiel. Elle ne fait pas de contrôle du bénéficiaire, de sanctions, de solde ou d'autorisation de paiement. Ces décisions relèvent d'une banque ou d'un prestataire autorisé.

Pour un virement réel, comparez l'IBAN complet avec les instructions actuelles de la banque réceptrice et confirmez tout changement par un canal sûr. Pour le logiciel, utilisez des valeurs synthétiques identifiées et des garde-fous d'environnement. Le guide des données IBAN de test explique comment garder les fixtures hors des factures, bénéficiaires, prélèvements et appels de production.

  • La validité du format ne prouve pas l'existence du compte.
  • Le préfixe du pays ne prouve pas le lieu de résidence du titulaire.
  • Un checksum réussi ne prouve ni la propriété ni la concordance du bénéficiaire.
  • Un contrôle local n'est ni une autorisation ni une garantie de règlement.

Liste de contrôle développeur et QA pour la validation IBAN

Implémentez la validation en étapes explicites afin que chaque appelant puisse choisir le bon message. Gardez la valeur sous forme de texte, normalisez seulement l'affichage autorisé et chargez les règles d'un registre entretenu. Ne convertissez pas un IBAN complet en nombre JavaScript ou en flottant : les grandes chaînes et les zéros initiaux peuvent être altérés. Une boucle de reste modulo conserve une arithmétique bornée et facilite les tests.

Une matrice de tests utile comprend une valeur synthétique connue pour plusieurs longueurs, la même valeur avec des espaces, des minuscules, un caractère modifié, deux caractères inversés, un pays inconnu, une chaîne trop courte, une autre trop longue, de la ponctuation et un cas limite des chiffres de contrôle. La discussion développeur de la recherche rappelle qu'il faut valider la plage des deux chiffres pour ne pas accepter l'ambiguïté `00`/`97`. Vérifiez cette limite avec le registre actuel.

Séparez les états `syntax_error`, `country_unsupported`, `length_error`, `pattern_error`, `checksum_error` et `format_pass`. Dans les journaux, évitez les IBAN clients complets lorsqu'une valeur hachée ou masquée suffit. Pour une vérification réelle, transmettez au prestataire au lieu d'ajouter une requête réseau cachée à un simple vérificateur local.

function ibanMod97(input) {
  const value = input.replace(/[ \t\r\n]/g, '').toUpperCase();
  if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]+$/.test(value)) {
    return {status: 'syntax_error'};
  }
  let remainder = 0;
  for (const character of value.slice(4) + value.slice(0, 4)) {
    const expanded = /[A-Z]/.test(character)
      ? String(character.charCodeAt(0) - 55)
      : character;
    for (const digit of expanded) {
      remainder = (remainder * 10 + Number(digit)) % 97;
    }
  }
  return {status: remainder === 1 ? 'checksum_pass' : 'checksum_error'};
}

// Vérifiez aussi la longueur et le BBAN avant d'accepter le résultat.

Ce code montre seulement la limite arithmétique. Un service complet nécessite des règles nationales à jour, des erreurs compréhensibles, des contrôles de confidentialité et une voie séparée de vérification bancaire.

Choisir la bonne suite après la validation

Si la valeur échoue, demandez une nouvelle copie au titulaire ou à la banque. N'utilisez pas un exemple public comme modèle de correction et ne modifiez pas les caractères jusqu'à obtenir un feu vert. Pour la QA, conservez une fixture synthétique avec une étiquette d'environnement. Pour un paiement, suivez les instructions de la banque réceptrice et le contrôle autorisé du prestataire.

Le site sépare ces usages. Utilisez le vérificateur IBAN pour le format et le checksum, le décodeur IBAN pour voir les champs, et le guide MOD-97 pour la formule. Pour obtenir une valeur bancaire, lisez comment trouver votre IBAN plutôt que de le générer.

  1. Format accepté pour la documentationNotez la règle nationale, la version du registre et la normalisation appliquée.
  2. Fixture QAMarquez la valeur comme synthétique et gardez-la hors des données client et paiement.
  3. Paiement réelConfirmez les coordonnées bancaires et utilisez le canal de vérification du prestataire.

FAQ sur la validation IBAN

Que vérifie la validation IBAN ?

Elle peut vérifier la syntaxe, le pays, la longueur, les caractères BBAN et la relation MOD-97. Les couches dépendent du registre et du prestataire.

Un IBAN valide signifie-t-il que le compte existe ?

Non. Le format et le checksum sont des preuves mathématiques ; ils ne prouvent ni l'attribution, ni l'état, ni le titulaire, ni la possibilité de paiement.

Comment valider un IBAN avant un paiement ?

Commencez par la valeur bancaire, comparez les coordonnées, exécutez le contrôle de format et de checksum, puis utilisez la banque ou le prestataire si une confirmation de compte est requise.

Puis-je valider un IBAN avec un nom ou une carte ?

Non. Ne déduisez pas des informations privées à partir d'un nom, d'une carte ou d'un compte partiel. Demandez la valeur à la banque.

Que faire si le checksum échoue ?

Recopiez la valeur, retirez seulement les espaces, comparez les quatre premiers et les derniers caractères et demandez une nouvelle valeur. Ne modifiez pas les chiffres.

Un vérificateur IBAN équivaut-il à une vérification bancaire ?

Non. Le vérificateur analyse la chaîne et le format ; le service bancaire autorisé confirme une relation de compte selon ses règles.

Liste de contrôle pour une validation sûre

Validez par couches : utilisez une source fiable, normalisez les espaces, choisissez la règle du pays, contrôlez la longueur et le BBAN, puis exécutez MOD-97. Nommez précisément le résultat et gardez les erreurs corrigeables.

Un résultat positif signifie que la chaîne est cohérente selon les règles testées. Il ne prouve ni l'existence d'un compte, ni son titulaire, ni le règlement du paiement. Ces décisions nécessitent la banque ou un prestataire autorisé.

Références de format et d'implémentation