IBAN Start

IBAN Start è il servizio API che consente di verificare la validità di un IBAN, ottenere i dati della banca associata e controllare la raggiungibilità nei circuiti SEPA. L'API permette di integrare controlli automatici sui dati bancari all’interno dei propri flussi applicativi, riducendo errori e migliorando l’affidabilità dei pagamenti.

COSA PUOI FARE CON IBAN START

Con IBAN Start puoi verificare automaticamente ogni IBAN inserito nei tuoi sistemi, controllandone struttura, checksum e validità complessiva. Il servizio restituisce anche informazioni dettagliate sulla banca, come nome, filiale, BIC e localizzazione.

Inoltre, grazie ai controlli SEPA, puoi sapere se un conto è abilitato a bonifici e addebiti diretti, evitando problemi nelle transazioni e migliorando i tuoi processi operativi.

VERIFICA IBAN

Il primo step consiste nell’avviare una richiesta tramite l’endpoint POST/iban-start/{iban}, che permette di iniziare la validazione.

ESEMPIO RICHIESTA

POST/iban-start/{iban}

Questo è un esempio di richiesta per verificare un IBAN:

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

È possibile passare anche un callback per ricevere automaticamente il risultato:

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

ESEMPIO RISPOSTA

POST/iban-start/{iban}

La risposta iniziale restituisce l’ID della richiesta e lo stato:

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

Recupero risultato IBAN

Per ottenere il risultato completo della verifica è possibile utilizzare l’endpoint GET/iban-start/{id}, passando l’ID ricevuto nella richiesta precedente.

ESEMPIO RICHIESTA

GET/iban-start/{id}

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

ESEMPIO RISPOSTA

GET/iban-start/{id}

Questo è un esempio di risposta completa con IBAN valido:

{
  "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
}

Il campo state indica lo stato della richiesta: NEW, WAIT o DONE.

A chi è rivolto

IBAN Start è rivolto a tutte le aziende e piattaforme che gestiscono pagamenti, coordinate bancarie o processi di onboarding e necessitano di dati affidabili fin dal primo inserimento.

È particolarmente utile per e-commerce, fintech, servizi SaaS e operatori che gestiscono bonifici o addebiti diretti, dove la correttezza dell’IBAN è fondamentale per evitare errori, ritardi o transazioni fallite.

Il servizio è ideale anche per chi vuole automatizzare i controlli sui dati bancari, ridurre attività manuali e migliorare l’esperienza utente, garantendo processi più veloci, sicuri ed efficienti.