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

Stripe Checkout-Integration aktualisieren, um Managed Payments zu verwendenÖffentliche Vorschau

Erfahren Sie, wie Sie Ihre bestehende Stripe-Integration aktualisieren, um Managed Payments zu verwenden.

Allgemeine Geschäftsbedingungen erforderlich

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

Aktualisieren Sie Ihre bestehende Stripe Checkout-Integration, um Managed Payments zu verwenden. Ihre Integration muss bereits Zahlungen akzeptieren, indem sie Checkout Sessions im payment- oder subscription-Modus erstellt.

Wenn Sie keine bestehende Checkout-Integration haben, informieren Sie sich stattdessen unter Managed Payments einrichten.

Gründe für eine Aktualisierung

Eine Managed Payments-Integration ermöglicht es Stripe, die Verantwortung für die Einhaltung der indirekten Steuern, die Betrugsprävention, die Transaktionsunterstützung für Kundinnen und Kunden und die Auftragsverwaltung für Sie zu übernehmen. Weitere Informationen finden Sie unter So funktioniert Managed Payments.

Bestehende Abonnements

Während dieser Vorschau können Sie Managed Payments nur für neue Abonnements aktivieren, die über eine Checkout-Session in Managed Payments gekauft wurden. Bestehende Abonnements sind nicht berechtigt.

Bevor Sie loslegen

  • Sie verfügen über eine bestehende Stripe Checkout-Integration (entweder gehostet oder als eingebettetes Formular), die Checkout-Sitzungen im Zahlungs- oder Abo-Modus erstellt.
  • Aktivieren Sie Managed Payments in Ihrem Dashboard.
  • Stellen Sie sicher, dass Ihre Produkte die Zulassungsvoraussetzungen für verwaltete Zahlungen erfüllen. Um eine Zahlung über „Managed Payments“ zu verarbeiten, müssen alle von Kundinnen und Kunden gekauften Produkte die Zulassungskriterien erfüllen.
  • Stellen Sie sicher, dass Sie die API-Version 2025-03-31.basil oder höher verwenden. Beachten Sie die Anweisungen zum Aktualisieren Ihrer API-Version.

Konfigurieren Sie Ihre Produkte für Managed Payments

Um Steuern zu berechnen, muss für Managed Payments für Ihre Produkte ein definierter Steuercode festgelegt sein. Informationen zu den in Frage kommenden Steuercodes finden Sie unter Funktionsweise von Managend Payments.

Verwenden Sie das Dashboard oder die API, um für jedes Ihrer Produkte einen Steuercode festzulegen.

So aktualisieren Sie den Steuercode eines Produkts:

  1. Navigieren Sie zum Dashboard > Produktkatalog.
  2. Klicken Sie auf das Überlaufmenü () neben dem Produkt, das Sie aktualisieren möchten.
  3. Klicken Sie auf Produkt bearbeiten.
  4. Wählen Sie einen Produktsteuercode aus. Zulässige Steuercodes werden mit „Berechtigt für Managed Payments“ gekennzeichnet.
  5. Klicken Sie auf Produkt aktualisieren.

Wiederholen Sie diesen Vorgang für jedes Produkt, das Sie mit Managed Payments verwenden möchten.

Wenn Sie Ihre Produkte direkt beim Erstellen Ihrer Checkout-Sitzung anlegen, fügen Sie tax_code im product_data-Objekt hinzu. Zum Beispiel, je nachdem, ob Sie Abos oder einmalige Zahlungen akzeptieren:

Command Line
cURL
Stripe CLI
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[0][price_data][product_data][name]"="Basic subscription" \
  -d "line_items[0][price_data][product_data][tax_code]"={{TAX_CODE}} \
  -d "line_items[0][price_data][recurring][interval]"=month \
  -d "line_items[0][quantity]"=1 \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success"

Managed Payments beim Erstellen Ihrer Checkout-Sitzung aktivieren

Bitte aktualisieren Sie den Aufruf Ihres Servers an die Checkout Session API, um den Parameter managed_payments[enabled] festzulegen und ;managed_payments_preview=v1 in Ihren Versionsheader aufzunehmen.

Beispiel:

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://example.com/success"

Nicht unterstützte Parameter entfernen
Serverseitig

Um als eingetragene/r Händler/in zu agieren, steuert Stripe einige Teile der Checkout-Session. Daher sind einige Parameter nicht verfügbar, wenn Sie Managed Payments verwenden und Sie müssen diese beim Erstellen von Checkout-Sessions in Managed Payments entfernen.

KategorieParameterUrsache
Taxautomatic_taxManaged Payments übernimmt die Steuerberechnung und den Einbehalt für Sie.
tax_id_collection
subscription_data.default_tax_rates
Zahlungsmethodenpayment_method_configurationManaged Payments steuert die in der Checkout-Session verfügbaren Zahlungsmethoden mithilfe dynamischer Zahlungsmethoden, um Ihren Kundinnen und Kunden die für sie relevantesten Zahlungsmethoden anzuzeigen. Informationen dazu, wie Sie für Managed Payments die Einstellungen für Zahlungsmethoden konfigurieren, finden Sie unter Zahlungsmethoden konfigurieren.
payment_method_options
payment_method_types
Kunden-Updatecustomer_update[name]Managed Payments erfordert, dass Ihre Kundin oder Ihr Kunde einen Namen und eine gültige Rechnungsadresse hat, um die Verkaufssteuer zu berechnen. Wenn Sie beim Erstellen des Bezahlvorgangs die ID einer bestehenden Kundin/eines bestehenden Kunden angeben, wird die/der Kundin/Kunde mit allen Änderungen an Name oder Rechnungsadresse aktualisiert.
customer_update[address]
Versandshipping_address_collectionManaged Payments unterstützt nur digitale Produkte, daher werden keine Versanddaten erfasst.
shipping_options
Connectsubscription_data.application_fee_percentManaged Payments unterstützt keine Connect-Integrationen.
subscription_data.on_behalf_of
subscription_data.transfer_data
Nach dem Verkaufsubscription_data.invoice_settingsManaged Payments übernimmt Aktionen nach dem Verkauf wie Rechnungsstellung und Bestätigungs-E-Mails für Sie.

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.