Mis à jour le 4 novembre 2026.
Une API de validation IBAN aide les éditeurs à vérifier la structure des coordonnées bancaires et à consulter les données de référence des banques. Elle intervient souvent avant l’entrée d’une fiche dans la comptabilité : création d’un fournisseur, extraction d’une facture ou préparation d’un fichier de migration.
IBANforge ne vérifie ni l’existence du compte, ni son ouverture, ni l’identité de son titulaire. Il n’exécute pas de paiements. Les cinq parcours ci-dessous sont des exemples d’intégration, pas des témoignages clients ni des économies mesurées.
1. Migration ERP : relire le fichier fournisseurs avant l’import
Pour : les intégrateurs ERP et les équipes qui changent de logiciel comptable.
Un fichier de migration peut contenir des BIC manquants, des IBAN mal saisis et des codes bancaires signalés comme retirés. La clé de contrôle ne suffit pas à distinguer ces situations. Envoyez un échantillon au point d’accès par lot, conservez les fiches originales et préparez un fichier de revue séparé.
Lisez valid pour la structure, bank_code_check pour la preuve concernant le code bancaire et bic.authoritative pour la valeur de l’association IBAN–BIC. Un registre indisponible laisse une question ouverte. Cela ne rend pas le compte invalide et n’autorise pas à remplacer un BIC existant.
Pour commencer : le guide de migration ERP propose un exemple Python téléchargeable. Pour un fichier ponctuel sans intégration, utilisez l’audit de fichier.
2. Traitement des factures : contrôler le résultat de l’OCR
Pour : les éditeurs de traitement documentaire et de comptabilité fournisseurs.
Après extraction d’un IBAN d’une facture, contrôlez ce candidat avant de le proposer dans la fiche fournisseur. IBANforge valide la valeur reçue ; il ne lit pas la facture et ne détermine pas si elle est authentique.
Une clé de contrôle correcte n’écarte pas une fraude à la facture : un fraudeur peut fournir un IBAN valide. Gardez une approbation distincte pour les changements de compte, avec un canal de contact déjà connu de votre organisation. Ne remplacez pas les coordonnées du fournisseur au seul motif que le nouveau numéro passe la validation.
Utilisez la validation par lot pour plusieurs candidats. Conservez le lien entre chaque résultat et son document source. Une erreur HTTP signifie que le contrôle n’est pas terminé, pas qu’il a réussi.
3. Création d’un fournisseur : distinguer banque et identité
Pour : les plateformes d’achat, portails fournisseurs et logiciels comptables.
Lors de la saisie, retournez un résultat précis : format invalide, banque identifiée par un registre, rapprochement indicatif ou recherche indisponible. Affichez la source et sa date lorsque les données de référence participent à une décision.
checks.account_exists et checks.payee_name restent à not_checked. Le nom dans bic.bank_name est celui de la banque, pas du titulaire du compte. Ni ce nom ni la classification de l’émetteur n’établissent l’identité du fournisseur.
Si votre parcours exige une comparaison entre le nom et le compte, elle relève d’un service distinct, comme la Verification of Payee du prestataire de paiement. Voir ce que la validation IBAN et la VoP vérifient chacune.
4. Formulaires de paiement : expliquer le contrôle effectué
Pour : les logiciels de paie, de facturation et les intégrateurs de services de paiement.
Contrôlez l’IBAN sur votre serveur à l’envoi du formulaire. Gardez la clé API côté serveur ; ne l’intégrez jamais au JavaScript du navigateur. Pour un contrôle de structure sans données de référence, la bibliothèque libre peut suffire.
Cet exemple Node.js effectue un appel authentifié. Fournissez IBANFORGE_API_KEY dans l’environnement du serveur :
const key = process.env.IBANFORGE_API_KEY;
if (!key) throw new Error("IBANFORGE_API_KEY manque");
const response = await fetch("https://api.ibanforge.com/v1/iban/validate", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${key}`,
},
body: JSON.stringify({ iban: "DE89370400440532013000" }),
signal: AbortSignal.timeout(15000),
});
if (!response.ok) throw new Error(`Validation indisponible : HTTP ${response.status}`);
const result = await response.json();
console.log(result.valid, result.bank_code_holder, result.checks);valid: true décrit la structure de l’IBAN et sa clé de contrôle. Lisez aussi les résultats distincts des clés nationales et du code bancaire. L’appartenance d’un pays à SEPA ne prouve pas qu’une banque ou un compte précis est joignable ; la référence de validation explique les champs au niveau de la banque. Aucun de ces contrôles ne garantit l’exécution d’un paiement.
5. Assistants IA : transmettre les preuves au parcours métier
Pour : les développeurs qui ajoutent des outils financiers à un assistant.
L’interface MCP expose la validation IBAN et la recherche BIC aux clients compatibles. Utilisez le résultat structuré pour expliquer les contrôles réussis, les déductions et les vérifications non effectuées. Conservez les crédits des sources et les limites dans la réponse présentée.
Un assistant ne doit pas interpréter valid: true comme une autorisation de changer le compte d’un fournisseur ou d’envoyer de l’argent. Ces approbations relèvent de l’application métier et de ses contrôles.
Choisir le prochain essai
- Un numéro : examinez une réponse dans le playground.
- Un fichier fournisseurs : consultez l’aperçu de l’audit de fichier.
- Un traitement récurrent : partez des recettes d’intégration et du guide pour les éditeurs.
Les quotas des clés API et les packs prépayés figurent dans les tarifs. Le traitement par lot exige une clé ou un mécanisme de paiement pris en charge ; l’essai sans clé sur un IBAN constitue une entrée distincte. Le guide de démarrage présente les options actuelles.