Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden
Übersicht
Billing
ÜbersichtÜber die Billing APIs
Abonnements
Steuer
Übersicht
Berichte
ÜbersichtBerichte für mehrere Konten
Daten
Übersicht

Ein Abonnement per BACS-Lastschriftverfahren einrichten

Erfahren Sie, wie Sie ein Abonnement per Bacs-Lastschriftverfahren erstellen und abrechnen können.

Verwenden Sie diesen Leitfaden, um ein Abonnement mit BACS-Lastschrift als Zahlungsmethode und Checkout einzurichten.

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
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# Available as a gem
sudo gem install stripe
Gemfile
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Wiederkehrende Produkte und Preise erstellen

Vorsicht

Die Prices API bietet einen einheitlichen Rahmen für die Erstellung von einmaligen Käufen und Abonnements mit Stripe. Bestehende Integrationen ohne Prices API werden weiterhin unterstützt. Es gibt jedoch einige Checkout-Funktionen, die nur Prices unterstützen. Lesen Sie den Migrationsleitfaden, wenn Sie auf die Prices API umsteigen möchten.

Um Checkout zu verwenden, müssen Sie zuerst ein Produkt und einen Preis erstellen. Verschiedene physische Waren oder Dienstleistungsebenen müssen durch Produkte dargestellt werden. Die Preisgestaltung ist durch einen oder mehrere Preise dargestellt.

Sie können beispielsweise ein Software-Produkt erstellen, das vier Preise hat: 10 USD/Monat, 100 USD/Jahr, 9 GBP/Monat und 90 GBP/Jahr. Auf diese Weise können Sie Preise ändern und hinzufügen, ohne die Details der zugrunde liegenden Produkte ändern zu müssen. Sie können ein Produkt oder einen Preis über die API oder über das Stripe-Dashboard erstellen.

Wenn Ihr Preis beim Bezahlvorgang ermittelt wird (der/die Kund/in legt beispielsweise einen Spendenbetrag fest), oder wenn Sie es vorziehen, Preise nicht im Voraus zu erstellen, können Sie Preise inline bei der Erstellung der Checkout-Sitzung erstellen.

Stellen Sie vor dem Konfigurieren von Produkten sicher, dass Sie sich in einer Sandbox befinden. Definieren Sie als Nächstes die Waren und Dienstleistungen, die Sie verkaufen möchten. So erstellen Sie ein neues Produkt und einen neuen Preis:

  • Gehen Sie im Dashboard zum Bereich Produkte.
  • Klicken Sie auf Produkt hinzufügen.
  • Wählen Sie beim Festlegen des Preises „Wiederkehrend“ aus.
  • Preisplan konfigurieren

Sie können für jedes wiederkehrende Produkt mehrere Preispläne mit unterschiedlichen Parametern definieren. Jeder Preis verfügt über eine generierte ID, die Sie im Bezahlvorgang als Referenz nutzen können.

Notiz

In einer Sandbox erstellte Produkte können in den Live-Modus kopiert werden, sodass Sie sie nicht erneut erstellen müssen. Klicken Sie im Dashboard in der Detailansicht des Produkts oben rechts auf In Live-Modus kopieren. Dieser Schritt kann für jedes in einer Sandbox erstellte Produkt nur einmal durchgeführt werden. Spätere Aktualisierungen für das Testprodukt werden im Liveprodukt nicht berücksichtigt.

Checkout-Sitzung erstellen
Clientseitig
Serverseitig

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 mit der ID eines bestehenden Preises. Stellen Sie sicher, dass der Modus auf subscription gesetzt ist und dass Sie mindestens einen wiederkehrenden Preis übergeben. Zusätzlich zu wiederkehrenden Preisen können Sie auch einmalige Preise hinzufügen. Leiten Sie Ihre Kundinnen/Kunden nach dem Erstellen der Checkout-Sitzung zu der in der Antwort zurückgegebenen URL weiter.

Command Line
cURL
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "line_items[][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[][quantity]"=1 \
  -d "mode"="subscription" \
  -d "success_url"="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d "cancel_url"="https://example.com/cancel" \

Wenn Ihre Kundinnen und Kunden ihre Zahlung erfolgreich abgeschlossen haben, werden Sie an die success_url weitergeleitet. Hierbei handelt es sich um eine Seite auf Ihrer Website, auf der sie darüber informiert werden, dass ihre Zahlung erfolgreich durchgeführt 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 eine Zahlung abzuschließen, 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 Checkout besucht haben.

Checkout-Sitzungen laufen standardmäßig 24 Stunden nach Erstellung ab.

Aktivieren Sie im Dashboard die Zahlungsmethoden, die Sie von Ihren Kundinnen und Kunden akzeptieren möchten. Checkout unterstützt mehrere Zahlungsmethoden.

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.

Bestätigen, dass die Zahlung erfolgreich durchgeführt wurde

Wenn Ihre Kund/innen ihre Zahlung erfolgreich abschließen, werden sie von Stripe an die URL weitergeleitet, die Sie im success_url-Parameter angegeben haben. Hierbei handelt es sich in der Regel um eine Seite auf Ihrer Website, auf der Ihre Kund/innen darüber informiert werden, dass ihre Zahlung erfolgreich durchgeführt wurde.

Bei Bacs Direct Debit handelt es sich jedoch um eine Zahlungsmethode mit verzögerter Benachrichtigung, was bedeutet, dass Gelder nicht sofort verfügbar sind. Schieben Sie daher die Ausführung der Bestellung auf, bis das Geld auf Ihrem Konto ist. Nach erfolgreicher Zahlung ändert sich der Status des zugrunde liegenden PaymentIntent von processing in succeeded.

Sie können auf verschiedene Weise bestätigen, dass die Zahlung erfolgreich ist:

Erfolgreiche Zahlungen werden im Dashboard in der Zahlungsliste angezeigt. Wenn Sie auf eine Zahlung klicken, werden Sie zur Seite mit den Zahlungsdetails weitergeleitet. Der Abschnitt Checkout-Übersicht umfasst Rechnungsinformationen und die Liste der gekauften Artikel, die Sie zur manuellen Abwicklung der Bestellung verwenden können.

Notiz

Durch Senden von E-Mail-Benachrichtigungen über erfolgreich abgeschlossene Kundenzahlungen kann Stripe Ihnen helfen, den Überblick über eingehende Zahlungen zu behalten. Verwenden Sie das Dashboard, um E-Mail-Benachrichtigungen zu konfigurieren.

Integration testen

Es gibt mehrere Testbankkontonummern, die Sie in einer Sandbox verwenden können. So können Sie sicherstellen, dass diese Integration bereit ist.

BankleitzahlKontonummerBeschreibung
10-88-0000012345Die Zahlung ist erfolgt und die Rechnung wird auf paid umgestellt.
10-88-0090012345Die Zahlung erfolgt innerhalb von drei Minuten und die Rechnung wird auf paid umgestellt.
10-88-0033333335Die Zahlung schlägt fehl, die Fehlerkennung debit_not_authorized wird ausgegeben und die Rechnung wird auf open gestellt. Das Mandat wechselt zu inactive und die PaymentMethod kann nicht erneut verwendet werden.
10-88-0093333335Die Zahlung schlägt nach drei Minuten fehl, die Fehlerkennung debit_not_authorized wird ausgegeben und die Rechnung wird auf open gestellt. Das Mandat wechselt zu inactive und die PaymentMethod kann nicht erneut verwendet werden.
10-88-0022222227Die Zahlung schlägt fehl, die Fehlerkennung insufficient_funds wird ausgegeben und die Rechnung wird auf open gestellt. Das Mandat bleibt active und die PaymentMethod kann erneut verwendet werden.
10-88-0092222227Die Zahlung schlägt nach drei Minuten fehl, die Fehlerkennung insufficient_funds wird ausgegeben und die Rechnung wird auf open gestellt. Das Mandat bleibt active und die PaymentMethod kann erneut verwendet werden.
10-88-0055555559Die Zahlung erfolgt innerhalb von drei Minuten und die Rechnung wechselt zu paid. Eine Zahlungsanfechtung wird jedoch sofort erstellt.
10-88-0000033333Die Zahlungsmethode wurde erfolgreich erstellt, das Mandat wird jedoch von der Kundenbank verweigert und sofort deaktiviert.
10-88-0000044444Die 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.

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

Standardmäßig sendet Stripe den Kundinnen und Kunden bei der erstmaligen Erfassung ihrer Zahlungsinformationen sowie bei jeder Kontobelastung automatisch E-Mails. Diese Benachrichtigungen werden nicht in Sandboxes gesendet.

OptionalEinmalige Einrichtungsgebühr hinzufügen
Serverseitig

Zusätzlich zur Übergabe von wiederkehrenden Preisen können Sie im Modus subscription einmalige Preise hinzufügen. Diese werden nur auf der ersten Rechnung angezeigt, die durch das Abonnement erstellt wird. Dies ist nützlich, um Einrichtungsgebühren oder andere einmalige Gebühren in Verbindung mit einem Abonnement hinzuzufügen.

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[]"="bacs_debit" \
  -d "line_items[0][price]"="{{RECURRING_PRICE_ID}}" \
  -d "line_items[0][quantity]"=1 \
  -d "line_items[1][price]"="{{ONE_TIME_PRICE_ID}}" \
  -d "line_items[1][quantity]"=1 \
  -d "mode"="subscription" \
  -d "success_url"="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d "cancel_url"="https://example.com/cancel"

OptionalPreise und Produkte inline erstellen
Serverseitig

Zusätzlich zur Übergabe vorhandener Preis-IDs können Sie Ihren Artikelpreis auch bei der Erstellung der Checkout-Sitzung festlegen. Definieren Sie zuerst ein Produkt. Erstellen Sie dann mithilfe der Produkt-ID eine Checkout-Sitzung, indem Sie sie in price_data mit den Details unit_amount, currency und recurring details übergeben:

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[]"=bacs_debit \
  -d line_items[0][price_data][unit_amount]=5000 \
  -d line_items[0][price_data][currency]=gbp \
  -d line_items[0][price_data][product]=
"{{PRODUCT_ID}}"
 \
  -d line_items[0][price_data][recurring][interval]=month \
  -d line_items[0][quantity]=1 \
  -d mode=subscription \
  -d success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d cancel_url="https://example.com/cancel"

Wenn Sie auch Produkte inline erstellen müssen, haben Sie mit product_data hierzu zu Möglichkeit:

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[]"=bacs_debit \
  -d "line_items[][price_data][currency]"=gbp \
  -d "line_items[][price_data][product_data][name]"=T-shirt \
  -d "line_items[][price_data][unit_amount]"=2000 \
  -d "line_items[][quantity]"=1 \
  -d "mode"="subscription" \
  -d success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d cancel_url="https://example.com/cancel"

OptionalBestehende Kund/innen
Serverseitig

Wenn Sie bereits ein Customer-Objekt für eine Kundin/einen Kunden erstellt haben, können Sie mit dem Argument customer die Kunden-ID beim Erstellen einer Checkout-Sitzung übergeben. Dadurch wird sichergestellt, dass alle während der Sitzung erstellten Objekte dem richtigen Customer-Objekt zugeordnet werden.

Wenn Sie eine Kunden-ID übergeben, verwendet Stripe auch die im Customer-Objekt gespeicherte E-Mail-Adresse, um das entsprechende Feld auf der Checkout-Seite vorab auszufüllen. Wenn Kund/innen ihre E-Mail-Adresse auf der Checkout-Seite ändern, wird diese nach erfolgreicher Zahlung im Customer-Objekt aktualisiert.

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"=
"{{CUSTOMER_ID}}"

  -d "payment_method_types[]"="bacs_debit" \
  -d "line_items[][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[][quantity]"=1 \
  -d "mode"="subscription" \
  -d "success_url"="https://example.com/success" \
  -d "cancel_url"="https://example.com/cancel"

OptionalKundendaten vorab angeben
Serverseitig

Wenn Sie die E-Mail-Adresse Ihrer Kundin/Ihres Kunden bereits erfasst haben und sie in einer Checkout-Sitzung vorab angeben möchten, übergeben Sie customer_email beim Erstellen der Checkout-Sitzung.

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d customer_email="customer@example.com" \
  -d "payment_method_types[]"=bacs_debit \
  -d "line_items[][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[][quantity]"=1 \
  -d mode=subscription \
  -d success_url="https://example.com/success" \
  -d cancel_url="https://example.com/cancel"

OptionalTestzeiträume handhaben
Serverseitig

Mit trial_end oder trial_period_days können Sie in der Checkout-Sitzung die Dauer des Testzeitraums angeben. In diesem Beispiel verwenden wir trial_period_days, um eine Checkout-Sitzung für ein Abonnement mit einem Testzeitraum von 30 Tagen zu erstellen.

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[]"=bacs_debit \
  -d "line_items[][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[][quantity]"=1 \
  -d "subscription_data[trial_period_days]"=30 \
  -d mode=subscription \
  -d success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d cancel_url="https://example.com/cancel"

Checkout zeigt die folgenden Informationen automatisch für Abonnements mit Testzeiträumen an:

  • Testzeitraum
  • Häufigkeit und Höhe der Zahlungen nach Ablauf des Testzeitraums

Für weitere Informationen zu den geltenden Anforderungen sehen Sie sich den Leitfaden für Billing oder den Support-Leitfaden an.

OptionalSteuersätze
Serverseitig

Sie können Steuersätze, (Verkäufe, USt., GST und mehr) in Checkout-Sitzungen angeben, um Steuern auf Abonnements anzuwenden.

  • Verwenden Sie feste Steuersätze, wenn Sie den exakten Steuersatz kennen, den Sie Ihrem Kunden/Ihrer Kundin berechnen müssen, bevor sie den Bezahlvorgang starten (wenn Sie beispielsweise nur an Kund/innen in Großbritannien verkaufen und immer 20 % Mehrwertsteuer berechnen).
  • Mit der Prices API können Sie dynamische Steuersätze verwenden, wenn Sie weitere Informationen von Ihren Kund/innen benötigen (beispielsweise ihre Rechnungs- oder Versandadresse), bevor Sie den fälligen Steuersatz ermitteln. Mit dynamischen Steuersätzen erstellen Sie Steuersätze für verschiedene Regionen (beispielsweise einen Mehrwertsteuersatz von 20 % für Kund/innen in Großbritannien und einen Umsatzsteuersatz von 7,25 % für Kund/innen in Kalifornien, USA). Stripe versucht, den Standort Ihrer Kund/innen diesen Steuersätzen zuzuordnen.

Legen Sie subscription_data.default_tax_rates fest, um einen Standardsteuersatz auf ein Abonnement anzuwenden, das ohne Checkout gestartet wurde.

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[]"=bacs_debit \
  -d "line_items[][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[][quantity]"=1 \
  -d "subscription_data[default_tax_rates][]"="{{TAX_RATE_ID}}" \
  -d mode=subscription \
  -d success_url="https://example.com/success" \
  -d cancel_url="https://example.com/cancel"

Sie können auch line_items.tax_rates oder subscription_data.items.tax_rates angeben, um Steuersätze auf bestimmte Pläne oder Rechnungsposten anzuwenden.

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[]"="bacs_debit" \
  -d "line_items[][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[][quantity]"=1 \
  -d "line_items[][tax_rates][0]"="{{TAX_RATE_ID}}" \
  -d "mode"="subscription" \
  -d "success_url"="https://example.com/success" \
  -d "cancel_url"="https://example.com/cancel"

Sie können die Datenexporte von Stripe verwenden, um die für die Überweisung erforderlichen regelmäßigen Berichte auszufüllen. Weitere Informationen finden Sie unter Steuerberichterstattung und Überweisung.

OptionalGutscheine hinzufügen
Serverseitig

Sie können Gutscheine auf Abonnements in einer Checkout-Sitzung anwenden, indem Sie Rabatte einrichten. Diese Gutscheine überschreiben alle Gutscheine für die Kundin/den Kunden. Wenn Sie ein Abonnement für bestehende Kundinnen/Kunden erstellen, werden alle mit der Kundin/dem Kunden verknüpften Gutscheine auf die Rechnungen des jeweiligen Abonnements angewendet.

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[]"=bacs_debit \
  -d "line_items[][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[][quantity]"=1 \
  -d "discounts[][coupon]"="{{COUPON_ID}}" \
  -d "mode"="subscription" \
  -d success_url="https://example.com/success" \
  -d cancel_url="https://example.com/cancel"

Promo-Codes für Kund/innen hinzufügen

Sie können auch Promo-Codes für Kundinnen/Kunden aktivieren, indem Sie in Checkout-Sitzungen den Parameter allow_promotion_codes verwenden. Wenn allow_promotion_codes in einer Checkout-Sitzung aktiviert ist, zeigt Checkout ein Feld zum Einlösen von Promo-Codes, das Ihre Kundinnen/Kunden nutzen können. Sie können Ihre Gutscheine und Promo-Codes über das Dashboard oder die API erstellen, damit Ihre Kundinnen/Kunden sie in Checkout einlösen können.

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[]"="bacs_debit" \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][currency]"="gbp" \
  -d "line_items[0][price_data][product]=
{{PRODUCT_ID}}
" \
  -d "line_items[0][price_data][recurring][interval]=month" \
  -d "line_items[0][quantity]"=1 \
  -d "allow_promotion_codes"="true" \
  -d "mode"="subscription" \
  -d "success_url"="https://example.com/success" \
  -d "cancel_url"="https://example.com/cancel"

Siehe auch

War diese Seite hilfreich?
JaNein