Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenZahlungen verwalten
Zahlungsmethoden
Zahlungsschnittstellen
Zahlungsszenarien
Präsenzzahlungen
Andere Stripe-Produkte

Bankverbindung für Bacs-Lastschriftverfahren speichern

So können Sie Checkout nutzen, um Angaben zur Zahlungsmethode für künftige Zahlungen per Bacs-Lastschriftverfahren zu speichern.

Seite kopieren

Sie können Stripe Checkout verwenden, um Zahlungsinformationen für das Bacs-Lastschriftverfahren vorab zu erfassen. Der endgültige Betrag bzw. das Zahlungsdatum wird dabei später festgelegt. Mögliche Anwendungsszenarien:

Stripe einrichten
Serverseitig

Zunächst benötigen Sie ein Stripe-Konto. Registrieren Sie sich jetzt.

Nutzen Sie unsere offiziellen Bibliotheken für den Zugriff auf die Stripe-API über Ihre Anwendung:

Command Line
# Available as a gem
sudo gem install stripe
Gemfile
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Kund/in erstellen
Serverseitig

Um das BACS-Lastschriftverfahren bei späteren Zahlungen wiederzuverwenden, müssen Sie es bestimmten Kund/innen zuordnen. Erstellen Sie ein Kundenobjekt, wenn jemand ein Konto bei Ihrem Unternehmen anlegt. Verknüpfen Sie die ID des Kundenobjekts dann mit Ihrem internen Kundenabbild, um die gespeicherten Zahlungsdaten später erneut zu verwenden. Überspringen Sie diesen Schritt, wenn Sie bereits ein vorhandenes Kundenobjekt haben.

Command Line
curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Checkout-Sitzung erstellen
Clientseitig
Serverseitig

Bevor Sie Zahlungen per Lastschrift annehmen können, müssen Ihre Kundinnen/Kunden ihre Kontoinformationen zur Verfügung stellen und Sie autorisieren, die Abbuchung per Stripe Checkout von ihrem Konto vorzunehmen (dies wird auch als Lastschriftmandat bezeichnet).

Fügen Sie Ihrer Website eine Schaltfläche zum Bezahlen hinzu, über die ein serverseitiger Endpoint aufgerufen wird, um eine Checkout-Sitzung zu erstellen.

index.html
<html>
  <head>
    <title>Checkout</title>
  </head>
  <body>
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

Erstellen Sie eine Checkout-Sitzung im setup-Modus, um die erforderlichen Informationen zu erfassen. Leiten Sie Ihre Kundinnen/Kunden nach dem Erstellen der Checkout-Sitzung an die in der Antwort zurückgegebene URL weiter.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[]"="bacs_debit" \
  -d mode=setup \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d cancel_url="https://example.com/cancel"

Wenn Ihre Kund/innen ihre Angaben zur Zahlungsmethode machen, werden sie an die success_url weitergeleitet. Hierbei handelt es sich um eine Seite auf Ihrer Website, auf der Ihre Kund/innen darüber informiert werden, dass ihre Zahlungsmethode erfolgreich gespeichert wurde. Stellen Sie die Sitzungs-ID auf Ihrer Erfolgsseite zur Verfügung, indem Sie die Vorlagenvariable {CHECKOUT_SESSION_ID} wie im obigen Beispiel in die success_url einfügen.

Wenn Ihre Kund/innen in einer Checkout-Sitzung auf Ihr Logo klicken, ohne Angaben zur Zahlungsmethode zu machen, leitet Checkout sie über die cancel_url zurück zu Ihrer Website. In der Regel ist dies die Seite auf Ihrer Website, die die Kund/innen vor der Weiterleitung zu Stripe Checkout besucht haben.

Vorsicht

Verlassen Sie sich beim Erkennen von initiierten Zahlungen nicht allein auf die Weiterleitung auf die success_url:

  • Böswillige Nutzer/innen könnten, ohne zu bezahlen, direkt auf die success_url zugreifen und sich so unberechtigt Zugang zu Waren und Dienstleistungen verschaffen.
  • In manchen Fällen werden Kund/innen nach erfolgreicher Zahlung nicht zur success_url weitergeleitet. Möglicherweise haben sie die Registerkarte im Browser geschlossen, bevor die Weiterleitung erfolgt ist.

Notiz

Die Regeln zum Bacs-Lastschriftverfahren sehen vor, dass die Kundinnen/Kunden bei der Erfassung ihrer Zahlungsinformationen eine E-Mail-Benachrichtigung erhalten. Diese E-Mails versendet Stripe automatisch. Sie können aber auch Ihre eigenen Bacs-Benachrichtigungen versenden.

Zahlungsmethode abrufen
Serverseitig

Nachdem ein Kunde/eine Kundin seine/ihre Zahlungsdetails übermittelt hat, rufen Sie das PaymentMethod-Objekt ab. Eine PaymentMethod speichert die bank account-Informationen der Kundinnen und Kunden für spätere Zahlungen. Sie können die PaymentMethod synchron mit der success_url oder asynchron mithilfe von Webhooks abrufen.

Ob Sie die PaymentMethod synchron oder asynchron abrufen, hängt von Ihrer Toleranz gegenüber Kaufabbrüchen ab, da Kund/innen in manchen Fällen nach erfolgreicher Zahlung nicht zur success_url weitergeleitet werden. (Sie können beispielsweise die Registerkarte im Browser schließen, bevor die Weiterleitung erfolgt ist.) Die Verarbeitung von Webhooks verhindert diese Form von Kaufabbrüchen in Ihrer Integration.

Verarbeiten Sie checkout.session.completed-Webhooks, die ein Session-Objekt enthalten. Hier erfahren Sie mehr über das Einrichten von Webhooks. Beim folgenden Beispiel handelt es sich um eine checkout.session.completed-Antwort.

{
  "id": "evt_1Ep24XHssDVaQm2PpwS19Yt0",
  "object": "event",
  "api_version": "2019-03-14",
  "created": 1561420781,
  "data": {
    "object": {
      "id": "cs_test_MlZAaTXUMHjWZ7DcXjusJnDU4MxPalbtL5eYrmS2GKxqscDtpJq8QM0k",
      "object": "checkout.session",
      "billing_address_collection": null,
      "cancel_url": "https://example.com/cancel",
      "client_reference_id": null,
      "customer": null,
      "customer_email": null,
      "display_items": [],
      "mode": "setup",
      "setup_intent": "seti_1EzVO3HssDVaQm2PJjXHmLlM",
      "submit_type": null,
      "subscription": null,
      "success_url": "https://example.com/success"
    }
  },
  "livemode": false,
  "pending_webhooks": 1,
  "request": {
    "id": null,
    "idempotency_key": null
  },
  "type": "checkout.session.completed"
}

Notieren Sie den Wert des Schlüssels setup_intent, bei dem es sich um die ID für den mit der Checkout-Sitzung erstellten SetupIntent handelt. Ein SetupIntent ist ein Objekt, das verwendet wird, um die bank account-Informationen des Kunden/der Kundin für zukünftige Zahlungen einzurichten. Rufen Sie das SetupIntent-Objekt mit der ID ab.

Command Line
curl https://api.stripe.com/v1/setup_intents/seti_1EzVO3HssDVaQm2PJjXHmLlM \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Ereignisse nach Einrichtung verarbeiten
Serverseitig

Sobald die Checkout-Sitzung abgeschlossen ist, werden die Zahlungsinformationen als Mandat an die Bank übermittelt.

Das Mandat kann nach der Erteilung jederzeit geändert werden, wenn etwa die Kundinnen/Kunden ihre Bank anweisen, das Mandat zu ändern oder wenn sie zu einer anderen Bank wechseln. Bei Mandatsänderungen sendet Stripe die folgenden Ereignisse:

EreignisnameBeschreibungWerden Zahlungen akzeptiert?
mandate.updatedWird ausgegeben, wenn ein Mandat vom Bacs-Netzwerk abgelehnt, widerrufen oder wieder aktiviert wird. Unter mandate.status erfahren Sie, ob das Lastschriftmandat weiterhin verwendet werden kann.Ja, sofern der neue Status active ist
payment_method.automatically_updatedWird ausgegeben, wenn sich die kundenseitige Bankverbindung ändert.Ja

Sie können die Ereignisse in Ihrem Dashboard einsehen. Sie können einen Webhook einrichten, um diese programmatisch zu handhaben.

Integration testen

There are several test bank account numbers you can use in a sandbox to make sure this integration is ready.

BankleitzahlKontonummerBeschreibung
10880000012345Die Zahlung ist erfolgreich und der PaymentIntent von wird von processing auf succeeded umgestellt.
10880090012345Die Zahlung erfolgt innerhalb von drei Minuten und der PaymentIntent von wird von processing auf succeeded umgestellt.
10880033333335Die Zahlung wird akzeptiert, schlägt dann aber unmittelbar fehl. Die Fehlerkennung debit_not_authorized wird ausgegeben und PaymentIntent wird von processing auf requires_payment_method umgestellt. Das Mandat wechselt zu inactive und die PaymentMethod kann nicht erneut verwendet werden.
10880093333335Die Zahlung schlägt nach drei Minuten fehl. Die Fehlerkennung debit_not_authorized wird ausgegeben und der PaymentIntent wird von processing auf requires_payment_method umgestellt. Das Mandat wechselt zu inactive und die PaymentMethod kann nicht erneut verwendet werden.
10880022222227Die Zahlung schlägt fehl, die Fehlerkennung insufficient_funds wird ausgegeben und der PaymentIntent wird von processing auf requires_payment_method umgestellt. Das Mandat bleibt active und die PaymentMethod kann erneut verwendet werden.
10880092222227Die Zahlung schlägt nach drei Minuten fehl, die Fehlerkennung insufficient_funds wird ausgegeben und der PaymentIntent wird von processing auf requires_payment_method umgestellt. Das Mandat bleibt active und die PaymentMethod kann erneut verwendet werden.
10880055555559Die Zahlung erfolgt innerhalb von drei Minuten und der PaymentIntent wechselt von processing zu succeeded. Eine Zahlungsanfechtung wird jedoch sofort erstellt.
10880000033333Die Zahlungsmethode wurde erfolgreich erstellt, das Mandat wird jedoch von der Kundenbank verweigert und sofort deaktiviert.
10880000044444Die Anfrage zur Einrichtung eines Bacs-Lastschriftverfahrens wird aufgrund einer ungültigen Kontonummer sofort abgelehnt. Die Kund/innen werden aufgefordert, ihre Angaben vor dem Absenden zu prüfen. Zahlungsinformationen werden nicht erfasst.
10880034343434The payment fails with a charge_exceeds_source_limit failure code due to the payment amount causing the account to exceed its weekly payment volume limit.
10880012121212The payment fails with a charge_exceeds_weekly_limit failure code due to the payment amount exceeding the account’s transaction volume limit.

Sie können die oben aufgeführten Kontonummern nach Belieben testen. Da die Verarbeitung von Zahlungen per Bacs-Lastschriftverfahren mehrere Tage in Anspruch nimmt, verwenden Sie bitte die Testkontonummern. Bei diesen ist eine dreiminütige Verzögerung eingebaut, um tatsächliche Zahlungen möglichst exakt nachzubilden.

Notiz

By default, Stripe automatically sends emails to the customer when payment details are initially collected and each time a debit will be made on their account. These notifications aren’t sent in sandboxes.

Zahlungsmethode für künftige Zahlungen verwenden
Serverseitig

Wenn Sie eine PaymentMethod eingerichtet haben, können Sie künftige Zahlungen per Bacs-Lastschriftverfahren annehmen, indem Sie einen PaymentIntent erstellen und bestätigen.

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[]"="bacs_debit" \
  -d payment_method=
{{PAYMENT_METHOD_ID}}
 \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d confirm=true \
  -d amount=100 \
  -d currency=gbp
War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unser Änderungsprotokoll an.
Fragen? Sales-Team kontaktieren.
LLM? Lesen Sie llms.txt.
Unterstützt von Markdoc