IBAN Start

IBAN Start ist der API-Service, mit dem Sie die Gültigkeit einer IBAN überprüfen, die zugehörigen Bankdaten abrufen und die Erreichbarkeit innerhalb der SEPA-Verfahren prüfen können. Die API ermöglicht es, automatische Prüfungen von Bankdaten in Ihre Anwendungsprozesse zu integrieren, Fehler zu reduzieren und die Zuverlässigkeit von Zahlungen zu verbessern.

WAS SIE MIT IBAN START TUN KÖNNEN

Mit IBAN Start können Sie jede in Ihre Systeme eingegebene IBAN automatisch überprüfen, indem Sie deren Struktur, Prüfziffer (Checksum) und Gesamtgültigkeit kontrollieren. Der Service liefert außerdem detaillierte Informationen über die Bank, wie Name, Filiale, BIC und Standort.

Darüber hinaus können Sie dank der SEPA-Prüfungen feststellen, ob ein Konto für Überweisungen und Lastschriften aktiviert ist, wodurch Transaktionsprobleme vermieden und Ihre operativen Prozesse verbessert werden.

IBAN-PRÜFUNG

Der erste Schritt besteht darin, eine Anfrage über den Endpoint POST/iban-start/{iban} zu starten, mit dem die Validierung eingeleitet wird.

BEISPIELANFRAGE

POST/iban-start/{iban}

Dies ist ein Beispiel für eine Anfrage zur Überprüfung einer IBAN:

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

Sie können auch einen Callback übergeben, um das Ergebnis automatisch zu erhalten:

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

BEISPIELANTWORT

POST/iban-start/{iban}

Die erste Antwort gibt die Anfrage-ID und den Status zurück:

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

IBAN-Ergebnis abrufen

Um das vollständige Prüfergebnis zu erhalten, können Sie den Endpoint GET/iban-start/{id} verwenden und die ID aus der vorherigen Anfrage übergeben.

BEISPIELANFRAGE

GET/iban-start/{id}

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

BEISPIELANTWORT

GET/iban-start/{id}

Dies ist ein Beispiel für eine vollständige Antwort mit einer gültigen IBAN:

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

Das Feld state gibt den Status der Anfrage an: NEW, WAIT oder DONE.

Für wen ist es gedacht

IBAN Start richtet sich an alle Unternehmen und Plattformen, die Zahlungen, Bankdaten oder Onboarding-Prozesse verwalten und von Anfang an zuverlässige Daten benötigen.

Es ist besonders nützlich für E-Commerce, Fintech, SaaS-Dienste und Betreiber, die Überweisungen oder Lastschriften abwickeln, bei denen die Korrektheit der IBAN entscheidend ist, um Fehler, Verzögerungen oder fehlgeschlagene Transaktionen zu vermeiden.

Der Service ist auch ideal für alle, die Prüfungen von Bankdaten automatisieren, manuelle Tätigkeiten reduzieren und die Benutzererfahrung verbessern möchten, indem schnellere, sicherere und effizientere Prozesse gewährleistet werden.