[quiqqer/core] control.breadcrumb.text

Documentation de l’API de validation d’IBAN

L’API REST d’IBAN-Test vérifie la structure et la clé des IBAN, renvoie les données bancaires et BIC disponibles, contrôle les BIC et les comptes bancaires allemands et génère des IBAN à partir de coordonnées bancaires. Utilisez le jeton API de votre tableau de bord pour vous authentifier et intégrez les réponses JSON à vos formulaires, traitements de paiement et systèmes internes.

Essayer le vérificateur d’IBAN en ligne · Utiliser le générateur d’IBAN · Connecter le serveur MCP

Documentation interactive pour les développeurs

La référence technique complète, avec les paramètres, les schémas de réponse et les fonctions de test, est disponible dans la documentation OpenAPI.

Ouvrir la documentation OpenAPI

Authentification

Utilisez le jeton de la rubrique API overview comme jeton Bearer dans l’en-tête HTTP :

Authorization: Bearer YOUR_API_TOKEN

Après connexion, retrouvez votre jeton dans API overview. Vous n’avez pas encore de compte ? Créez votre clé API.

URL de base

https://www.iban-test.eu/api

Points d’accès

  • GET /v2/iban/validate?iban=... – vérifier un IBAN
  • GET /v2/iban/validate/{iban} – vérifier un IBAN transmis dans le chemin de l’URL
  • POST /v2/iban/validate – vérifier un IBAN transmis dans le corps de la requête
  • GET /v2/bic/validate/{bic} – vérifier un BIC
  • GET /v2/bank-account/validate?bankcode=...&accountnumber=... – vérifier un compte bancaire allemand
  • GET /v2/iban/generate?countrycode=...&bankcode=...&accountnumber=... – générer un IBAN

Les contrôles effectués sur un IBAN

  • Code pays, caractères et longueur du format IBAN national
  • Clé de contrôle IBAN vérifiée par le calcul international MOD-97
  • Données disponibles dans les référentiels : nom de la banque, ville et BIC

Un résultat valide confirme la cohérence formelle de l’IBAN. Il ne prouve pas que le compte existe, appartient à une personne donnée, est actif ou peut recevoir des paiements.

Exemples de requêtes

Vérifier un IBAN

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/iban/validate?iban=DE89%203704%200044%200532%200130%2000"

Les espaces sont acceptés dans les IBAN et supprimés automatiquement avant la vérification.

Vérifier un BIC

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/bic/validate/COBADEFFXXX"

Vérifier un compte bancaire

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/bank-account/validate?bankcode=37040044&accountnumber=532013000"

Générer un IBAN

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/iban/generate?countrycode=DE&bankcode=37040044&accountnumber=532013000"

Format des réponses et gestion des erreurs

Tous les points d’accès renvoient du JSON. Avant d’accepter ou d’enregistrer des coordonnées bancaires, examinez la réponse HTTP et les champs error, code, message ainsi que le champ facultatif details .

{
  "error": false,
  "code": 2100,
  "message": "IBAN is valid",
  "details": {}
}

Consultez OpenAPI pour les schémas actuels des paramètres et des réponses. Une clé IBAN correcte ne confirme pas l’identité du titulaire du compte.

MCP pour les clients IA

En complément de l’API REST, IBAN-Test propose un serveur Model Context Protocol pour la vérification d’IBAN. MCP expose les mêmes fonctions bancaires sous forme d’outils structurés pour les clients et agents IA compatibles.

Point d’accès MCP

Connectez votre client compatible MCP à cette adresse et authentifiez-vous avec votre jeton API.

https://www.iban-test.eu/mcp
Authorization: Bearer YOUR_API_TOKEN

Outils MCP disponibles

  • validate_iban – vérifie un IBAN
  • validate_iban_batch – vérifie plusieurs IBAN ; chaque IBAN compte comme une requête API
  • generate_test_iban – génère un IBAN à partir du pays, du code bancaire et du numéro de compte
  • ibantest_bank_account_validate – vérifie un code bancaire et un numéro de compte allemands
  • ibantest_bic_validate – vérifie un BIC et renvoie les coordonnées bancaires disponibles

Les appels fonctionnels aux outils MCP sont décomptés de votre quota API IBAN-Test, comme les requêtes REST.

Remarques

  • L’API REST et MCP utilisent des jetons Bearer.
  • L’ancienne API utilisant un code d’authentification n’est pas décrite dans cette documentation.
  • Les requêtes fonctionnelles sont décomptées du quota API en cours.

Questions fréquentes sur l’API IBAN-Test

Les réponses sur les jetons Bearer, les requêtes, les réponses JSON, les quotas et les intégrations se trouvent dans la FAQ d’IBAN-Test.

Comment utiliser l’API IBAN-Test ?
Comment construire une requête API ?

Comment construire une requête API ?

Transmettez votre jeton API comme jeton Bearer dans l’en-tête HTTP.

Authorization: Bearer YOUR_API_TOKEN

URL de base :

https://www.iban-test.eu/api

Vérifier un IBAN :

GET /v2/iban/validate/{iban}
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/iban/validate/DE89%203704%200044%200532%200130%2000"

Vérifier un BIC :

GET /v2/bic/validate/{bic}
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/bic/validate/COBADEFFXXX"

Vérifier un compte bancaire :

GET /v2/bank-account/validate?bankcode=37040044&accountnumber=532013000

Générer un IBAN :

GET /v2/iban/generate?countrycode=DE&bankcode=37040044&accountnumber=532013000

Retrouvez les paramètres, les champs de réponse et les fonctions de test dans la Documentation API.

Quel format de réponse utilise l’API ?
Que renvoie l’API ?

Que renvoie l’API ?

Tous les points d’accès renvoient du JSON. Le résultat contient error, code, message et des détails propres au point d’accès.

{
  "error": false,
  "code": 2100,
  "message": "IBAN is valid",
  "details": {}
}

Selon le point d’accès et le pays, les détails peuvent inclure les informations de la banque, le BIC, les résultats de vérification du compte ou l’IBAN généré.

Pour les codes de statut, paramètres et schémas de réponse actuels, consultez la Documentation API.

Pourquoi mon accès API est-il bloqué ?
Pourquoi mon accès API est-il bloqué ou désactivé ?

Pourquoi mon accès API est-il bloqué ou désactivé ?

Cela peut arriver si votre quota est épuisé, si votre jeton API est invalide ou si une utilisation suspecte ou abusive est détectée.

Si vous avez simplement atteint votre quota, attendez sa prochaine remise à zéro ou choisissez une formule offrant davantage de requêtes.

Si l’accès semble bloqué pour une autre raison, contactez l’assistance via le formulaire de contact.

Puis-je intégrer IBAN-Test à mes formulaires ou à ma boutique ?
Oui.

Oui. L’API IBAN-Test est conçue pour les vérifications automatisées dans les formulaires, boutiques, produits SaaS, mandats SEPA et outils de gestion.

Vous pouvez notamment contrôler les coordonnées au paiement, à l’inscription, avant un prélèvement ou avant l’import d’un grand volume de données de paiement.

Vous repérez ainsi les fautes de frappe et les coordonnées invalides avant qu’elles ne provoquent des échecs de paiement ou des rejets de prélèvement.

Vérification des données bancaires

Des vérifications fondées sur les référentiels bancaires

IBAN-Test ne se limite pas à la clé de contrôle. Pour les pays ci-dessous, nous vérifions le code de la banque dans les référentiels disponibles et renvoyons les informations trouvées : établissement, ville et BIC. Comprendre la vérification d’un IBAN.

ALAlbanie ADAndorre ATAutriche BEBelgique BGBulgarie HRCroatie CYChypre CZTchéquie DKDanemark EEEstonie FIFinlande FRFrance DEAllemagne GIGibraltar GRGrèce HUHongrie ISIslande IEIrlande ITItalie LVLettonie LILiechtenstein LTLituanie LULuxembourg MTMalte MDMoldavie MEMonténégro NLPays-Bas MKMacédoine du Nord NONorvège PLPologne PTPortugal RORoumanie SMSaint-Marin RSSerbie SKSlovaquie SISlovénie ESEspagne SESuède CHSuisse VAÉtat de la Cité du Vatican

Vérification du format IBAN

115 formats IBAN pris en charge

Contrôlez la structure, la longueur et la clé de votre IBAN pour repérer les fautes de frappe et les chiffres inversés avant un paiement. Pour les pays indiqués plus haut, une vérification complémentaire s’appuie sur les référentiels bancaires disponibles.

Serveur MCP pour agents IA – Connectez vos clients IA aux outils de vérification d’IBAN – https://www.iban-test.eu/mcp – Documentation API