FAQ zur IBAN-Test API

Wie muss eine API-Anfrage aussehen?

Verwenden Sie Ihren API-Token als Bearer Token im HTTP-Header.

Authorization: Bearer IHR_API_TOKEN

Basis-URL:

https://www.iban-test.de/api/IbanTest

IBAN validieren:

GET /v2/iban/validate/{iban}

curl -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://www.iban-test.de/api/IbanTest/v2/iban/validate/DE89%203704%200044%200532%200130%2000"

BIC validieren:

GET /v2/bic/validate/{bic}

curl -H "Authorization: Bearer IHR_API_TOKEN" \
  "https://www.iban-test.de/api/IbanTest/v2/bic/validate/COBADEFFXXX"

Bankkonto validieren:

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

IBAN generieren:

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

Die vollständige technische Referenz mit Parametern, Antwortfeldern und Testmöglichkeit finden Sie in der API-Dokumentation.

Wie sieht die Antwort der API aus?

Alle API-Endpunkte geben JSON zurück. Das Ergebnis enthält die Felder error, code, message und je nach Endpunkt weitere Details.

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

Bei Validierungen können die Details unter anderem Informationen zur Bank, zur BIC, zur Kontoprüfung oder zum generierten IBAN-Ergebnis enthalten. Welche Felder genau zurückgegeben werden, hängt vom aufgerufenen Endpunkt und vom Land ab.

Die aktuelle Referenz für Statuscodes, Parameter und Antwortschemas finden Sie in der API-Dokumentation.

Warum ist mein API-Zugriff deaktiviert oder gesperrt?

Das kann passieren, wenn das verfügbare API-Kontingent erreicht wurde, wenn ein API-Token ungültig ist oder wenn auffällige beziehungsweise missbräuchliche Nutzung erkannt wurde.

Wenn nur das Kontingent erreicht wurde, können Sie auf die nächste Zurücksetzung warten oder auf ein Paket mit höherem Anfragevolumen wechseln.

Wenn Ihr Zugriff aus einem anderen Grund blockiert wirkt, kontaktieren Sie bitte den Support über das Kontaktformular.

Ja. Die IBAN-Test API ist für automatisierte Validierung in Formularen, Shops, SaaS-Produkten, SEPA-Mandaten und Backoffice-Prozessen gedacht.

Typische Einsatzfälle sind die Prüfung von Bankdaten beim Checkout, bei der Registrierung, vor einer Lastschrift oder vor dem Import größerer Zahlungsdatenbestände.

So erkennen Sie Tippfehler und ungültige Bankdaten früh, statt sie erst durch fehlgeschlagene Zahlungen oder Rücklastschriften zu bemerken.