IBAN Start

IBAN Start est le service API qui vérifie la validité d'un IBAN et renvoie les informations essentielles de la banque associée. Chaque requête contrôle le format, les chiffres de contrôle et l'existence de l'établissement bancaire : vous pouvez ainsi détecter des coordonnées erronées avant qu'elles ne se transforment en paiement rejeté ou en remboursement bloqué. Il s'intègre en quelques étapes dans les logiciels de gestion, CRM, sites e-commerce et parcours d'onboarding, et automatise un contrôle encore souvent effectué à la main.

CE QUE VOUS POUVEZ FAIRE AVEC IBAN START

IBAN Start est conçu pour ceux qui ont besoin d'une réponse claire à une question simple : cet IBAN est-il valide, et à quelle banque appartient-il ?

DONNÉES DE LA BANQUE

Lorsque l'IBAN est valide, le service renvoie les principales informations de l'établissement associé, utiles pour compléter les fiches clients et fournisseurs sans saisie manuelle :

VÉRIFICATION IBAN

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

EXEMPLE DE REQUÊTE

POST/iban-start/{iban}

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

POST https://trust.openapi.com/iban-start/IT60X0542811101000000123456

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-start/{iban}

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

{
  "data": {
    "id": "69c117af962df6cee50c9525",
    "iban": "IT60X0542811101000000123456",
    "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-start/{id} en indiquant l'ID reçu lors de la requête précédente. Avec l'endpoint GET/iban-start, vous pouvez consulter la liste de toutes vos requêtes et les filtrer par état.

EXEMPLE DE REQUÊTE

GET/iban-start/{id}

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

EXEMPLE DE RÉPONSE

GET/iban-start/{id}

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

{
  "data": {
    "id": "69c117af962df6cee50c9525",
    "iban": "IT60X0542811101000000123456",
    "state": "DONE",
    "status": "IBAN is valid",
    "valid": true,
    "bank": {
      "bankName": "INTESA SANPAOLO SPA",
      "swiftCode": "BLOPIT22",
      "abiCode": "05428",
      "address": "Piazza Vittorio Veneto 8",
      "countryCode": "IT",
      "currency": "EUR"
    },
    "errors": [],
    "createdAt": "2026-03-30T10:00:00Z",
    "updatedAt": "2026-03-30T10:00:00Z"
  },
  "success": true,
  "message": "",
  "error": null
}

À QUI S'ADRESSE CE SERVICE

IBAN Start s'adresse à toutes les entreprises qui collectent des coordonnées bancaires et veulent s'assurer qu'elles sont correctes avant de les utiliser. Pour les sites e-commerce et les plateformes d'abonnement, la vérification intégrée au moment où l'utilisateur saisit son IBAN réduit les erreurs de saisie, les remboursements échoués et les demandes de correction adressées au service client.

Dans les services administratifs, comptables et RH, le service aide à maintenir des fiches clients, fournisseurs et salariés à jour : chaque nouvel IBAN est contrôlé automatiquement et complété avec le nom de la banque, le code SWIFT et le code ABI, sans recherche manuelle. De la même manière, les parcours d'onboarding des FinTech, marketplaces et plateformes de services peuvent valider les coordonnées bancaires dès l'inscription.

Enfin, IBAN Start est un outil utile pour les développeurs, éditeurs de logiciels et entreprises SaaS qui souhaitent ajouter la vérification IBAN à leurs logiciels de gestion, CRM ou ERP grâce à une intégration simple, en gérant les résultats via callback ou en interrogeant l'API selon leurs besoins. Pour ceux qui ont également besoin des données de l'agence et de l'accessibilité SEPA, l'étape suivante est IBAN Advanced.