IBAN Advanced

IBAN Advanced est le service API conçu pour vérifier en temps réel la validité d'un IBAN, extraire les données complètes de la banque et de l'agence associées et contrôler l'accessibilité aux schémas SEPA, y compris pour les virements instantanés. Grâce à une infrastructure solide et toujours disponible, l'API permet d'automatiser les contrôles sur les coordonnées bancaires, d'éliminer les erreurs humaines et de garantir l'intégrité des paiements.

CE QUE VOUS POUVEZ FAIRE AVEC IBAN ADVANCED

IBAN Advanced ne se limite pas à une simple validation formelle : il offre un ensemble complet d'outils pour gérer les coordonnées bancaires en toute sécurité :

DONNÉES BANCAIRES DÉTAILLÉES

Au-delà de la validation, le service fournit des informations complètes sur l'établissement financier, avec des données essentielles pour la facturation et la logistique :

VÉRIFICATION IBAN

La première étape consiste à envoyer une requête à l'endpoint POST/iban-advanced/{iban}, qui lance la validation. Un environnement sandbox est disponible pour les tests à l'adresse test.trust.openapi.com.

EXEMPLE DE REQUÊTE

POST/iban-advanced/{iban}

Voici un exemple de requête pour vérifier un IBAN :

POST https://trust.openapi.com/iban-advanced/IT60X0306905020000000123456

Il est également possible de transmettre un callback pour recevoir automatiquement le résultat sur votre serveur. Le callback prend en charge des en-têtes personnalisés (par exemple pour l'authentification) et jusqu'à 5 nouvelles tentatives automatiques en cas d'erreur temporaire :

{
  "callback": {
    "url": "https://your-server.site/iban-callback",
    "custom": {
      "orderId": "iban-check-789"
    }
  }
}

EXEMPLE DE RÉPONSE

POST/iban-advanced/{iban}

La réponse initiale renvoie l'ID de la requête et son état :

{
  "data": {
    "id": "69c117af962df6cee50c9525",
    "iban": "IT60X0306905020000000123456",
    "state": "NEW"
  },
  "success": true,
  "message": "",
  "error": null
}

ÉTATS DE LA REQUÊTE

La vérification est traitée via un système de files d'attente asynchrone. Chaque requête passe par les états suivants :

RÉCUPÉRATION DU RÉSULTAT IBAN

Pour obtenir le résultat complet de la vérification, utilisez l'endpoint GET/iban-advanced/{id} en indiquant l'ID reçu lors de la requête précédente. Avec l'endpoint GET/iban-advanced, vous pouvez consulter la liste de toutes vos requêtes et les filtrer par état.

EXEMPLE DE REQUÊTE

GET/iban-advanced/{id}

GET https://trust.openapi.com/iban-advanced/69c117af962df6cee50c9525

EXEMPLE DE RÉPONSE

GET/iban-advanced/{id}

Voici un exemple de réponse complète pour un IBAN valide :

{
  "data": {
    "id": "69c117af962df6cee50c9525",
    "iban": "IT60X0306905020000000123456",
    "state": "DONE",
    "status": "IBAN is valid",
    "bankData": {
      "bic": "TESTITMMXXX",
      "bank": "Banca Italiana Test S.p.A.",
      "branch": "Roma Sede Centrale",
      "address": "Via del Corso, 123",
      "city": "Roma",
      "state": "RM",
      "zipCode": "00186",
      "country": "ITALY",
      "countryCode": "IT",
      "account": "000000123456",
      "bankCode": "03069",
      "branchCode": "05020"
    },
    "sepaData": {
      "creditTransfer": true,
      "directDebit": true,
      "cor1": true,
      "b2b": true,
      "cardClearing": false,
      "creditInstantTransferRT1": true,
      "creditInstantTransferTIPS": true
    },
    "validations": {
      "chars": {
        "valid": true,
        "message": "IBAN does not contain illegal characters"
      },
      "account": {
        "valid": true,
        "message": "Account Number check digit is correct"
      },
      "iban": {
        "valid": true,
        "message": "IBAN Check digit is correct"
      },
      "structure": {
        "valid": true,
        "message": "IBAN structure is correct"
      },
      "length": {
        "valid": true,
        "message": "IBAN Length is correct"
      },
      "countrySupport": {
        "valid": true,
        "message": "Country supports IBAN standard"
      }
    },
    "errors": [],
    "createdAt": "2026-03-30T10:00:00Z",
    "updatedAt": "2026-03-30T10:00:00Z"
  },
  "success": true,
  "message": "",
  "error": null
}

À QUI S'ADRESSE CE SERVICE

Le service IBAN Advanced est conçu pour répondre aux besoins d'un marché numérique où la précision des données financières est un atout stratégique. Pour les sites e-commerce et les plateformes numériques, l'intégration de la validation en temps réel transforme profondément l'expérience d'achat : les systèmes automatisés détectent les erreurs de saisie dès que l'utilisateur entre ses coordonnées bancaires, sécurisant ainsi le processus de paiement et évitant des remboursements coûteux ou des retards dans la souscription aux services.

Au sein des services financiers, comptables et RH, l'outil devient un allié au quotidien pour la gestion administrative : chaque IBAN est vérifié automatiquement et complété avec les données de la banque et de l'agence, ce qui permet de garder à jour les fiches clients, fournisseurs et salariés. De la même manière, les entreprises qui gèrent des paiements et des prélèvements SEPA ainsi que les FinTech trouvent dans IBAN Advanced une ressource indispensable : savoir à l'avance si un compte est accessible par virement, prélèvement ou virement instantané permet de choisir le bon canal de paiement et d'éviter les transactions rejetées.

Enfin, la robustesse technique du service s'adresse directement aux développeurs et entreprises IT. L'architecture API est pensée pour une scalabilité totale et une intégration fluide dans les logiciels de gestion existants grâce à des protocoles standard. Ce niveau de fiabilité est essentiel pour les entreprises SaaS aux processus critiques, qui ont besoin d'une infrastructure résiliente et toujours disponible pour gérer de gros volumes de validations sans jamais interrompre leur activité.