Eine Banküberweisung annehmen
Verwenden Sie die Payment Intents API, um Zahlungen per Banküberweisung anzunehmen.
Wenn Sie zum ersten Mal eine Zahlung per Banküberweisung von einem Kunden/einer Kundin annehmen, generiert Stripe ein virtuelles Bankkonto für diesen Kunden/diese Kundin, das Sie dann direkt mit ihm/ihr teilen können. Alle zukünftigen Zahlungen per Banküberweisung von diesem Kunden/dieser Kundin werden an dieses Bankkonto gesendet. In einigen Ländern stellt Ihnen Stripe auch eine eindeutige Überweisungsreferenznummer zur Verfügung, die Ihre Kund/innen bei jeder Überweisung angeben sollten, um den Abgleich der Überweisung mit ausstehenden Zahlungen zu erleichtern. Beachten Sie, dass in einigen Ländern die Anzahl virtueller Bankkontonummern, die Sie kostenlos erstellen können, begrenzt ist.
Eine Übersicht über die üblichen Schritte bei der Annahme einer Zahlung per Banküberweisung finden Sie im folgenden Sequenzdiagramm:
Umgang mit Unter- und Überzahlungen
Bei Zahlungen per Banküberweisung ist es möglich, dass Sie mehr oder weniger als den erwarteten Zahlungsbetrag erhalten. Wird zu wenig überwiesen, übernimmt Stripe zum Teil die Finanzierung eines offenen Payment Intent. Rechnungen werden jedoch nicht teilfinanziert und bleiben offen, bis die eingehenden Gelder den vollständigen Rechnungsbetrag decken.
Wenn der Kunde/die Kundin mehr als den erwarteten Betrag sendet, versucht Stripe, die eingehenden Gelder mit einer offenen Zahlung abzugleichen und den verbleibenden überschüssigen Betrag im Barguthaben des Kunden/der Kundin zu halten. Weitere Einzelheiten zu unserem Umgang mit dem Abgleich finden Sie im entsprechenden Abschnitt unserer Dokumentation.
Umgang mit mehreren offenen Zahlungen oder Rechnungen
Möglicherweise haben Sie mehrere offene Zahlungen oder Rechnungen, die per Banküberweisung bezahlt werden können. Als Standardeinstellung versucht Stripe, die Banküberweisung automatisch abzugleichen. Dazu verwenden wir Informationen wie den Referenzcode der Überweisung oder den überwiesenen Betrag.
Sie können den automatischen Abgleich deaktivieren und Zahlungen und Rechnungen selbst manuell abgleichen. Sie können das automatische Abgleichsverhalten pro Kunde/Kundin außer Kraft setzen, indem Sie den Abgleichsmodus auf manuell festlegen.
Vorsicht
Stripe passt die den Kundinnen/Kunden 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.
If you want to continue manually configuring the payment methods you present to your customers with Checkout, use this guide. Otherwise, update your integration to configure payment methods in the Dashboard.
Die Banküberweisung ist eine Zahlungsmethode für die einmalige Verwendung für Checkout, bei der Kundinnen/Kunden per Banküberweisung anhand der angezeigten Zahlungsanweisungen bezahlen. Bei Auswahl der Zahlung wird der/die Nutzer/in zu einer gehosteten Seite weitergeleitet, die Anleitungen für eine Banküberweisung und den Status der Überweisungszahlung anzeigt.
Bei Banküberweisungen handelt es sich auch um eine Zahlungsmethode mit verzögerter Benachrichtigung. Das bedeutet, dass Gelder nicht sofort nach der Zahlung verfügbar sind.
Vorsicht
Bank transfers aren’t available on Checkout Sessions that didn’t include an existing Customer object as part of the of the session creation request.
Kompatibilität bestimmen
Für die Unterstützung von Zahlungen per Bank Transfer muss eine Checkout-Sitzung alle folgenden Bedingungen erfüllen:
Die Preise sämtlicher Posten müssen in derselben Währung vorliegen. Falls Posten in verschiedenen Währungen vorhanden sind, muss für jede Währung eine separate Checkout-Sitzung erstellt werden.
Sie können nur einmalige Posten verwenden (Checkout-Sitzungen mit Banküberweisung unterstützen keine wiederkehrenden Abonnementpläne).
Zahlung akzeptieren
Notiz
Erstellen Sie zunächst eine Integration, um mit Checkout Zahlungen anzunehmen, bevor Sie mit diesem Leitfaden fortfahren.
Verwenden Sie diese Anleitung, um Bank Transfer zu aktivieren.
Kunden erstellen und abrufen
Sie müssen ein Kundenobjekt zuordnen, um jede Banküberweisungszahlung abzugleichen. Wenn Sie bereits über ein Kundenobjekt verfügen, können Sie diesen Schritt überspringen. Erstellen Sie andernfalls ein neues Kundenobjekt.
Bank Transfer als Zahlungsmethode aktivieren
Führen Sie bei der Erstellung einer neuen Checkout-Sitzung folgende Schritte aus:
customer
einrichten- Fügen Sie
customer_
der Liste derbalance payment_
hinzu.method_ types - Stellen Sie sicher, dass für alle
line_
die gleiche Währung verwendet wird.items
An die von Stripe gehostete Anweisungsseite für Banküberweisungen weiterleiten
Notiz
Anders als bei Kartenzahlungen werden die Kundinnen/Kunden bei Zahlungen per Banküberweisung nicht zur success_url weitergeleitet.
Nach erfolgreichem Einreichen des Checkout-Formulars,
- Wenn das Kundenguthaben bereits ausreicht, um den angeforderten Betrag zu decken, ist die Zahlung sofort erfolgreich und der Kunde/die Kundin wird zur success_url weitergeleitet.
- Wenn das Kundenguthaben nicht ausreicht, um den angeforderten Betrag zu begleichen, wird der Kunde/die Kundin an die hosted_instructions_url weitergeleitet. Die Seite enthält die Anweisungen, die Ihre Kundinnen und Kunden durch den Überweisungsvorgang führen.
Auf der Seite mit den Branding-Einstellungen können Sie die Nutzeroberfläche für Ihre Kund/innen anpassen. Folgende Anpassungen sind für die gehostete Anweisungsseite möglich:
- Symbol: Ihr Markenlogo und Unternehmensname
- Markenfarbe: Hintergrundfarbe
Ihre Bestellungen ausführen
Because bank transfer is a delayed notification payment method, you need to use a method such as webhooks to monitor the payment status and handle order fulfillment. Learn more about setting up webhooks and fulfilling orders.
Die folgenden Ereignisse werden gesendet, wenn sich der Zahlungsstatus ändert:
Ereignisname | Beschreibung | Nächste Schritte |
---|---|---|
checkout.session.completed | Der/die Kund/in hat das Bezahlformular erfolgreich übermittelt und wird auf hosted_ umgeleitet. | Warten Sie, bis der/die Kund/in die Banküberweisung durchführt. |
checkout.session.async_payment_succeeded | Die/die Kund/in hat die Banküberweisung erfolgreich abgeschlossen. Der PaymentIntent geht in den Status succeeded über. | Führen Sie den Waren- bzw. Dienstleistungsauftrag aus. |
Integration testen
Sie können Ihre Integration testen, indem Sie eine eingehende Banküberweisung mit der API, dem Dashboard oder einer Beta-Version der Stripe-CLI simulieren.