IBAN Start

IBAN Start è il servizio API che verifica la validità di un IBAN e restituisce i dati essenziali della banca associata. Ogni richiesta controlla formato, cifre di controllo ed esistenza dell'istituto bancario, così puoi intercettare coordinate errate prima che diventino un pagamento respinto o un rimborso bloccato. Si integra in pochi passaggi in gestionali, CRM, e-commerce e flussi di onboarding, e automatizza un controllo che oggi spesso viene fatto a mano.

COSA PUOI FARE CON IBAN START

IBAN Start è pensato per chi ha bisogno di una risposta chiara a una domanda semplice: questo IBAN è valido, e di quale banca è?

DATI DELLA BANCA

Quando l'IBAN risulta valido, il servizio restituisce le informazioni principali dell'istituto associato, utili per completare anagrafiche di clienti e fornitori senza inserimenti manuali:

VERIFICA IBAN

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

ESEMPIO RICHIESTA

POST/iban-start/{iban}

Questo è un esempio di richiesta per verificare un IBAN:

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

È 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": "IT60X0542811101000000123456",
    "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-start/{id}, passando l'ID ricevuto nella richiesta precedente. Con l'endpoint GET/iban-start puoi invece consultare l'elenco di tutte le tue richieste, filtrandole per stato.

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": "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": []
  },
  "success": true,
  "message": "",
  "error": null
}

A CHI È RIVOLTO

IBAN Start è pensato per tutte le realtà che raccolgono coordinate bancarie e vogliono essere sicure che siano corrette prima di usarle. Per gli e-commerce e le piattaforme in abbonamento, la verifica integrata nel momento in cui l'utente inserisce l'IBAN riduce errori di battitura, rimborsi non andati a buon fine e richieste di correzione al servizio clienti.

Negli uffici amministrativi, contabili e HR, il servizio aiuta a mantenere pulite le anagrafiche di clienti, fornitori e dipendenti: ogni nuovo IBAN viene controllato in automatico e completato con nome della banca, codice SWIFT e codice ABI, senza ricerche manuali. Allo stesso modo, i flussi di onboarding di FinTech, marketplace e piattaforme di servizi possono validare i dati bancari già in fase di registrazione.

Infine, IBAN Start è uno strumento utile per sviluppatori, software house e aziende SaaS che vogliono aggiungere la verifica IBAN ai propri gestionali, CRM o ERP con un'integrazione semplice, gestendo i risultati tramite callback o interrogando l'API quando serve. Per chi ha bisogno anche dei dati di filiale e della raggiungibilità SEPA, il passo successivo è IBAN Advanced.