IBAN Advanced

IBAN Advanced è il servizio API progettato per verificare in tempo reale la validità di un IBAN, estrarre l'anagrafica completa della banca e della filiale associate e controllare la raggiungibilità nei circuiti SEPA, inclusi i bonifici istantanei. Grazie a un'infrastruttura solida e sempre disponibile, l'API consente di automatizzare i controlli sui dati bancari, eliminando errori umani e garantendo l'integrità dei pagamenti.

COSA PUOI FARE CON IBAN ADVANCED

IBAN Advanced non si limita a una semplice validazione formale, ma offre un set completo di strumenti per la gestione sicura delle coordinate bancarie:

DATI BANCARI DETTAGLIATI

Oltre alla validazione, il servizio permette di ottenere informazioni complete dell'istituto finanziario, fornendo dati essenziali per la fatturazione e la logistica:

VERIFICA IBAN

Il primo step consiste nell'avviare una richiesta tramite l'endpoint POST/iban-advanced/{iban}, che permette di iniziare la validazione. Per i test è disponibile l'ambiente sandbox test.trust.openapi.com.

ESEMPIO RICHIESTA

POST/iban-advanced/{iban}

Questo è un esempio di richiesta per verificare un IBAN:

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

È possibile passare anche un callback per ricevere automaticamente il risultato sul proprio server. Il callback supporta header personalizzati (ad esempio per l'autenticazione) e fino a 5 tentativi automatici in caso di errore temporaneo:

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

ESEMPIO RISPOSTA

POST/iban-advanced/{iban}

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

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

STATI DELLA RICHIESTA

La verifica viene elaborata tramite un sistema di code asincrono. Ogni richiesta attraversa questi stati:

RECUPERO RISULTATO IBAN

Per ottenere il risultato completo della verifica è possibile utilizzare l'endpoint GET/iban-advanced/{id}, passando l'ID ricevuto nella richiesta precedente. Con l'endpoint GET/iban-advanced puoi invece consultare l'elenco di tutte le tue richieste, filtrandole per stato.

ESEMPIO RICHIESTA

GET/iban-advanced/{id}

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

ESEMPIO RISPOSTA

GET/iban-advanced/{id}

Questo è un esempio di risposta completa con IBAN valido:

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

A CHI È RIVOLTO

Il servizio IBAN Advanced è progettato per rispondere alle esigenze di un mercato digitale dove la precisione del dato finanziario è un asset strategico. Per gli E-commerce e le piattaforme digitali, l'integrazione della convalida in tempo reale trasforma radicalmente l'esperienza di acquisto: i sistemi automatizzati intercettano eventuali errori di battitura non appena l'utente inserisce le coordinate bancarie, blindando il processo di checkout ed evitando costosi rimborsi o ritardi nella sottoscrizione dei servizi.

All'interno dei dipartimenti finanziari, contabili e degli uffici HR, lo strumento diventa un alleato quotidiano per la gestione amministrativa: ogni IBAN viene verificato in automatico e completato con i dati di banca e filiale, mantenendo aggiornate le anagrafiche di clienti, fornitori e dipendenti. Allo stesso modo, le aziende che gestiscono pagamenti e addebiti SEPA e le realtà FinTech trovano in IBAN Advanced una risorsa indispensabile: sapere in anticipo se un conto è raggiungibile tramite bonifico, addebito diretto o bonifico istantaneo permette di scegliere il canale di pagamento corretto ed evitare transazioni respinte.

Infine, la robustezza tecnica del servizio parla direttamente a sviluppatori e aziende IT. L'architettura API è pensata per una scalabilità totale e un'integrazione fluida nei gestionali esistenti tramite protocolli standard. Questo livello di affidabilità è fondamentale per i business SaaS con processi critici, che necessitano di un'infrastruttura resiliente e sempre disponibile per gestire volumi elevati di validazioni senza mai interrompere l'operatività aziendale.