Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden
ÜbersichtZahlung annehmenAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenWiederkehrende Zahlungen
Präsenzzahlungen
Zahlungsmethoden
Zahlungsvorgänge
Salden und AbwicklungsdauerZahlungsbelegeRückerstattungen und Stornierungen
Erweiterte Integrationen
Mehr als Zahlungen

Managed Payments einrichtenÖffentliche Vorschau

Erfahren Sie, wie Sie mit Managed Payments eine Zahlung annehmen.

Allgemeine Geschäftsbedingungen erforderlich

Sie müssen die Allgemeinen Geschäftsbedingungen von Managed Payments im Dashboard akzeptieren, bevor Sie Managed Payments nutzen können.

Verwenden Sie Managed Payments, um globale Zahlungen für digitale Produkte zu akzeptieren. Managed Payments ermöglicht es Stripe, als eingetragener Händler in Ihrem Auftrag zu fungieren. Weitere Informationen finden Sie unter So funktioniert Managed Payments.

Bevor Sie loslegen

Produkte und Preise erstellen

Sie können Abos und einmalige Zahlungen akzeptieren:

Stripe verwendet Produkte, um die verschiedenen Waren oder Dienstleistungen darzustellen, die Sie verkaufen. Wenn Sie beispielsweise mehrere Abos wie Basic und Premium haben, erstellen Sie für jede Stufe ein separates Produkt.

Preise stellen den Betrag dar, den Sie Ihren Kundinnen/Kunden für ein Produkt in Rechnung stellen, und wie häufig sie ihn berechnen. Ein Produkt kann mehrere Preise haben. Ihr Basic-Abonnement könnte beispielsweise zwei Preise haben: 10 USD pro Monat oder 100 USD pro Jahr. Sie können auch verschiedene Währungsoptionen für jeden Preis definieren, z. B. 10 USD pro Monat und 15 CAD pro Monat.

Verwenden Sie entweder das Dashboard oder die API, um Produkte und Preise für jedes der von Ihnen verkauften Produkte zu erstellen:

Neues Produkt und neuen Preis erstellen

So erstellen Sie ein neues Produkt und weisen einen Preis zu:

  1. Navigieren Sie zum Dashboard > Produktkatalog.
  2. Klicken Sie auf Produkt erstellen.
  3. Geben Sie den Produktnamen und die Beschreibung ein und wählen Sie einen Produktsteuercode aus.
    • Der von Ihnen ausgewählte Steuercode muss für Managed Payments geeignet sein. Zulässige Steuercodes werden mit „Berechtigt für Managed Payments“ gekennzeichnet.
  4. Geben Sie für den Preis den Betrag und die Währung ein.
  5. Legen Sie den Abrechnungszeitraum basierend auf der Häufigkeit fest, mit der Sie Ihrem Kunden/Ihrer Kundin dieses Abonnement in Rechnung stellen möchten.
  6. Verwenden Sie das Vorschaufenster auf der rechten Seite, um zu sehen, wie viel Steuern Kundinnen/Kunden basierend auf ihrem Standort zahlen werden.
  7. Klicken Sie auf Produkt hinzufügen.
  8. Wiederholen Sie diese Schritte für jedes Produkt, das Sie verkaufen.

Preis zu einem bestehenden Produkt hinzufügen

So fügen Sie einem bestehenden Produkt einen weiteren Preis hinzu:

  1. Öffnen Sie den Produktkatalog.
  2. Klicken Sie auf das Produkt, dem Sie einen Preis hinzufügen möchten.
  3. Klicken Sie im Abschnitt Preise auf die +-Schaltfläche.
  4. Konfigurieren Sie den Preis wie oben beschrieben.
  5. Klicken Sie auf Preis erstellen.

Bezahlvorgang einrichten
Clientseitig

Mit Stripe Checkout können Sie Zahlungen von Ihren Kundinnen/Kunden über eine von Stripe gehostete Zahlungsseite annehmen. Sie sind dafür verantwortlich, Ihre Kundinnen und Kunden auf die Zahlungsseite weiterzuleiten, und Stripe leitet Ihre Kundinnen und Kunden nach Abschluss der Zahlung zurück zu Ihrer Website. Weitere Informationen finden Sie unter Funktionsweise von Checkout.

Um Ihren Bezahlvorgang einzurichten, müssen Sie Ihrer Seite eine Schaltfläche zum Bezahlen und eine Bestätigungsseite hinzufügen.

Schaltfläche zum Bezahlen hinzufügen

Fügen Sie Ihrer Website eine Schaltfläche zum Bezahlen hinzu, über die ein Endpoint auf Ihrem Server aufgerufen wird. Zum Beispiel:

checkout.html
<html>
  <head>
    <title>Subscribe to our cool new service</title>
  </head>
  <body>
    <!-- Use action="/create-checkout-session.php" if your server is PHP based. -->
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Subscribe</button>
    </form>
  </body>
</html>

Wenn Ihre Kundinnen/Kunden auf diese Schaltfläche klicken, werden sie zu der von Stripe gehosteten Zahlungsseite weitergeleitet.

Bestätigungsseite hinzufügen

Erstellen Sie als Nächstes eine Bestätigungsseite, die Ihren Kundinnen/Kunden nach erfolgreichem Bezahlvorgang angezeigt wird. Hosten Sie diese Bestätigungsseite auf Ihrer Website. Zum Beispiel:

success.html
<html>
  <head><title>Thanks for subscribing!</title></head>
  <body>
    <h1>Thanks for subscribing!</h1>
    <p>
      We appreciate your business!
      If you have any questions, please email us at
      <a href="mailto:orders@example.com">orders@example.com</a>.
    </p>
  </body>
</html>

Stripe leitet Ihre Kundinnen/Kunden auf diese Seite weiter, nachdem sie eine autorisierte Zahlung durchgeführt haben.

Abbruchseite hinzufügen (optional)

Sie können auch eine Abbruchseite für Ihre Kundinnen/Kunden erstellen, um festzustellen, ob sie den Bezahlvorgang beenden. Zum Beispiel:

cancel.html
<html>
  <head>
    <title>Checkout canceled</title>
  </head>
  <body>
    <p>Not ready to subscribe yet? No problem, we'll be here when you are!</p>
  </body>
</html>

Stripe leitet Ihre Kundinnen/Kunden auf diese Seite weiter, wenn sie auf der Zahlungsseite auf die Schaltfläche „Zurück“ klicken.

Server einrichten
Serverseitig

Stripe verwendet Checkout-Sitzungen, um darzustellen, was Ihren Kundinnen und Kunden bei der Weiterleitung zum Zahlungsformular angezeigt wird. Sie können Checkout-Sitzungen mit Optionen wie zu berechnenden Posten oder anzunehmenden Währungen konfigurieren.

Checkout-Sitzung erstellen

Erstellen Sie eine Checkout-Sitzung unter Verwendung eines der von Ihnen erstellten Preise als Einzelposten. Stellen Sie den Modus auf Abo ein und setzen Sie success_url auf die URL Ihrer Erfolgsseite. Um „Managed Payments“ zu aktivieren, setzen Sie managed_payments[enabled] auf wahr und fügen Sie ;managed_payments_preview=v1 in Ihren Versions-Header ein.

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
:" \
  -H "Stripe-Version: 2026-01-28.clover; managed_payments_preview=v1" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "managed_payments[enabled]"=true \
  -d mode=subscription \
  --data-urlencode success_url="https://localhost:4242/success"

Endpoint erstellen

Fügen Sie Ihrem Server einen Endpoint hinzu, der eine Checkout-Sitzung erstellt. Der Endpoint-Pfad muss mit dem Attribut action Ihrer Schaltfläche zum Bezahlen übereinstimmen.

Nachdem Sie eine Checkout-Sitzung erstellt haben, leiten Sie Ihre Kundinnen/Kunden an die in der Antwort zurückgegebene URL weiter.

Ruby
Python
PHP
Java
Node.js
Gehen Sie zu
.NET
No results
# This example sets up an endpoint using the Sinatra framework.

require 'json'
require 'sinatra'
require 'stripe'

# 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_BQokikJOvBiI2HlWgH4olfQ2'

Stripe.api_version = '2026-01-28.clover; managed_payments_preview=v1;'

post '/create-checkout-session' do
  session = Stripe::Checkout::Session.create({
    line_items: [{
      price: '{{PRICE_ID}}',
      quantity: 1
    }],
    mode: 'subscription',
    managed_payments: {enabled: true},
    success_url: 'http://localhost:4242/success'
  })

  redirect session.url, 303
end

Endpoint testen

Bestätigen Sie, dass auf Ihren Endpoint zugegriffen werden kann, indem Sie Ihren Webserver starten (beispielsweise localhost:4242) und den folgenden Befehl ausführen:

Command Line
curl -X POST -is "http://localhost:4242/create-checkout-session" -d ""

Die Antwort in Ihrem Terminal sieht wie folgt aus:

Command Line
HTTP/1.1 303 See Other
Location: https://checkout.stripe.com/c/pay/cs_test_...
...

Ereignisse nach der Zahlung verarbeiten

Stripe sendet das Ereignis checkout.session.completed, wenn ein Kunde/eine Kundin eine Zahlung in der Checkout-Sitzung abschließt. Verwenden Sie das Dashboard-Webhook-Tool oder befolgen Sie die Webhook-Anleitung, um diese Ereignisse zu empfangen und zu verarbeiten.

Überwachen Sie diese Ereignisse, anstatt darauf zu warten, dass Stripe Ihren Kunden/Ihre Kundin auf Ihre Bestätigungsseite weiterleitet. Vermeiden Sie es, Ihre Bestätigungsseite nur zu verwenden, um Aktionen nach dem Bezahlvorgang auszulösen.

Richten Sie Ihre Integration so ein, dass asynchrone Ereignisse überwacht werden, um verschiedene Arten von Zahlungsmethoden, die sich möglicherweise verzögern, ordnungsgemäß zu verarbeiten. Weitere Informationen finden Sie unter Bestellungen für Checkout abwickeln.

Verarbeiten Sie die folgenden Ereignisse, wenn Sie Zahlungen mit Checkout einziehen:

EreignisBeschreibung
checkout.session.completedWird gesendet, wenn ein Kunde/eine Kundin eine Checkout-Sitzung erfolgreich abschließt.
checkout.session.async_payment_succeededWird gesendet, wenn eine Zahlung mit einer Zahlungsmethode mit Verzögerung, wie z. B. ACH-Lastschriftverfahren, erfolgreich ausgeführt wird.
checkout.session.async_payment_failedWird gesendet, wenn eine Zahlung mit einer Zahlungsmethode mit Verzögerung, wie z. B. ACH-Lastschriftverfahren, fehlschlägt.

Tests

Testen Sie, ob Ihre Integration für Ihre Kundinnen/Kunden korrekt funktioniert.

Bezahlvorgang

  1. Starten Sie Ihren Server und gehen Sie von Ihren Bezahlvorgang erstellen zu Ihrer Bezahlvorgangsseite (zum Beispiel http://localhost:4242/checkout.html.
  2. Klicken Sie auf die Schaltfläche zum Bezahlen, um zur Bezahlseite von Managed Payments weitergeleitet zu werden.
  3. Geben Sie auf der Bezahlseite verschiedene Rechnungsadressen ein, um zu sehen, wie Managed Payments die Steuern für Kundinnen/Kunden an verschiedenen Standorten berechnet.
  4. Um die Zahlung abzuwickeln, geben Sie Ihre E-Mail-Adresse, Ihre Telefonnummer und die Testkartennummer 4242 4242 4242 4242 mit beliebiger Prüfziffer (CVC) und einem Ablaufdatum in der Zukunft ein.

Weitere Informationen finden Sie unter Testen.

Zahlungsdetails

  1. Nachdem Sie die Testzahlung bestätigt haben, gehen Sie zum Dashboard > Liste der Zahlungen.
  2. Klicken Sie auf Ihre Testzahlung, um die Zahlungsdetails anzuzeigen. Diese Seite zeigt die folgenden Informationen an:
    • Produkt, das gekauft wurde
    • Abonnement, das erstellt wurde
    • Rechnung, die erstellt wurde
    • Über Managed Payments berechneter und einbehaltener Steuerbetrag
    • Zahlungsbeschreibung, die auf den Kontoauszügen Ihrer Kundinnen/Kunden angezeigt wird

Kundenautorisierung

Die mit dem Abonnement verknüpfte Zahlungsmethode darf nur von Managed Payments belastet werden. Um sie für Transaktionen zu verwenden, die nicht mit Managed Payments abgewickelt werden, müssen Sie die Zustimmung des Kunden/der Kundin einholen.

Zahlungsbeleg in der Vorschau anzeigen

  1. Klicken Sie unter Checkout-Übersicht auf Rechnung.
  2. Klicken Sie auf Beleg senden, um eine Vorschau der an Ihre/n Kund/in gesendeten E-Mail mit dem Zahlungsbeleg anzuzeigen. Sie können den Zahlungsbeleg auch herunterladen.

Hinweis

In Sandbox erhalten Sie E-Mails mit Zahlungsbelegen nicht automatisch nach dem Kauf, sondern können sie manuell mit den obigen Anweisungen versenden.

Link

Link fungiert beim Bezahlvorgang als eingetragener Händler und bietet unter Link.com Support für die Verwaltung von Abos und Transaktionen.

So testen Sie Link:

  1. Öffnen Sie Ihre Bezahlseite

  2. Klicken Sie auf die Schaltfläche zum Bezahlen.

  3. Geben Sie dieselbe E-Mail-Adresse ein, die Sie zum Testen Bezahlseite verwendet haben.

  4. Verwenden Sie im Pop-up-Modal den Test-Passcode 000000, um sich zu authentifizieren.

    Wenn Sie beim ersten Bezahlvorgang das Kontrollkästchen Meine Daten für schnellere Bezahlvorgänge speichern aktiviert haben, wird auch die in Ihrem Link-Konto gespeicherte Testkarte 4242 angezeigt.

OptionalSteuerverhalten für Ihre Preise konfigurieren

Das tax_behavior eines Preises gibt an, ob die Steuer zusätzlich zu dem von Ihnen festgelegten Preis erhoben wird (tax_behavior: exclusive) oder bereits im Preis enthalten ist (tax_behavior: inclusive).

Managed Payments verwendet das in Ihrem Preis angegebene Steuerverhalten. Wenn Sie das Steuerverhalten des Preises nicht angeben, fügt Managed Payments dem von Ihnen festgelegten Preis standardmäßig Steuern hinzu.

Um die Standardeinstellung zu ändern, gehen Sie zu Dashboard > Steuereinstellungen und aktualisieren Sie die Einstellung Steuer in Preise einbeziehen.

Siehe auch