Zum Hauptinhalt springen
Die Bankverifizierung lässt niemanden feststecken. Während der Schritt auf die Person wartet, kann sie jederzeit Ohne Ihre Bank fortfahren wählen, und der Schritt zeigt dies an, sobald für ihr Land oder ihre Bank keine Methode funktioniert. Die Sitzung folgt dann dem Ergebnis, das Sie für diesen Fall festgelegt haben, standardmäßig einer Prüfung. Wenn ein fehlgeschlagener Versuch den letzten Versuch aller weiterhin angebotenen Methoden verbraucht, einschließlich eines Kontoauszug-Uploads, wartet der Schritt nicht: Er wird automatisch beendet und folgt bank_attempts_exhausted_action, standardmäßig einer Ablehnung, es sei denn, ein früherer Versuch hat bereits eine Entscheidung erreicht, wie etwa eine Namensabweichung. Diese Entscheidung bleibt dann bestehen. Diese Seite beschreibt die alternativen Verifizierungsmethoden, die die einzelnen Länder anbieten, wann die Person Ohne Ihre Bank fortfahren sieht, wie in den einzelnen Fällen entschieden wird und wie dies im Ergebnis nachzulesen ist.

Die Wege zur Verifizierung

Die Person beginnt mit dem Bank-Sign-in oder dem Konto-Check in der Reihenfolge, die Sie für das jeweilige Land festgelegt haben: siehe Methoden nach Land auswählen. Der Kontoauszug-Upload und die Mikroeinzahlungen sind Fallbacks nach diesen beiden Optionen. Ohne Ihre Bank fortfahren kommt als Letztes. Eine Methode, die in einem Land nicht genutzt werden kann, wird der Person dort niemals angeboten. In der Konsole zeigt Länder und Methoden dies für das jeweilige Land als Nicht verfügbar an.

Ein Land ohne Bank-Route

Ein Land, für das weder für das Bank-Sign-in noch für den Konto-Check eine Route verfügbar ist, bleibt im Schritt enthalten. Personen aus diesem Land laden einen Kontoauszug hoch, sofern der Schritt dies anbietet, oder fahren ohne Bank fort. Ein Speichervorgang behält ein solches Land bei, wenn methods weggelassen oder auf null gesetzt wird. In methods kann keine Methode aufgeführt werden, da dort keine Route eine unterstützt: Ein Speichern wird in diesem Fall abgelehnt, beispielsweise mit Account check is not available in VNM. Eine leere Liste wird ebenfalls abgelehnt, wie in jedem aktivierten Land, mit Choose a method: bank sign-in, account check, or both. Wenn Ihr Vertrag eigene Preise vorsieht und den Kontoauszug-Upload nicht enthält, wird ein Speichervorgang, der diesen ohne vorherigen Bankversuch anbietet, für ein solches Land ebenfalls abgewiesen.
Hier steht Vietnam stellvertretend für ein Land, das von keiner Bank-Route bedient wird. Es setzt keine methods, sodass der Speichervorgang es beibehält, und die Personen sehen den Kontoauszug-Upload sowie Ohne Ihre Bank fortfahren.

Der Kontoauszug-Upload

Beim Kontoauszug-Upload wird um einen Kontoauszug der letzten 3 Monate gebeten, der den Namen der Person, ihre Bank und die Kontonummer ausweist. Didit liest das Dokument aus, prüft es auf Bearbeitungen und gleicht den Namen des Kontoinhabers genauso ab wie bei einer Bankverbindung. Wenn bank_statement_enabled aktiviert ist, bietet der Schritt dies in zwei Fällen an:
  • Nach einem abgerechneten Versuch: Sobald ein Bank-Sign-in oder ein Konto-Check in derselben Sitzung abgerechnet wurde, steht der Kontoauszug-Upload als Fallback ohne Aufpreis zur Verfügung.
  • Ohne vorherigen Bankversuch: In jedem Land, einschließlich Ländern ohne Bank-Route. Dies erfordert bank_statement_standalone_enabled, was standardmäßig aktiviert ist. Deaktivieren Sie diese Option, um den Kontoauszug-Upload nur nach einem abgerechneten Versuch anzubieten.
Der Kontoauszug-Upload und die Mikroeinzahlungen verbrauchen jeweils einen der im Schritt konfigurierten bank_max_attempts, dieselben Versuche, die auch das Bank-Sign-in nutzt. Sobald die Person alle Versuche aufgebraucht hat, wird keine der beiden Optionen mehr angeboten, selbst nach einem abgerechneten Versuch. Der Konto-Check verfügt über eigene bank_account_check_max_attempts. Wenn er also die einzige Methode ist, kann eine Person, die alle Versuche für den Konto-Check aufgebraucht hat, weiterhin einen Kontoauszug hochladen, sofern der Schritt dies anbietet. Wenn ein fehlgeschlagener Versuch den letzten Versuch aller Methoden, die der Person noch angeboten werden, verbraucht, einschließlich eines Kontoauszug-Uploads, endet der Schritt von selbst: Die Person wird nicht zum Fortfahren aufgefordert, und das Ergebnis erfasst keine Fortsetzung. Die Sitzung folgt bank_attempts_exhausted_action, es sei denn, ein früherer Versuch hat bereits eine Entscheidung erreicht, wie etwa eine Namensabweichung; diese Entscheidung bleibt dann bestehen. Um Spielraum für einen Fallback nach einem fehlgeschlagenen Bank-Sign-in zu lassen, setzen Sie bank_max_attempts auf 2 oder höher.

Wann die Person „Ohne Bank fortfahren“ sieht

bank_continue_without_bank legt fest, wann der Schritt Ohne Bank fortfahren anzeigt: Keiner der beiden Werte deaktiviert die Option: Die Person kann immer fortfahren. Legen Sie dies in der Konsole im Bankverifizierungsschritt unter Wenn die Person nicht verifizieren kann als Ohne Bank fortfahren anzeigen fest: Wenn nichts anderes funktioniert oder Von Anfang an.

Was die Person sieht

  • Keine Route in ihrem Land: zum Beispiel „Wir können uns noch nicht mit Banken in Vietnam verbinden“, mit dem Kontoauszug-Upload unter Andere Möglichkeiten zur Verifizierung und Ohne Bank fortfahren.
  • Eine Bank, die hier nicht verwendet werden kann: „Diese Bank kann hier nicht verwendet werden“. Die Person kann ihre Kontodaten eingeben, sofern das Land die Kontoprüfung anbietet, einen Kontoauszug hochladen, eine andere Bank wählen oder ohne ihre Bank fortfahren.
  • Kein Online-Banking oder eine Bank, die nicht aufgeführt ist: „Verifizieren Sie Ihr Konto auf andere Weise“, mit den vom Land angebotenen Wegen und Ohne Bank fortfahren.
  • Eine Bank, die gerade nicht erreichbar ist: Die Person kann es erneut versuchen. Der Bildschirm bietet auch Ohne Bank fortfahren an, sobald die andere Methode – Bank-Anmeldung oder Kontoprüfung – nicht weiterhelfen kann: Ihr Land bietet sie nicht an, es sind keine Versuche mehr übrig oder der letzte Versuch konnte die Bank ebenfalls nicht erreichen.
  • Nach dem Fortfahren: „Vielen Dank, Sie können fortfahren“. Der Person wird nie ein Fehler angezeigt, und sie gelangt zum nächsten Schritt Ihres Workflows.

Ergebnis auswählen

Wenn die Person ohne Bank fortfährt, ermittelt Didit anhand der Vorgänge im Schritt den Grund dafür. Es übernimmt niemals einen Grund vom Gerät der Person. Jeder Grund, der als continuation.reason erfasst wird, folgt seiner eigenen Ergebniseinstellung:
  • no_route: Keine Route für Bank-Anmeldung oder Kontoprüfung deckt ihr Land ab. Geregelt durch bank_unsupported_action, standardmäßig REVIEW, mit dem Reason-Code NOT_COVERED.
  • institution_unsupported: Die ausgewählte Bank kann in diesem Schritt nicht verwendet werden. Geregelt durch bank_unsupported_action, standardmäßig REVIEW, mit dem Reason-Code NOT_COVERED.
  • attempts_exhausted: Alle Versuche waren bereits aufgebraucht und keiner war mehr im Gange, als fortgefahren wurde. Geregelt durch bank_attempts_exhausted_action, standardmäßig DECLINE.
  • person_choice: Es stand eine Verifizierungsmethode zur Verfügung, und die Person hat sich entschieden fortzufahren. Dies schließt eine Bank ein, die gerade nicht erreichbar war: Die Bank ist abgedeckt, weshalb die eigene Entscheidung der Person der Grund ist. Geregelt durch bank_skipped_action, standardmäßig REVIEW, mit dem Reason-Code SKIPPED.
bank_skipped_action und bank_attempts_exhausted_action akzeptieren REVIEW oder DECLINE. bank_unsupported_action akzeptiert zusätzlich NO_ACTION, was den Schritt genehmigt und dennoch NOT_COVERED erfasst. In der Konsole sind dies die Zeilen Bank oder Land nicht abgedeckt, Ohne Bank fortgefahren und Versuche aufgebraucht im Tab Ergebnisse des Schritts.
Das Fortfahren ersetzt niemals ein Ergebnis, das ein Versuch bereits erzielt hat. Wenn ein Versuch bereits ausgewertet wurde – beispielsweise wenn die Bank oder ein Kontoauszug einen nicht übereinstimmenden Kontoinhaber zurückgegeben hat und die Person noch Versuche übrig hatte, oder wenn eine knappe Übereinstimmung nicht bestätigt wurde –, behält der Schritt dieses Ergebnis und seine Reason-Codes bei. In diesem Fall greift keine Ergebniseinstellung aus der obigen Liste, und es wird weder NOT_COVERED noch SKIPPED hinzugefügt. Das Ergebnis erfasst dennoch, dass die Person fortgefahren ist: siehe Im Ergebnis ablesen.

Im Ergebnis nachlesen

Entscheidung und Webhooks

Der Eintrag des Schritts in bank_verifications[], in der Sitzungsentscheidung und im decision-Objekt von status.updated-Webhooks, gibt an, dass die Person ohne Bank fortgefahren ist:
  • continued_without_bank ist true: Die Person hat den Schritt über Ohne Bank fortfahren verlassen.
  • method ist none, wenn kein Versuch ausgewertet wurde, bevor die Person fortgefahren ist. Nach einem ausgewerteten Versuch, wie etwa einem nicht übereinstimmenden Kontoinhaber, bleibt method die Methode dieses Versuchs, und dessen Ergebnis bleibt bestehen.
  • continuation gibt an, wie die Person fortgefahren ist:
    • reason: no_route, institution_unsupported, attempts_exhausted oder person_choice.
    • country: das Land, in dem die Person ihre Verifizierung durchführte, ISO 3166-1 alpha-3, oder null, wenn sie fortgefahren ist, bevor sie eines ausgewählt hat.
    • offered: die anderen Verifizierungsmethoden, die für dieses Land angeboten wurden, in der Reihenfolge des Angebots: statement, dann microdeposits. Leer, wenn keine angeboten wurden.
    • institution_id und institution_name: bei institution_unsupported die Bank, die die Person nicht nutzen konnte: die Bank, die sie ausgewählt hat, oder die Bank, bei der ihr letzter Versuch endete. Didit übernimmt beide aus seiner eigenen Liste von Banken, niemals vom Gerät der Person; für eine Bank, die nicht in dieser Liste enthalten ist, werden daher beide auf null gesetzt. Bei jedem anderen Grund sind beide null.
    • continued_at: wann die Person fortgefahren ist.
  • reason_codes enthält NOT_COVERED oder SKIPPED, wie unter Ergebnis auswählen beschrieben, wenn die Fortsetzung die Entscheidung für den Schritt getroffen hat. Nach einem ausgewerteten Versuch behält es die Ursachencodes dieses Versuchs bei.
  • not_covered ist true bei no_route und institution_unsupported.
Das Beispiel zeigt nur die Felder, die auf dieser Seite behandelt werden. Alle Felder befinden sich im BankVerificationResult-Schema der API-Referenz. Wenn Ihr Workflow die zurückgegebenen Daten einschränkt, werden continued_without_bank und continuation.reason weiterhin zurückgegeben, sodass Sie weiterhin zwischen no_route und institution_unsupported unterscheiden können, die sich NOT_COVERED teilen. Jeder andere Schlüssel von continuation ist dann null: das Land, die Bank, was angeboten wurde und wann. continuation selbst ist null, wenn die Person nicht fortgefahren ist. method wird dann ebenfalls nicht zurückgegeben; lesen Sie daher continued_without_bank aus, nicht method, um zu erfahren, dass die Person fortgefahren ist.

Workflow-Regeln

Verzweigungen und benutzerdefinierte Statusregeln können Folgendes auslesen:
  • bank.continued_without_bank: true oder false.
  • bank.continue_reason: no_route, institution_unsupported, attempts_exhausted oder person_choice.
  • bank.method: none, wenn die Person ohne eine Bank fortgefahren ist, bevor ein Versuch ausgewertet wurde. Nach einem ausgewerteten Versuch wird die Methode dieses Versuchs verwendet.

Sitzungsbericht

Wenn die Person ohne eine Bank fortgefahren ist, bevor ein Versuch ausgewertet wurde, lautet die Zeile Verifizierungsmethode im PDF-Sitzungsbericht Ohne Bank fortgefahren. Nach einem ausgewerteten Versuch nennt sie die Methode dieses Versuchs.

Preise

  • Ohne Bank fortfahren wird nie in Rechnung gestellt. Versuche, die die Person vor dem Fortfahren unternommen hat, werden wie gewohnt abgerechnet.
  • Ein Kontoauszug-Upload ohne vorherigen kostenpflichtigen Bankversuch kostet $0.20 pro von Didit gelesenem und ausgewertetem Auszug. Er wird auf einer eigenen Nutzungsposition abgerechnet, Bank verification - statement upload (bank_statement_upload), und Ihr Vertragstarif oder Sonderpreis gilt dafür wie für jedes Add-on. Wenn Ihr Vertrag eigene Preise festlegt und diesen nicht enthält, bietet der Schritt ihn nicht an.
  • Ein Kontoauszug-Upload oder Mikroeinzahlungen nach einer kostenpflichtigen Bankanmeldung oder Kontoüberprüfung in derselben Sitzung sind ohne Aufpreis enthalten.

Knoten, die vor „Ohne Bank fortfahren“ gespeichert wurden

bank_allow_skip wurde eingestellt. Ein damit gespeicherter Knoten läuft jetzt mit dem von ihm bezeichneten Wert: Ein Knoten, der das Überspringen nicht erlaubte, ließ eine Person früher ohne Ausweg zurück, wenn nichts funktionierte. In diesen Fällen zeigt er nun Ohne Bank fortfahren an, und bank_unsupported_action, bank_attempts_exhausted_action oder bank_skipped_action entscheidet über die Sitzung. Für ein Release legt ein Speichervorgang, der bank_allow_skip, aber kein bank_continue_without_bank sendet, den Modus weiterhin anhand dieses Werts fest. Jeder Speichervorgang schreibt bank_allow_skip zurück: true für from_start, false für when_needed. Verwenden Sie in neuen Integrationen bank_continue_without_bank.

In der Sandbox testen

Eine Sandbox-Anwendung rechnet nichts ab, und der Kontoauszug-Upload sowie die Mikroeinzahlungen erfordern keinen vorherigen Bankversuch. Setzen Sie bank_continue_without_bank auf from_start, um Ohne Bank fortfahren auf dem ersten Bildschirm zu sehen, und wählen Sie es aus, um bank_skipped_action zu testen. Siehe Sandbox-Tests für Informationen dazu, wie Sandbox-Anwendungen im Allgemeinen funktionieren.

Verwandte Themen

Zuletzt geändert am 7. November 2026