# Stripe Checkout-Integration aktualisieren, um Managed Payments zu verwenden Erfahren Sie, wie Sie Ihre bestehende Stripe-Integration aktualisieren, um Managed Payments zu verwenden. Aktualisieren Sie Ihre bestehende Integration von [Stripe Checkout](https://docs.stripe.com/payments/checkout.md), um [Managed Payments](https://docs.stripe.com/payments/managed-payments/how-it-works.md) zu nutzen. Die Lösung mit Stripe als eingetragenem Händler kümmert sich für Sie um die Konformität mit den Vorschriften für indirekte Steuern in mehr als 80 Ländern, sowie um Betrugsprävention, den Umgang mit Zahlungsanfechtungen und transaktionsbezogenen Kundensupport. Sie können Managed Payments nur für neue Abonnements aktivieren, die über eine Checkout-Sitzung für Managed Payments erworben wurden. Bestehende Abonnements sind nicht berechtigt. Wenn Sie keine bestehende Checkout-Integration haben, [richten Sie stattdessen Managed Payments ein](https://docs.stripe.com/payments/managed-payments/set-up.md). ## Before you begin - Ihre [gehostete Seite](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=checkout&ui=stripe-hosted) oder [eingebettete Seite](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=checkout&ui=embedded-page) Integration muss 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 `Zahlungs-` oder `Abonnement`-Modus erstellt. - Aktivieren Sie Managed Payments in Ihrem [Dashboard](https://dashboard.stripe.com/settings/managed-payments). - Stellen Sie sicher, dass Ihre Produkte die [Anspruchsvoraussetzungen](https://docs.stripe.com/payments/managed-payments/eligibility.md) erfüllen, bevor Sie eine Zahlung mit Managed Payments abwickeln. - Verwenden Sie die API-Version `2025-03-31.basil` oder [höher](https://docs.stripe.com/changelog.md). > #### 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. ## Konfigurieren Sie Ihre Produkte für Managed Payments Verwenden Sie das Dashboard oder die API, um für jedes Ihrer *Produkte* (Products represent what your business sells—whether that's a good or a service) einen *Steuercode* (A tax code is the category of your product for tax purposes) festzulegen. Um Steuern zu berechnen, müssen Sie einen Steuercode auswählen, der [für Managed Payments berechtigt](https://docs.stripe.com/payments/managed-payments/eligibility.md#eligible-tax-codes) ist. #### Dashboard So aktualisieren Sie den Steuercode eines Produkts: 1. Wechseln Sie im Dashboard zum [Product Catalog](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. Berechtigte Steuercodes sind als `Eligible for Managed Payments` gekennzeichnet. 1. Klicken Sie auf **Produkt aktualisieren**. 1. Wiederholen Sie diese Schritte für jedes Produkt, das Sie mit Managed Payments verwenden möchten. #### 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 Schritt für jedes Produkt, das Sie mit Managed Payments verwenden möchten. Wenn Sie Ihre Produkte inline beim Erstellen Ihrer [Checkout-Sitzung](https://docs.stripe.com/api/checkout/sessions/create.md) anlegen, fügen Sie den `tax_code` im `product_data`-Objekt ein. #### 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 Legen Sie den Parameter `managed_payments[enabled]` fest, indem Sie den Aufruf Ihres Servers an die [Checkout Session API](https://docs.stripe.com/api/checkout/sessions/create.md) aktualisieren. #### Abonnements ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -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 "<>:" \ -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] 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. #### Abonnements | Kategorie | Parameter | Ursache | | ------------------------------------- | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Adaptive Pricing | `adaptive_pricing` | Adaptive Pricing ist für 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-Sitzung verfügbaren Zahlungsmethoden mithilfe von [dynamischen Zahlungsmethoden](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md), um Ihrer Kundschaft die relevantesten Zahlungsmethoden anzuzeigen. Erfahren Sie mehr über das [Konfigurieren der Einstellungen für Zahlungsmethoden](https://support.stripe.com/questions/payment-method-configurations-for-managed-payments) für Managed Payments. | | `payment_method_options` | | `payment_method_types` | | Kunden-Update | `customer_update[name]` | Managed Payments erfordert, dass Ihr Kunde/Ihre Kundin einen Namen und eine gültige Rechnungsadresse hat, um die Sales Tax zu berechnen. Wenn Sie beim Erstellen des Bezahlvorgangs die ID eines bestehenden [customer_account](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_account) oder eines [customer](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer) angeben, wird das Objekt mit allen Änderungen an Name oder Rechnungsadresse des Kunden/der Kundin 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 Aktionen nach dem Verkauf, wie z. B. Rechnungsstellung und Bestätigungs-E-Mails. | | `invoice_creation` | #### Einmalige Zahlungen | 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-Sitzung verfügbaren Zahlungsmethoden mithilfe von [dynamischen Zahlungsmethoden](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md), um Ihrer Kundschaft die relevantesten Zahlungsmethoden anzuzeigen. Erfahren Sie mehr über das [Konfigurieren der Einstellungen für Zahlungsmethoden](https://support.stripe.com/questions/payment-method-configurations-for-managed-payments) für 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 Ihr Kunde/Ihre Kundin einen Namen und eine gültige Rechnungsadresse hat, um die Sales Tax zu berechnen. Wenn Sie beim Erstellen des Bezahlvorgangs die ID eines bestehenden [customer_account](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_account) oder eines [customer](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer) angeben, wird das Objekt mit allen Änderungen an Name oder Rechnungsadresse des Kunden/der Kundin 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 und Kunden korrekt funktioniert. Weitere Informationen finden Sie unter [Testen](https://docs.stripe.com/testing.md). ### 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. Geben Sie, um die Zahlung abzuwickeln, Ihre E-Mail-Adresse, Telefonnummer und die Testkartennummer `4242 4242 4242 4242` mit beliebiger Prüfziffer und einem Gültigkeitsdatum in der Zukunft ein. ### Zahlungsdetails #### Abonnements 1. Nachdem Sie die Testzahlung bestätigt haben, rufen Sie im Dashboard die Seite [Transaktionen](https://dashboard.stripe.com/test/payments) auf. 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 Managed Payments nur, ihre Zahlungsmethode zu belasten. 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. #### Einmalzahlungen 1. Nachdem Sie die Testzahlung bestätigt haben, rufen Sie im Dashboard die Seite [Transaktionen](https://dashboard.stripe.com/test/payments) auf. 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 nach Käufen keine automatischen E-Mails mit Zahlungsbelegen. Sie können sie aber nach den obigen Anweisungen manuell 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 zum von Ihnen festgelegten Preis hinzukommt (`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, rufen Sie im Dashboard die Seite [Steuereinstellungen](https://dashboard.stripe.com/settings/tax) auf und aktualisieren Sie die Einstellung **Steuer soll in Preisen enthalten sein**.