Zum Hauptinhalt springen
Die Bankverifizierung bestätigt, dass ein Bankkonto der Person oder dem Unternehmen gehört, die bzw. das in einem früheren Schritt Ihres Workflows verifiziert wurde. Es handelt sich um einen einzelnen Workflow-Schritt mit zwei Methoden: Die Person meldet sich entweder bei ihrer Bank an oder gibt ihre Kontodaten ein, woraufhin die Bank den Namen des Kontoinhabers bestätigt. Sie wählen aus, welche Methoden für jedes Land angeboten werden und welche davon an erster Stelle steht.
In der Produktionsumgebung wird die Bank-Anmeldung in Nigeria und Neuseeland ausgeführt, und die Kontoüberprüfung läuft in Nigeria, Ghana und Kenia. Im Laufe der Zeit werden weitere Länder freigeschaltet, und die Preise für die Bankverifizierung zeigen stets den aktuellen Leistungsumfang pro Land.
Die Bankverifizierung vergleicht den Kontoinhaber mit einer Identität, die durch einen anderen Schritt festgestellt wurde; sie stellt für sich allein also keinen Identitätsnachweis dar. Platzieren Sie die Ausweisverifizierung, Datenbankvalidierung, einen Fragebogen oder expected_details vor diesem Schritt. Die Person gibt den zu prüfenden Namen niemals selbst ein: Didit vergleicht stets den Namen, den die Sitzung bereits verifiziert hat.

​
Die beiden Methoden

Beide Methoden liefern dieselbe Art von Ergebnis: ob der Kontoinhaber übereinstimmt, der von der Bank zurückgegebene Kontoinhaber sowie das maskierte Konto. Die Methoden unterscheiden sich je nach Land, und ein Land kann eine von beiden, beide oder beide in beliebiger Reihenfolge anbieten. Unter Kontoüberprüfung finden Sie die unterstützten Kontoformate, Ergebnisse und Sandbox-Werte. Das Hochladen von Kontoauszügen und Mikroüberweisungen bleiben Fallbacks nach den beiden Methoden (bank_statement_enabled, bank_microdeposits_enabled), und die Person kann den Vorgang stets auch ohne Bank fortsetzen. Mikroüberweisungen werden nur nach einer kostenpflichtigen Bank-Anmeldung oder Kontoüberprüfung in derselben Sitzung angeboten, ohne zusätzliche Kosten. Der Upload von Kontoauszügen ist danach ebenfalls enthalten und kann in jedem Land auch ohne vorherigen Bankversuch erfolgen. Siehe Wenn die Person ihr Bankkonto nicht verifizieren kann.

​
Was die Person sieht

In jedem Land beginnt die Person mit der ersten Methode, die das Land anbietet. Die zweite Methode dient als Absicherung:
  • Bank-Anmeldung zuerst: Die Bankauswahl öffnet sich. Der letzte Eintrag, Kontodaten eingeben, startet die Kontoüberprüfung. Schlägt die Bank-Anmeldung fehl, erscheint derselbe Eintrag erneut unter Andere Möglichkeiten zur Verifizierung.
  • Kontoüberprüfung zuerst: Das Kontoformular öffnet sich, darunter befindet sich der Link Stattdessen bei Ihrer Bank anmelden.
  • Nur eine Methode: Die Person sieht nur diese eine Option.
Bietet ein Land die Kontoüberprüfung an, dient diese auch als Fallback für eine Bank, die per Bank-Anmeldung derzeit nicht erreichbar ist, weil die Bank beeinträchtigt oder ausgefallen ist: Die Person wechselt zum Kontoformular, noch bevor eine Einwilligung eingeholt wird, solange ihr noch Kontoüberprüfungen zur Verfügung stehen. Eine Methode, für die in einem Land keine Route existiert, wird dort weggelassen, sodass die Person niemals eine Methode sieht, die nicht ausgeführt werden kann. Ein Land, für das überhaupt keine Route verfügbar ist, bietet lediglich seine Fallbacks und Ohne Bank fortfahren an.

​
Methoden pro Land auswählen

​
Reihenfolge des Schritts

bank_method_order legt fest, welche Methoden der Schritt anbietet und in welcher Reihenfolge – gültig für alle Länder, die keine eigene Konfiguration definieren. Der Parameter listet open_banking, account_lookup oder beides auf, wobei die primäre Methode zuerst genannt wird.
Wird beim Speichern kein bank_method_order übergeben, wird standardmäßig ["open_banking", "account_lookup"] gesetzt: Bank-Anmeldung zuerst, die Kontoüberprüfung als Ausweichoption. Eine leere Liste wird mit Choose a method: bank sign-in, account check, or both. abgelehnt. Die Schritt-Reihenfolge ist ein Standardwert. In einem Land, in dem keine Route eine dieser Methoden bedient, wird diese Methode ausgelassen, und das Land bietet die verbleibenden an. Ein Land, das von einer Route bedient wird, dem die Reihenfolge jedoch keine Methode zuweist, wird beim Speichern abgelehnt, beispielsweise mit Choose a method: bank sign-in, account check, or both. ARE offers account check. Ein Land, für das keinerlei Route existiert, bleibt erhalten, bietet jedoch nur seine Fallbacks an: siehe Ein Land, das von keiner Bank-Route bedient wird.

​
Eigene Reihenfolge eines Landes

methods bei einem Land in bank_countries überschreibt die Schritt-Reihenfolge für dieses spezifische Land. Die Person beginnt mit der ersten Methode, und die zweite wird ihr als Ausweichoption angeboten.
In diesem Beispiel folgt das Vereinigte Königreich der Schritt-Reihenfolge, Norwegen bietet nur die Bank-Anmeldung an und Mexiko beginnt mit der Kontoüberprüfung, wobei die Bank-Anmeldung als Fallback dient. Ein Land, bei dem methods auf null gesetzt ist oder dessen Schlüssel fehlt, folgt der Schritt-Reihenfolge. Die Speicherung wird unter bank_countries.<ISO3> abgelehnt, wenn ein aktiviertes Land:
  • methods auf eine leere Liste setzt, selbst in einem Land, das von keiner Route bedient wird, oder
  • eine Methode benennt, die dort von keiner Route bedient wird, beispielsweise Account check is not available in NOR.
Ein Land, für das überhaupt keine Route existiert, lässt methods weg oder setzt den Wert auf null und bietet nur seine Fallbacks an: siehe Ein Land, das von keiner Bank-Route bedient wird.

​
In der Konsole

Im Bankverifizierungsschritt führt Länder und Methoden jedes Land mit den dort verfügbaren Optionen für die Bank-Anmeldung und Kontoüberprüfung auf sowie mit der Angabe, welche Methode an erster Stelle steht. Die Voreinstellungen konfigurieren alle Länder auf einmal: Eine Voreinstellung lässt ein Land niemals ohne Option zurück: Verfügt ein Land nur über eine der beiden Methoden, bleibt diese aktiviert.

​
Finanzdaten erfordern Bankanmeldung

Nur die Bankanmeldung liest Kontostände, Transaktionen und Einkommen aus. Wenn der Schritt diese in bank_scopes anfordert und ein Land die Kontoprüfung anbietet, besteht eine Person, die sich per Kontoprüfung verifiziert, die Prüfung ohne diese Daten. Der Schritt schlägt nicht fehl: Das Ergebnis führt in financial_data.not_collected auf, was nicht erfasst wurde.
not_collected ist immer dann eine leere Liste, wenn die Methode alles erfasst hat, was der Schritt angefordert hat. Um die Daten vorauszusetzen, bieten Sie in den Ländern, in denen Sie sie benötigen, ausschließlich die Bankanmeldung an.

​
Einstellungen für die Kontoprüfung

Diese Schlüssel konfigurieren ausschließlich die Kontoprüfung. Die Bankanmeldung behält ihre eigenen Einstellungen. Versuche werden pro Methode gezählt. bank_max_attempts zählt Versuche der Bankanmeldung, und eine Mikroeinzahlung oder ein Kontoauszugs-Upload verbraucht ebenfalls einen davon. bank_account_check_max_attempts zählt Kontoprüfungen. Der Schritt endet mit bank_attempts_exhausted_action, sobald die Person bei jeder noch angebotenen Verifizierungsoption, einschließlich eines Kontoauszugs-Uploads, ihre Versuche ohne erfolgreiche Verbindung verbraucht hat: siehe Kontoauszugs-Upload.

​
Methode im Ergebnis auslesen

​
Entscheidung und Webhooks

Jeder Bankverifizierungsschritt ist ein Element von bank_verifications[] in der Sitzungsentscheidung und im decision-Objekt von status.updated-Webhooks. Dessen method gibt an, wie das Konto verifiziert wurde: method ist null, bis ein Konto bewertet wurde, und none, wenn die Person ohne Bank fortgefahren ist, bevor ein Versuch bewertet wurde: siehe Im Ergebnis auslesen. Lesen Sie method und nicht ownership.method aus, um die Methoden zu unterscheiden: ownership.method ist der Namensvergleich, der den Score erzeugt hat, wie etwa exact oder fuzzy.
Das Beispiel zeigt nur die Felder, die auf dieser Seite behandelt werden. Alle Felder finden Sie im SessionDecision-Schema der API-Referenz.

​
Workflow-Regeln

Verzweigungen und benutzerdefinierte Statusregeln lesen denselben Wert als bank.method aus, der im Regel-Builder als Bank Verification Method bezeichnet wird, mit den Werten Bank Sign-in, Account Check, Micro-deposits, Statement Upload und Continued Without a Bank. Eine Regel vergleicht den Methodenwert, beispielsweise eine Verzweigung nach einem AML-Screening-Schritt, die eine Kontoprüfung mit einem hohen Risiko-Score zur manuellen Prüfung weiterleitet:

​
Sitzungsbericht

Der PDF-Sitzungsbericht nennt die Methode in seiner Zeile Verifizierungsmethode.

​
Vor den Methoden gespeicherte Knoten

bank_open_banking_enabled und bank_account_lookup_enabled wurden eingestellt. Ein Knoten, der gespeichert wurde, bevor bank_method_order existierte, läuft nun mit der Reihenfolge, die sich aus seinen beiden Schaltern ergab: War die Kontoprüfung neben der Bankanmeldung aktiviert, sieht die Person sie nun als Ausweichoption in der Bankauswahl, Kontodaten eingeben, nicht nur, wenn ihre Bank nicht erreichbar ist. Ein Knoten, bei dem beide Schalter deaktiviert waren und der nur Mikroeinzahlungen oder einen Kontoauszugs-Upload anbot, bleibt unverändert; ein späteres Speichern muss mindestens eine der beiden Methoden aktivieren. Für ein Release legt ein Speichervorgang, der kein bank_method_order, aber einen der Schalter übermittelt, die Reihenfolge weiterhin anhand der Schalter fest. Jeder Speichervorgang schreibt beide Schalter zurück, je nachdem, ob irgendein Land die Bankanmeldung anbietet und ob irgendein Land die Kontoprüfung anbietet. Verwenden Sie in neuen Integrationen bank_method_order und bank_countries.<ISO3>.methods.

​
Preise

Jede Methode wird zu ihrem eigenen Preis pro Land abgerechnet. Unter Preise für die Bankverifizierung finden Sie die Preise für jedes Land.
  • Die Bankanmeldung hat einen eigenen Preis, und die Add-ons für Kontostände und Transaktionen werden jeweils zusätzlich berechnet.
  • Die Kontoprüfung wird einmal pro von der Bank beantworteter Prüfung abgerechnet: eine Übereinstimmung, eine nahe Übereinstimmung, keine Übereinstimmung, ein Konto, das nicht verifiziert werden konnte, und ein Konto, das nicht gefunden wurde. Ein Konto, das bereits bei der Eingabe abgelehnt wird, wird nie berechnet.
Bietet ein Land beide Methoden an, kann eine Sitzung je nach der von der Person genutzten Methode den einen oder den anderen Preis kosten. Der Kontoauszugs-Upload und Mikroeinzahlungen sind nach einem kostenpflichtigen Versuch ohne zusätzliche Kosten enthalten. Ein Kontoauszugs-Upload ohne vorherigen Bankversuch kostet $0.20, und das Fortfahren ohne Bank wird nie berechnet: siehe Preise. Die Kontoprüfungs-API führt dieselbe Prüfung von Ihrem Backend aus, ohne Sitzung, zum selben Preis für die Kontoprüfung durch.

​
In Sandbox testen

Eine Sandbox-Anwendung stellt beide Methoden in jedem Land in der vom Schritt festgelegten Reihenfolge bereit und berechnet nichts. Bei der Standardreihenfolge beginnt die Person mit der Bankanmeldung und wählt Kontodaten eingeben, um die Kontoprüfung auszuführen. Um mit der Kontoprüfung zu beginnen, setzen Sie bank_method_order auf ["account_lookup", "open_banking"]. Die letzten vier Zeichen des Kontos bestimmen die Antwort der Kontoprüfung: siehe In Sandbox testen.

​
Verwandte Themen

Zuletzt geändert am 7. November 2026