IBAN Start

IBAN Start est le service API qui permet de vérifier la validité d’un IBAN, d’obtenir les données de la banque associée et de contrôler son accessibilité dans les schémas SEPA. L’API permet d’intégrer des contrôles automatiques des données bancaires au sein de vos flux applicatifs, en réduisant les erreurs et en améliorant la fiabilité des paiements.

CE QUE VOUS POUVEZ FAIRE AVEC IBAN START

Avec IBAN Start, vous pouvez vérifier automatiquement chaque IBAN saisi dans vos systèmes en contrôlant sa structure, sa clé de contrôle (checksum) et sa validité globale. Le service fournit également des informations détaillées sur la banque, telles que le nom, l’agence, le BIC et la localisation.

De plus, grâce aux contrôles SEPA, vous pouvez savoir si un compte est habilité aux virements et aux prélèvements automatiques, en évitant les problèmes de transaction et en améliorant vos processus opérationnels.

VÉRIFICATION IBAN

La première étape consiste à lancer une requête via l’endpoint POST/iban-start/{iban}, qui permet de démarrer la validation.

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/IT60X0306905020000000123456

Il est également possible de passer un callback pour recevoir automatiquement le résultat :

{
  "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 retourne l’ID de la requête et son statut :

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

Récupération du résultat IBAN

Pour obtenir le résultat complet de la vérification, vous pouvez utiliser l’endpoint GET/iban-start/{id}, en passant l’ID reçu lors de la requête précédente.

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 avec un IBAN valide :

{
  "data": {
    "id": "69c117af962df6cee50c9525",
    "iban": "IT60X0306905020000000123456",
    "state": "DONE",
    "status": "IBAN is valid",
    "bankData": {
      "bank": "Banca Italiana Test S.p.A.",
      "branch": "Roma Sede Centrale",
      "bic": "TESTITMMXXX",
      "city": "Roma",
      "country": "ITALY"
    },
    "sepaData": {
      "creditTransfer": true,
      "directDebit": true
    }
  },
  "success": true,
  "message": "",
  "error": null
}

Le champ state indique le statut de la requête : NEW, WAIT ou DONE.

À qui s’adresse-t-il

IBAN Start s’adresse à toutes les entreprises et plateformes qui gèrent des paiements, des coordonnées bancaires ou des processus d’onboarding et qui ont besoin de données fiables dès la première saisie.

Il est particulièrement utile pour le e-commerce, la fintech, les services SaaS et les opérateurs qui gèrent des virements ou des prélèvements automatiques, où l’exactitude de l’IBAN est essentielle pour éviter des erreurs, des retards ou des transactions échouées.

Le service est également idéal pour ceux qui souhaitent automatiser les contrôles des données bancaires, réduire les activités manuelles et améliorer l’expérience utilisateur, en garantissant des processus plus rapides, plus sûrs et plus efficaces.