# Stripe Checkout-Integration aktualisieren, um Managed Payments zu verwenden 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](https://stripe.com/legal/managed-payments) im [Dashboard](https://dashboard.stripe.com/settings/managed-payments) akzeptieren, bevor Sie Managed Payments nutzen können. Aktualisieren Sie Ihre bestehende [Stripe Checkout](https://docs.stripe.com/payments/checkout.md)-Integration, um Managed Payments zu verwenden. Ihre Integration muss bereits Zahlungen akzeptieren, indem sie *Checkout Sessions* (A Checkout Session represents your customer's session as they pay for one-time purchases or subscriptions through Checkout. After a successful payment, the Checkout Session contains a reference to the Customer, and either the successful PaymentIntent or an active Subscription) im `payment`- oder `subscription`-Modus erstellt. Wenn Sie keine bestehende Checkout-Integration haben, informieren Sie sich stattdessen unter [Managed Payments einrichten](https://docs.stripe.com/payments/managed-payments/set-up.md). ### 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](https://docs.stripe.com/payments/managed-payments/how-it-works.md). ### 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. ## Before you begin - Sie verfügen über eine bestehende Stripe Checkout-Integration (entweder [gehostet](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=checkout&ui=stripe-hosted) oder als [eingebettetes Formular](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=checkout&ui=embedded-form)), die Checkout-Sitzungen im `Zahlungs`- oder `Abo`-Modus erstellt. - Aktivieren Sie Managed Payments in Ihrem [Dashboard](https://dashboard.stripe.com/settings/managed-payments). - Stellen Sie sicher, dass Ihre Produkte die [Anforderungen](https://docs.stripe.com/payments/managed-payments/eligibility.md) für Managed Payments erfüllen. Um eine Zahlung mit Managed Payments abzuwickeln, müssen alle Produkte, die der Kunde/die Kundin erwirbt, die Anforderungen erfüllen. - Verwenden Sie eine [Vorschau-API-Version](https://docs.stripe.com/sdks/versioning.md#public-preview-release-channel) vom `30.04.2025.preview` oder eine neuere Version für die Erstellung von Checkout-Sitzungen. ## Konfigurieren Sie Ihre Produkte für Managed Payments Um Steuern zu berechnen, setzt Managed Payments voraus, dass Ihre *Produkte* (Products represent what your business sells—whether that's a good or a service) über einen festgelegten *Steuercode* verfügen. Beachten Sie die [zugelassenen Steuercodes](https://docs.stripe.com/payments/managed-payments/eligibility.md#eligible-tax-codes). Verwenden Sie das Dashboard oder die API, um für jedes Ihrer Produkte einen Steuercode festzulegen. #### Dashboard So aktualisieren Sie den Steuercode eines Produkts: 1. Navigieren Sie zum **Dashboard** > [Produktkatalog](https://dashboard.stripe.com/products). 1. Klicken Sie auf das Überlaufmenü (⋯) neben dem Produkt, das Sie aktualisieren möchten. 1. Klicken Sie auf **Produkt bearbeiten**. 1. Wählen Sie einen **Produktsteuercode** aus. Zulässige Steuercodes werden mit „**Berechtigt** für Managed Payments“ gekennzeichnet. 1. Klicken Sie auf **Produkt aktualisieren**. #### API So aktualisieren Sie den Steuercode eines Produkts: ```curl curl https://api.stripe.com/v1/products/{{PRODUCT_ID}} \ -u "<>:" \ -d tax_code={{TAX_CODE}} ``` 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](https://docs.stripe.com/api/checkout/sessions/create.md) anlegen, fügen Sie `tax_code` im `product_data`-Objekt hinzu. Zum Beispiel, je nachdem, ob Sie Abos oder einmalige Zahlungen akzeptieren: #### Abonnements ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -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" ``` #### Einmalige Zahlungen ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price_data][product_data][name]=1000 tokens" \ -d "line_items[0][price_data][product_data][tax_code]={{TAX_CODE}}" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` ## Managed Payments beim Erstellen Ihrer Checkout-Sitzung aktivieren Aktualisieren Sie den Aufruf der [Checkout Session API](https://docs.stripe.com/api/checkout/sessions/create.md) seitens Ihres Servers, um den Parameter `managed_payments[enabled]` festzulegen und eine [Vorschau-API-Version](https://docs.stripe.com/sdks/versioning.md#public-preview-release-channel) zu verwenden. Beispiel: #### Abonnements ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -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" ``` #### Einmalige Zahlungen ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "managed_payments[enabled]=true" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` ## Nicht unterstützte Parameter entfernen [Serverseitig] #### Abonnements 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. | Kategorie | Parameter | Ursache | | ------------------------------------- | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Adaptive Pricing | `adaptive_pricing` | Adaptive Pricing ist bei Managed Payments immer aktiviert. | | Tax | `automatic_tax` | Managed Payments übernimmt die Steuerberechnung und den Einbehalt für Sie. | | `tax_id_collection` | | `subscription_data.default_tax_rates` | | Zahlungsmethoden | `payment_method_configuration` | Managed Payments steuert die in der Checkout-Session verfügbaren Zahlungsmethoden mithilfe [dynamischer Zahlungsmethoden](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md), 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](https://support.stripe.com/questions/payment-method-configurations-for-managed-payments). | | `payment_method_options` | | `payment_method_types` | | Kunden-Update | `customer_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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer) angeben, wird die/der [Kundin/Kunde](https://docs.stripe.com/api/customers/object.md) mit allen Änderungen an Name oder Rechnungsadresse aktualisiert. | | `customer_update[address]` | | Versand | `shipping_address_collection` | Managed Payments unterstützt nur digitale Produkte, daher werden keine Versanddaten erfasst. | | `shipping_options` | | Connect | `subscription_data.application_fee_percent` | Managed Payments unterstützt keine Connect-Integrationen. | | `subscription_data.on_behalf_of` | | `subscription_data.transfer_data` | | Nach dem Verkauf | `subscription_data.invoice_settings` | Managed Payments übernimmt für Sie Aktionen nach dem Verkauf, wie z. B. Rechnungsstellung und Bestätigungs-E-Mails. | | `invoice_creation` | #### Einmalige Zahlungen Um als *Händler/in von* (The legal entity responsible for facilitating the sale of products to a customer that handles any applicable regulations and liabilities, including sales taxes. In a Connect integration, it can be the platform or a connected account) zu agieren, kontrolliert Stripe einige Teile des Bezahlvorgangs. Daher sind einige Parameter nicht verfügbar, wenn Sie „Managed Payments“ verwenden und Sie müssen diese beim Erstellen von Managed Payments Checkout-Sitzungen entfernen. | Kategorie | Parameter | Ursache | | ------------------------------------------------------------ | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Tax | `automatic_tax` | Managed Payments übernimmt die Steuerberechnung und den Einbehalt für Sie. | | `tax_id_collection` | | Zahlungsmethoden | `excluded_payment_method_types` | Managed Payments steuert die in der Checkout-Session verfügbaren Zahlungsmethoden mithilfe [dynamischer Zahlungsmethoden](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md), 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](https://support.stripe.com/questions/payment-method-configurations-for-managed-payments). | | `adaptive_pricing` | | `payment_intent_data.setup_future_usage` | | `payment_method_configuration` | | `payment_method_options.{payment_method}.setup_future_usage` | | `payment_method_types` | | Kunden-Update | `customer_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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer) angeben, wird die/der [Kundin/Kunde](https://docs.stripe.com/api/customers/object.md) mit allen Änderungen an Name oder Rechnungsadresse aktualisiert. | | `customer_update[address]` | | Versand | `shipping_address_collection` | Managed Payments unterstützt nur digitale Produkte, daher werden keine Versanddaten erfasst. | | `shipping_options` | | `payment_intent_data.shipping` | | Connect | `payment_intent_data.application_fee_amount` | Managed Payments unterstützt keine Connect-Integrationen. | | `payment_intent_data.on_behalf_of` | | `payment_intent_data.transfer_data` | | `payment_intent_data.transfer_group` | | Nach dem Verkauf | `invoice_creation` | Managed Payments übernimmt Aktionen nach dem Verkauf wie Rechnungsstellung und Bestätigungs-E-Mails für Sie. | | `payment_intent_data.statement_descriptor` | | `payment_intent_data.statement_descriptor_suffix` | | `payment_intent_data.receipt_email` | ## 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](https://docs.stripe.com/payments/managed-payments/set-up.md#build-your-checkout) zu Ihrer Bezahlvorgangsseite (zum Beispiel . 1. Klicken Sie auf die Schaltfläche zum Bezahlen, um zur Bezahlseite von Managed Payments weitergeleitet zu werden. 1. Geben Sie auf der Bezahlseite verschiedene Rechnungsadressen ein, um zu sehen, wie Managed Payments die Steuern für Kundinnen/Kunden an verschiedenen Standorten berechnet. 1. 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](https://docs.stripe.com/testing.md). ### Zahlungsdetails #### Item 1 1. Nachdem Sie die Testzahlung bestätigt haben, gehen Sie zum **Dashboard** > [Transaktionen](https://dashboard.stripe.com/test/payments). 1. Klicken Sie auf Ihre Testzahlung, um die Zahlungsdetails anzuzeigen. Diese Seite zeigt die folgenden Informationen an: - Produkt, das gekauft wurde - [Abonnement](https://docs.stripe.com/api/subscriptions.md), das erstellt wurde - [Rechnung](https://docs.stripe.com/api/invoices.md), die erstellt wurde - Über Managed Payments berechneter und einbehaltener Steuerbetrag - Zahlungsbeschreibung, die auf den Kontoauszügen Ihrer Kundinnen/Kunden angezeigt wird > #### Kundenautorisierung > > Wenn Kundinnen und Kunden ein Abonnement über Managed Payments abschließen, autorisieren sie nur die Belastung ihrer Zahlungsmethode durch Managed Payments. Um diese Zahlungsmethode für Transaktionen außerhalb von Managed Payments belasten zu können, müssen Sie die entsprechende Einwilligung Ihrer Kundinnen und Kunden einholen. #### Item 2 1. Nachdem Sie die Testzahlung bestätigt haben, gehen Sie zum **Dashboard** > [Transaktionen](https://dashboard.stripe.com/test/payments). 1. Klicken Sie auf Ihre Testzahlung, um die Zahlungsdetails anzuzeigen. Diese Seite zeigt die folgenden Informationen an: - Produkt, das gekauft wurde - Eingerichtetes [Abonnement](https://docs.stripe.com/api/subscriptions.md) (falls erworben) - [Rechnung](https://docs.stripe.com/api/invoices.md), die erstellt wurde - Über Managed Payments berechneter und einbehaltener Steuerbetrag - Zahlungsbeschreibung, die auf den Kontoauszügen Ihrer Kundinnen/Kunden angezeigt wird #### Zahlungsbeleg in der Vorschau anzeigen 1. Klicken Sie unter **Zahlungsbelegsverlauf** auf **Zahlungsbeleg anzeigen**. 1. Klicken Sie auf **Zahlungsbeleg senden**, um eine Vorschau der Zahlungsbeleg-E-Mail an Ihre Kundin oder Ihren Kunden anzuzeigen. > Im Sandbox-Modus erhalten Sie Zahlungsbelege nicht automatisch nach dem Kauf, sondern können sie manuell mit den obigen Anweisungen versenden. ### Link [Link](https://docs.stripe.com/payments/link.md) fungiert beim Bezahlvorgang als eingetragener Händler und unterstützt auf der Website von [Link](https://link.com) die Verwaltung von Abonnements und den Support von Transaktionen. Sie können testen, wie Link während des Bezahlvorgangs funktioniert, indem Sie während einer ersten Checkout-Session ein Link-Konto erstellen. Nachdem Sie das Link-Konto erstellt haben, versuchen Sie eine weitere Sitzung mit derselben E-Mail-Adresse. Um sich zu authentifizieren, verwenden Sie den Testpasscode `000000`. Testkäufe werden in der Link-App nicht angezeigt. Sie können die Tools zur Verwaltung von Bestellungen in der Link-App testen, indem Sie während einer Checkout-Session im Live-Modus ein Link-Konto erstellen. ## Optional: Steuerverhalten für Ihre Preise konfigurieren Das [tax_behavior](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#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](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#set-tax-behavior-on-price). 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](https://dashboard.stripe.com/settings/tax) und aktualisieren Sie die Einstellung **Steuer in Preise einbeziehen**.