FAQ dell’API IBAN-Test

L’API IBAN-Test è pensata per sviluppatori, e-commerce, prodotti SaaS e sistemi interni che devono verificare automaticamente IBAN, BIC o conti bancari.

Queste FAQ spiegano token Bearer, richieste, risposte JSON, quote e integrazioni comuni. Endpoint e parametri sono descritti nella Documentazione API.

Come si usa l’API IBAN-Test?

Come si costruisce una richiesta API?

Come si costruisce una richiesta API?

Trasmetti il token API come token Bearer nell’header HTTP.

Authorization: Bearer YOUR_API_TOKEN

URL di base:

https://www.iban-test.eu/api

Verifica di un IBAN:

GET /v2/iban/validate/{iban}
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/iban/validate/DE89%203704%200044%200532%200130%2000"

Verifica di un BIC:

GET /v2/bic/validate/{bic}
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/bic/validate/COBADEFFXXX"

Verifica di un conto bancario:

GET /v2/bank-account/validate?bankcode=37040044&accountnumber=532013000

Generazione di un IBAN:

GET /v2/iban/generate?countrycode=DE&bankcode=37040044&accountnumber=532013000

Trovi parametri, campi delle risposte e funzioni di prova nella Documentazione API.

Torna su

Quale formato di risposta usa l’API?

Che cosa restituisce l’API?

Che cosa restituisce l’API?

Tutti gli endpoint restituiscono JSON. Il risultato contiene error, code, message e i dettagli specifici dell’endpoint.

{
  "error": false,
  "code": 2100,
  "message": "IBAN is valid",
  "details": {}
}

A seconda dell’endpoint e del paese, i dettagli possono includere informazioni bancarie, BIC, risultati della verifica del conto o l’IBAN generato.

Per codici di stato, parametri e schemi di risposta aggiornati, consulta la Documentazione API.

Addebiti diretti SEPA: Core e B2B

La verifica dell’IBAN restituisce anche la partecipazione della banca agli schemi di addebito diretto SEPA, verificata nei registri dei partecipanti dell’EPC.

  • details.sepa.sddCore – Addebito diretto SEPA Core
  • details.sepa.sddB2b – Addebito diretto SEPA B2B

I due schemi vengono verificati separatamente. confirmed indica una corrispondenza univoca e attuale nel registro. unknown indica che non è stato possibile confermare la partecipazione; non significa che la banca non supporti lo schema.

La verifica riguarda la partecipazione della banca. Non conferma l’esistenza del conto, la sua idoneità all’addebito, un mandato o il buon esito di un incasso.

Campi SEPA ed esempi di risposta

Torna su

Perché il mio accesso API è bloccato?

Perché il mio accesso API è bloccato o disattivato?

Perché il mio accesso API è bloccato o disattivato?

Può accadere se hai esaurito la quota, se il token API non è valido o se viene rilevato un utilizzo sospetto o abusivo.

Se hai semplicemente esaurito la quota, attendi il prossimo rinnovo oppure scegli un piano con un volume di richieste maggiore.

Se l’accesso sembra bloccato per un altro motivo, contatta l’assistenza tramite il modulo di contatto.

Torna su

Posso integrare IBAN-Test nei moduli o nell’e-commerce?

Sì.

Sì. L’API IBAN-Test è progettata per le verifiche automatiche in moduli, e-commerce, prodotti SaaS, mandati SEPA e strumenti gestionali.

Puoi controllare le coordinate al checkout, durante la registrazione, prima di un addebito diretto o prima di importare grandi quantità di dati di pagamento.

In questo modo individui errori di battitura e coordinate non valide prima che causino pagamenti non riusciti o addebiti respinti.

Torna su