ACH-Lastschriftzahlungen annehmen
Vorsicht
Stripe passt die den Kund/innen angezeigten Zahlungsmethoden automatisch an Währung, geltende Einschränkungen und andere Parameter an. Wir empfehlen Ihnen, Ihre Zahlungsmethoden im Dashboard zu konfigurieren und sich dabei an dem Artikel Zahlungen annehmen zu orientieren.
Wenn Sie weiterhin manuell einstellen möchten, welche Zahlungsmethoden im Bezahlvorgang angezeigt werden, können Sie sich an diesem Leitfaden orientieren (etwa für die Zahlungsannahme im Subscription mode). Ansonsten empfehlen wir unseren Artikel Zahlungsmethoden zum Dashboard migrieren.
Stripe-Nutzer/innen in den USA können Checkout im Zahlungsmodus verwenden, um Zahlungen per ACH-Lastschriftverfahren zu akzeptieren.
Eine Checkout-Sitzung repräsentiert die Details der Kaufabsicht Ihres Kunden/Ihrer Kundin. Sie erstellen eine Sitzung, wenn Ihr Kunde/Ihre Kundin für etwas bezahlen möchte. Nachdem Sie ihn/sie zu einer Checkout-Sitzung umgeleitet haben, präsentiert Stripe eine Zahlung, von der aus Ihr/e Kund/in seinen/ihren Kauf abschließen kann. Sobald Ihr/e Kund/in einen Kauf getätigt hat, wird er/sie zurück zu Ihrer Seite geleitet.
Mit Checkout können Sie eine Checkout-Sitzung mit us_bank_account
als Zahlungsmethode erstellen, um alle Zahlungsstatus bis zum Abschluss der Zahlung zu verfolgen und zu verarbeiten.
Notiz
Beim ACH-Lastschriftverfahren handelt es sich um eine Zahlungsmethode mit verzögerter Benachrichtigung. Dies bedeutet, dass Gelder nicht sofort nach der Zahlung verfügbar sind. Eine Zahlung benötigt in der Regel 4 Werktage bis zum Eingang auf Ihrem Konto.
Kompatibilität bestimmen
Für die Unterstützung von Zahlungen per ACH-Lastschrift muss eine Checkout-Sitzung alle folgenden Bedingungen erfüllen:
- Geben Sie alle Preise für alle Rechnungsposten in USD an (Währungscode
usd
).
Kundinnen/Kunden erstellen oder abrufenEmpfohlenServerseitig
Erstellen Sie ein Customer-Objekt, wenn Ihr/e Nutzer/in ein Konto bei Ihrem Unternehmen erstellt, oder rufen Sie einen bestehenden Kunden/eine bestehende Kundin ab, der/die diesem Nutzer/dieser Nutzerin zugeordnet ist. Wenn Sie die ID des Customer-Objekts mit Ihrer eigenen Darstellung eines Kunden/einer Kundin verknüpfen, können Sie die gespeicherten Angaben zur Zahlungsmethode später abrufen und verwenden. Geben Sie eine E-Mail-Adresse an, um die Optimierung für wiederkehrende Nutzer/innen von Financial Connections zu aktivieren.
Zahlung annehmen
Notiz
Erstellen Sie zunächst eine Integration, um mit Checkout Zahlungen anzunehmen, bevor Sie mit diesem Leitfaden fortfahren.
Diese Leitfäden führen Sie durch die Aktivierung des ACH-Lastschriftverfahrens und zeigen die Unterschiede zwischen der Annahme einer Kartenzahlung und der Verwendung dieser Zahlungsmethode.
ACH-Lastschriftverfahren als Zahlungsmethode aktivieren
Führen Sie bei der Erstellung einer neuen Checkout-Sitzung folgende Schritte aus:
- Fügen Sie
us_bank_account
zur Liste derpayment_method_types
hinzu. - Stellen Sie sicher, dass alle Ihre
line_items
die Währungusd
verwenden.
Bei der Erfassung von Zahlungsinformationen für Bankkonten wird standardmäßig Financial Connections verwendet, um das Konto Ihres Kunden/Ihrer Kundin sofort zu verifizieren, mit einer Ausweichoption für die manuelle Eingabe der Kontonummer und die Verifizierung von Testeinzahlungen. In der Financial Connections-Dokumentation erfahren Sie, wie Sie Financial Connections konfigurieren und auf zusätzliche Kontodaten zugreifen, um Ihre ACH-Integration zu optimieren. Beispielsweise können Sie Financial Connections verwenden, um den Kontostand zu prüfen, bevor Sie die ACH-Zahlung veranlassen.
Notiz
Um den Zugriff auf zusätzliche Daten auszudehnen, nachdem ein/e Kund/in sein/ihr Konto authentifiziert hat, muss er/sie das Konto mit erweiterten Berechtigungen erneut verknüpfen.
Wenn der/die Kund/in sich für die Verifizierung der Testeinzahlung statt Financial Connections entscheidet, sendet Stripe automatisch zwei kleine Einzahlungen auf das angegebene Bankkonto. Es kann 1-2 Werktage dauern, bis diese Einzahlungen auf dem Online-Auszug des Kunden/der Kundin erscheinen. Wenn das Eintreffen der Einzahlungen erwartet wird, erhält der/die Kund/in eine E-Mail mit einem Link, um diese Beträge zu bestätigen und das Bankkonto bei Stripe zu verifizieren. Nach abgeschlossener Verifizierung, wird mit der Verarbeitung der Zahlung begonnen.
Wir empfehlen, den Parameter payment_intent_data.setup_future_usage mit dem Wert off_session
aufzunehmen, wenn Sie eine Zahlungsmodus-Sitzung für ACH-Lastschriftverfahren erstellen, damit Sie Details zur Zahlungsmethode speichern können.
Wickeln Sie Ihre Bestellungen ab
Informieren Sie sich über das Abwickeln von Bestellungen, nachdem Sie eine Zahlung akzeptiert haben.
Da es sich beim ACH-Lastschriftverfahren um eine Zahlungsmethode mit verzögerter Benachrichtigung handelt, müssen Sie auch den Schritt Umgang mit Zahlungsmethoden mit verzögerter Benachrichtigung des Leitfadens ausführen.
Integration testen
Erfahren Sie, wie Sie Szenarien mit sofortigen Verifizierungen mithilfe von Financial Connections testen können.
Transaktions-E-Mails im Test-Modus senden
Nachdem Sie die Bankkontodetails erfasst und ein Mandat akzeptiert haben, senden Sie die Mandatsbestätigung und die Verifizierungs-E-Mails im Test-Modus. Geben Sie dazu im Feld payment_method_data.billing_details[email]
eine E-Mail im Format {any-prefix}+test_email@{any_domain}
an, wenn Sie die Details zur Zahlungsmethode erfassen.
Häufiger Fehler
Sie müssen Ihr Stripe-Konto aktivieren, bevor Sie diese E-Mails im Test-Modus auslösen können.
Test account numbers
Stripe stellt mehrere Testkontonummern und dazugehörige Token zur Verfügung, um sicherzustellen, dass Ihre Integration für Bankkonten mit manueller Eingabe für den Einsatz in einer Produktionsumgebung bereit ist.
Account number | Token | Routing number | Verhalten |
---|---|---|---|
000123456789 | pm_usBankAccount_success | 110000000 | Die Zahlung ist erfolgreich. |
000111111113 | pm_usBankAccount_accountClosed | 110000000 | Die Zahlung schlägt fehl, weil das Konto geschlossen ist. |
000111111116 | pm_usBankAccount_noAccount | 110000000 | Die Zahlung schlägt fehl, weil kein Konto gefunden wird. |
000222222227 | pm_usBankAccount_insufficientFunds | 110000000 | Die Zahlung schlägt aufgrund unzureichender Deckung fehl. |
000333333335 | pm_usBankAccount_debitNotAuthorized | 110000000 | Die Zahlung schlägt fehl, weil die Lastschriften nicht autorisiert sind. |
000444444440 | pm_usBankAccount_invalidCurrency | 110000000 | Die Zahlung schlägt aufgrund einer ungültigen Währung fehl. |
000666666661 | pm_usBankAccount_failMicrodeposits | 110000000 | Die Zahlung sendet keine Testeinzahlungen. |
000555555559 | pm_usBankAccount_dispute | 110000000 | Die Zahlung löst eine Zahlungsanfechtung aus. |
000000000009 | pm_usBankAccount_processing | 110000000 | Die Zahlung bleibt auf unbestimmte Zeit in Bearbeitung. Dies ist hilfreich beim Testen von PaymentIntent-Stornierungen. |
Bevor Testtransaktionen abgeschlossen werden können, müssen Sie alle Testkonten verifizieren, auf denen die Zahlung automatisch erfolgreich war oder fehlschlagen ist. Verwenden Sie dazu die nachstehenden Test-Mikroeinzahlungsbeträge oder Beschreibungscodes.
Testen von Mikroeinzahlungen und Beschreibungscodes
Um verschiedene Szenarien zu imitieren, verwenden Sie diese Mikroeinzahlungsbeträge oder 0,01 Beschreibungscodewerte.
Testeinzahlungswerte | 0.01 Beschreibungscodewerte | Szenario |
---|---|---|
32 and 45 | SM11AA | Simuliert die Verifizierung des Kontos. |
10 und 11 | SM33CC | Simuliert das Überschreiten der Anzahl zulässiger Verifizierungsversuche. |
40 und 41 | SM44DD | Simuliert ein Testeinzahlungs-Timeout. |
Zusätzliche Überlegungen
Fehlschlagen der Verifizierung einer Testeinzahlung
Wenn die Verifizierung eines Bankkontos mittels Testeinzahlungen noch aussteht, kann die Verifizierung durch die Kundin/den Kunden aus drei Gründen fehlschlagen:
- Die Testeinzahlungen haben das Kundenbankkonto nicht erreicht. (Dies weist in der Regel auf ein geschlossenes/nicht verfügbares Bankkonto oder eine falsche Kontonummer hin).
- Die Verifizierungsversuche des Kontos durch die Kundin/den Kunden sind 10 mal fehlgeschlagen. Wird diese Grenze überschritten, kann das Bankkonto nicht mehr verifiziert oder erneut verwendet werden.
- Die Kundin/der Kunde hat das Bankkonto nicht innerhalb der Frist von 10 Tagen verifiziert.
Wenn die Verifizierung des Bankkontos aus einem der genannten Gründe fehlschlägt, können Sie das Ereignis checkout.session.async_payment_failed
verarbeiten, um die Kundin/den Kunden zum Aufgeben einer neuen Bestellung aufzufordern.