Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden

Abonnement-Integration erstellen

Abonnements und wiederkehrende Zahlungen erstellen und verwalten

Checkout-Abonnementseite
Kaum Code

Logo, Bilder und Farben anpassen.

Vorgefertigte Formulare verwenden, um Zahlungen einzuziehen und Abonnements zu verwalten.

Kopieren Sie eine Beispiel-Integration aus GitHub.

Eine ausführliche Version dieses Leitfadens finden Sie im Quickstart zur Billing-Integration.

Demo anzeigen, um ein gehostetes Beispiel zu sehen.

Was Sie entwickeln

In diesem Leitfaden wird erläutert, wie Sie mit Stripe Checkout monatliche Abonnements mit festen Preisen verkaufen.

Dieser Leitfaden bietet Informationen zu den folgenden Vorgehensweisen:

  • Modellieren Sie Ihr Unternehmen, indem Sie einen Produktkatalog erstellen
  • Fügen Sie eine Checkout-Sitzung zu Ihrer Seite hinzu, einschließlich einer Schaltfläche sowie Erfolgs- und Abbruchseiten
  • Überwachen Sie Abonnement-Ereignisse und stellen Sie den Zugang zu Ihrer Dienstleistung bereit
  • Richten Sie das Kundenportal ein.
  • Fügen Sie eine Kundenportal-Sitzung zu Ihrer Seite hinzu, einschließlich einer Schaltfläche und einer Umleitung
  • Lassen Sie Ihre Kund/innen über das Portal ihre eigenen Abonnements verwalten

Nachdem Sie die Integration abgeschlossen haben, können Sie sie auf Folgendes erweitern:

Stripe einrichten

Installieren Sie den Stripe-Client Ihrer Wahl:

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'

Installieren Sie die Stripe-CLI (optional). Die CLI bietet Webhook-Tests und kann zum Erstellen Ihrer Produkte und Preise ausgeführt werden.

Command Line
# Install Homebrew to run this command: https://brew.sh/
brew install stripe/stripe-cli/stripe

# Connect the CLI to your dashboard
stripe login

Weitere Installationsoptionen finden Sie unter Mit der Stripe-CLI loslegen.

Preismodell erstellen
Dashboard oder Stripe-CLI

Erstellen Sie Ihre Produkte und die zugehörigen Preise im Dashboard oder mit der Stripe-CLI.

In diesem Beispiel wird ein Festpreisdienst mit zwei verschiedenen Service-Level-Optionen verwendet: Basic und Premium. Für jede Service-Level-Option müssen Sie ein Produkt und einen wiederkehrenden Preis erstellen. (Wenn Sie eine einmalige Gebühr, z. B. für die Einrichtung, hinzufügen möchten, erstellen Sie ein drittes Produkt mit einem einmaligen Preis. Der Einfachheit halber verzichtet dieses Beispiel auf eine einmalige Gebühr).

In diesem Beispiel wird jedes Produkt in monatlichen Intervallen abgerechnet. Der Preis für das Basic-Produkt beträgt 5 USD. Der Preis für das Premium-Produkt beträgt 15 USD.

Gehen Sie zur Seite Produkt hinzufügen und erstellen Sie zwei Produkte. Fügen Sie für jedes Produkt einen Preis hinzu, jeweils mit einem monatlich wiederkehrenden Abrechnungszeitraum:

  • Premium-Produkt: Premium-Dienstleistung mit zusätzlichen Funktionen

    • Preis: Standardpreis | 15 USD

  • Basic-Produkt: Basic-Dienstleistung mit minimalem Funktionsumfang

    • Preis: Standardpreis | 5 USD

Zeichnen Sie nach Erstellung der Preise die Preis-IDs auf, sodass diese in anderen Schritten verwendet werden können. Preis-IDs sehen in etwa wie folgt aus: price_G0FvDp6vZvdwRZ.

Wenn Sie bereit sind, verwenden Sie die Schaltfläche In Live-Modus kopieren oben rechts auf der Seite, um Ihr Produkt aus dem Test- in den Live-Modus zu kopieren.

Wenn Sie mehrere Abrechnungsintervalle anbieten, können Sie mit Checkout für Kundinnen/Kunden Upselling auf längere Zahlungsintervalle durchführen und so Ihre Umsätze im Voraus steigern.

Informationen zu anderen Preismodellen finden Sie in den Billing-Beispielen.

Checkout-Sitzung erstellen
Client und Server

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
Vollständiges Beispiel anzeigen
<html>
  <head>
    <title>Checkout</title>
  </head>
  <body>
    <form action="/create-checkout-session" method="POST">
      <!-- Note: If using PHP set the action to /create-checkout-session.php -->

      <input type="hidden" name="priceId" value="price_G0FvDp6vZvdwRZ" />
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

Definieren Sie im Backend Ihrer Anwendung einen Endpoint, der die Sitzung erstellt, die von Ihrem Frontend aufgerufen werden kann. Sie brauchen dazu folgende Werte:

  • Die Preis-ID des Abonnements, das die Kundin/der Kunde abschließt (Ihr Frontend übergibt diesen Wert)
  • Ihre success_url, eine Seite auf Ihrer Website, an die Kund/innen nach Abschluss der Zahlung weitergeleitet werden

Optional können Sie cancel_url angeben, eine Seite auf Ihrer Website, zu der Checkout Ihre Kundinnen und Kunden zurückleitet, wenn sie den Zahlungsvorgang abbrechen. Sie können auch einen Abrechnungszyklusanker für Ihr Abonnement in diesem Aufruf konfigurieren.

Wenn Sie im 2. Schritt einen einmaligen Preis erstellt haben, übergeben Sie auch die ID dieses Preises. Leiten Sie Ihre Kund/innen nach dem Erstellen einer Checkout-Sitzung zu der in der Antwort zurückgegebenen URL weiter.

Notiz

Sie können lookup_keys verwenden, um Preise anstelle von Preis-IDs abzurufen. Wie dies aussehen kann, erfahren Sie in der Beispielanwendung.

server.rb
Vollständiges Beispiel anzeigen
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_4eC39HqLyjWDarjtT1zdp7dc'


# The price ID passed from the front end.
#   price_id = params['priceId']
price_id = '{{PRICE_ID}}'

session = Stripe::Checkout::Session.create({
  success_url: 'https://example.com/success.html?session_id={CHECKOUT_SESSION_ID}',
  cancel_url: 'https://example.com/canceled.html',
  mode: 'subscription',
  line_items: [{
    # For metered billing, do not pass quantity
    quantity: 1,
    price: price_id,
  }],
})

# Redirect to the URL returned on the session
#   redirect session.url, 303

In diesem Beispiel wurde die success_url durch die Sitzungs-ID ergänzt. Weitere Informationen zu dieser Vorgehensweise finden Sie in der Dokumentation zum Anpassen Ihrer Bestätigungsseite.

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

Abonnements bereitstellen und überwachen
Server

Wenn das Abonnement erfolgreich abgeschlossen wurde, kehrt die Kundin/der Kunde über die success_url auf Ihre Website zurück, wo die Webhooks checkout.session.completed ausgelöst werden. Nachdem Sie das Ereignis checkout.session.completed empfangen haben, können Sie das Abonnement bereitstellen. Stellen Sie das Abonnement daraufhin jeden Monat (bei monatlicher Abrechnung) bereit, sobald Sie das Ereignis invoice.paid empfangen haben. Falls Sie das Ereignis invoice.payment_failed empfangen, benachrichtigen Sie Ihre Kundin/Ihren Kunden und lassen Sie die Zahlungsmethode im Kundenportal aktualisieren.

Um den nächsten Schritt für die Logik Ihres Systems zu bestimmen, überprüfen Sie den Ereignistyp und analysieren Sie die Nutzlast jedes Ereignisobjekts, z. B. invoice.paid. Speichern Sie die Ereignisobjekte subscription.id und customer.id zur Überprüfung in Ihrer Datenbank.

Zu Testzwecken können Sie Ereignisse im Dashboard überwachen. Richten Sie für die Produktion einen Webhook-Endpoint ein und abonnieren Sie die entsprechenden Ereignistypen. Wenn Sie Ihren Schlüssel STRIPE_WEBHOOK_SECRET nicht kennen, klicken Sie auf den Webhook im Dashboard, um ihn anzuzeigen.

server.rb
Vollständiges Beispiel anzeigen
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_4eC39HqLyjWDarjtT1zdp7dc'


post '/webhook' do
  webhook_secret = 
'{{STRIPE_WEBHOOK_SECRET}}'

  payload = request.body.read
  if !webhook_secret.empty?
    # Retrieve the event by verifying the signature using the raw body and secret if webhook signing is configured.
    sig_header = request.env['HTTP_STRIPE_SIGNATURE']
    event = nil

    begin
      event = Stripe::Webhook.construct_event(
        payload, sig_header, webhook_secret
      )
    rescue JSON::ParserError => e
      # Invalid payload
      status 400
      return
    rescue Stripe::SignatureVerificationError => e
      # Invalid signature
      puts '⚠️  Webhook signature verification failed.'
      status 400
      return
    end
  else
    data = JSON.parse(payload, symbolize_names: true)
    event = Stripe::Event.construct_from(data)
  end
  # Get the type of webhook event sent
  event_type = event['type']
  data = event['data']
  data_object = data['object']

  case event_type
  when 'checkout.session.completed'
    # Payment is successful and the subscription is created.
    # You should provision the subscription and save the customer ID to your database.
  when 'invoice.paid'
    # Continue to provision the subscription as payments continue to be made.
    # Store the status in your database and check when a user accesses your service.
    # This approach helps you avoid hitting rate limits.
  when 'invoice.payment_failed'
    # The payment failed or the customer does not have a valid payment method.
    # The subscription becomes past_due. Notify your customer and send them to the
    # customer portal to update their payment information.
  else
    puts "Unhandled event type: \#{event.type}"
  end

  status 200
end

Überwachen Sie mindestens folgende Ereignistypen:

EreignisnameBeschreibung
checkout.session.completedWird übermittelt, wenn Kund/innen in Checkout auf die Schaltfläche „Abonnieren“ oder „Bezahlen“ klicken, um Sie über einen neuen Kauf zu informieren.
invoice.paidWird bei jedem Abrechnungsintervall übermittelt, wenn eine Zahlung erfolgreich war.
invoice.payment_failedWird bei jedem Abrechnungsintervall übermittelt, wenn Problem mit der Zahlungsmethode Ihrer Kund/innen vorliegt.

Weitere zu überwachende Ereignisse finden Sie im Abschnitt Abonnement-Webhooks.

Das Kundenportal konfigurieren
Dashboard

Über das Kundenportal können Ihre Kundinnen/Kunden ihre bestehenden Abonnements und Rechnungen direkt verwalten.

Verwenden Sie das Dashboard, um das Portal zu konfigurieren. Stellen Sie sicher, dass Sie es mindestens so konfigurieren, dass Kundinnen/Kunden ihre Zahlungsmethoden aktualisieren können. Informationen zu weiteren Einstellungen, die Sie konfigurieren können, finden Sie unter Kundenportal integrieren.

Eine Portalsitzung erstellen
Server

Definieren Sie einen Endpoint, der die Kundenportal-Sitzung erstellt, die von Ihrem Frontend aufgerufen wird. Hier steht CUSTOMER_ID für die von einer Checkout-Sitzung erstellte Kunden-ID, die Sie beim Verarbeiten des Webhooks checkout.session.completed gespeichert haben. Sie können auch im Dashboard einen Standard-Weiterleitungslink für das Portal festlegen.

Übergeben Sie einen optionalen return_url-Wert für die Seite auf Ihrer Website, auf die Ihre Kunden und Kundinnen nach der Verwaltung eines Abonnements weitergeleitet werden:

server.rb
Vollständiges Beispiel anzeigen
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_4eC39HqLyjWDarjtT1zdp7dc'


# This is the URL to which users will be redirected after they are done
# managing their billing.
return_url = 
'{{DOMAIN_URL}}'

customer_id = 
'{{CUSTOMER_ID}}'


session = Stripe::BillingPortal::Session.create({
  customer: customer_id,
  return_url: return_url,
})

# Redirect to the URL for the session
#   redirect session.url, 303

Kund/innen an das Kundenportal senden
Client

Fügen Sie im Frontend eine Schaltfläche hinzu, die über die success_url auf das Kundenportal verweist:

success.html
Vollständiges Beispiel anzeigen
<html>
  <head>
    <title>Manage Billing</title>
  </head>
  <body>
    <form action="/customer-portal" method="POST">
      <!-- Note: If using PHP set the action to /customer-portal.php -->
      <button type="submit">Manage Billing</button>
    </form>
  </body>
</html>

Nach dem Verlassen des Kundenportals kehrt Ihr/e Kund/in über die return_url auf Ihre Website zurück. Überwachen Sie Ihre Webhooks, um den Status des Kundenabonnements zu verfolgen.

Wenn Sie das Kundenportal so konfigurieren, dass Aktionen wie die Kündigung eines Abonnements zugelassen werden, finden Sie unter Kundenportal integrieren weitere zu überwachende Ereignisse.

Integration testen

Zahlungsmethoden testen

Verwenden Sie die folgende Tabelle, um verschiedene Zahlungsmethoden und -szenarien zu testen.

ZahlungsmethodeSzenarioSo führen Sie den Test durch
BECS-LastschriftIhr/e Kund/in zahlt erfolgreich mit dem BECS-Lastschriftverfahren.Füllen Sie das Formular mit der Kontonummer 900123456 und BSB 000-000 aus. Die bestätigte PaymentIntent geht zunächst in den Status processing über und dann drei Minuten später in den Status succeeded.
BECS-LastschriftDie Zahlung Ihres/Ihrer Kund/in schlägt fehl mit Code account_closed fehl.Füllen Sie das Formular mit der Kontonummer 111111113 und BSB 000-000 aus.
KreditkarteDie Kartenzahlung ist erfolgreich und es ist keine Authentifizierung erforderlich.Füllen Sie das Kreditkartenformular aus und geben Sie die Kreditkartennummer 4242 4242 4242 4242 mit beliebiger Gültigkeitsdauer, CVC und Postleitzahl an.
KreditkarteFür die Kartenzahlung ist eine Authentifizierung erforderlich.Füllen Sie das Kreditkartenformular aus und geben Sie die Kreditkartennummer 4000 0025 0000 3155 mit beliebiger Gültigkeitsdauer, CVC und Postleitzahl an.
KreditkarteDie Karte wird mit einem Ablehnungscode wie insufficient_funds abgelehnt.Füllen Sie das Kreditkartenformular aus und geben Sie die Kreditkartennummer 4000 0000 0000 9995 mit beliebiger Gültigkeitsdauer, CVC und Postleitzahl an.
SEPA-LastschriftIhr/e Kund/in zahlt erfolgreich mit dem SEPA-Lastschriftverfahren.Füllen Sie das Formular mit der Kontonummer AT321904300235473204 aus. Die bestätigte PaymentIntent geht zunächst in den Status „wird verarbeitet“ und dann drei Minuten später in den Status „erfolgreich“ über.
SEPA-LastschriftDer Status der PaymentIntent Ihres/Ihrer Kund/in wechselt von processing zu requires_payment_method.Füllen Sie das Formular mit der Kontonummer AT861904300235473202 aus.

Ereignisse überwachen

Richten Sie Webhooks ein, um Abonnementänderungsereignisse wie Upgrades und Kündigungen zu überwachen. Erfahren Sie mehr über Abonnement-Webhooks. Sie können Ereignisse im Dashboard oder mit der Stripe-CLI anzeigen.

Weitere Einzelheiten zum Testen Ihrer Billing-Integration finden Sie im Leitfaden.

Siehe auch

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 unseren Produkt-Changelog an.
Fragen? Sales-Team kontaktieren.
Unterstützt von Markdoc