# Kostenlose Testversionen konfigurieren Zahlungen für Abonnements mit kostenlosen Testphasen verzögern. Sie können kostenlose Testzeiträume mit Stripe Checkout einrichten. Die maximale Dauer eines kostenlosen Testzeitraums beträgt 2 Jahre (730 Tage), aber die meisten Unternehmen verwenden kürzere Testzeiträume, z. B. 30 Tage. Einige Probleme, die bei längeren Testzeiträumen auftreten können: - Zahlungsmethoden, die vor der ersten Zahlung ablaufen - Geringere Konversionsraten # Gehostete Seite > This is a Gehostete Seite for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/free-trials?payment-ui=stripe-hosted. Sie können eine Checkout-Sitzung so konfigurieren, dass das Abonnement eines Kunden/einer Kundin mit einer kostenlosen Testversion gestartet wird, indem Sie einen der folgenden Parameter übergeben: - [subscription_data.trial_period_days](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-trial_period_days), die Dauer (in Tagen) Ihrer kostenlosen Testversion. - [subscription_data.trial_end](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-trial_end), ein Unix-Zeitstempel, der das Ende des Testzeitraums darstellt. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=subscription \ --data-urlencode "success_url=https://example.com/success" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "subscription_data[trial_period_days]=30" ``` ## Kostenlose Testversionen ohne Erfassung der Zahlungsmethode Standardmäßig erfassen Checkout-Sitzungen eine Zahlungsmethode, die nach Ablauf des Testzeitraums verwendet werden soll. Sie können Kundinnen/Kunden für kostenlose Testversionen anmelden, ohne Zahlungsdetails zu erfassen, indem Sie [payment_method_collection=if_required](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_method_collection) übergeben. Wählen Sie, ob das Abonnement gekündigt oder unterbrochen werden soll, wenn der Kunde/die Kundin vor Ablauf des Testzeitraums keine Zahlungsmethode angibt, indem Sie [trial_settings.end_behavior.missing_payment_method](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-trial_settings-end_behavior-missing_payment_method) übergeben. - **Abonnement kündigen**: Wenn das kostenlose Testabonnement ohne Zahlungsmethode endet, wird es sofort gekündigt. Sie können ein weiteres Abonnement erstellen, wenn der Kunde/die Kundin in Zukunft einen kostenpflichtigen Plan abonnieren möchte. - **Abonnementunterbrechen** – Wenn das kostenlose Testabonnement ohne hinterlegte Zahlungsmethode endet, wird es unterbrochen und der Zyklus geht erst weiter, wenn es wieder aufgenommen wird. Wenn ein Abonnement unterbrochen wird, werden keine Rechnungen generiert (im Gegensatz dazu, wenn der [Zahlungseinzug](https://docs.stripe.com/billing/subscriptions/pause-payment.md) eines Abonnements unterbrochen wird). Wenn Ihr Kunde/Ihre Kundin seine/ihre Zahlungsmethode nach der Unterbrechung des Abonnements hinzufügt, können Sie dasselbe Abonnement wiederaufnehmen. Das Abonnement kann auf unbestimmte Zeit ausgesetzt bleiben. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=subscription \ --data-urlencode "success_url=https://example.com/success" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "subscription_data[trial_period_days]=30" \ -d "subscription_data[trial_settings][end_behavior][missing_payment_method]=cancel" \ -d payment_method_collection=if_required ``` ### Zahlungsdetails automatisch erfassen Erfassen Sie Zahlungsdetails von Ihrem Kunden/Ihrer Kundin, bevor die Testversion abläuft. Unter **Benachrichtigungen für kostenlose Testversionen verwalten** in Ihren [E-Mail- und Abonnement-Einstellungen](https://dashboard.stripe.com/settings/billing/automatic) können Sie festlegen, dass automatisch eine Erinnerungs-E-Mail gesendet wird, kurz bevor die Testphase eines Kunden/einer Kundin abläuft. Wählen Sie anschließend die Option **Link zu einer von Stripe gehosteten Seite** aus, damit die Erinnerungs-E-Mail einen Link enthält, über den der Kunde oder die Kundin seine bzw. ihre Zahlungsdaten hinzufügen oder aktualisieren kann. In einer Sandbox versenden wir keine Erinnerungs-E-Mails für kostenlose Testversionen. Erfahren Sie mehr darüber, wie Sie [Erinnerungen für kostenlose Testversionen einrichten](https://docs.stripe.com/billing/revenue-recovery/customer-emails.md#trial-ending-reminders). Wenn Sie Testzeiträume anbieten, müssen Sie die Anforderungen des Kartennetzwerks erfüllen. Hier erhalten Sie weitere Informationen zu [Compliance-Anforderungen für Testzeiträume und Angebote](https://docs.stripe.com/billing/subscriptions/trials/manage-trial-compliance.md). ### Zahlungsinformationen über das Kundenportal von Billing erfassen Sie können die Erinnerungs-E-Mail auch selbst senden und Kunden/innen an das Kundenportal von Billing verweisen, um ihre Zahlungsdetails hinzuzufügen. Konfigurieren Sie zunächst das [Billing-Kundenportal](https://docs.stripe.com/customer-management.md), damit Ihre Kundinnen/Kunden ihre Abonnements verwalten können. Erfassen Sie als Nächstes die Rechnungsinformationen von Ihren Kund/innen: 1. Überwachen Sie das [Ereignis](https://docs.stripe.com/api/events/types.md#event_types-customer.subscription.trial_will_end) `customer.subscription.trial_will_end`. 1. Wenn das Abonnement keine [Standardzahlungsmethode](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-default_payment_method) hat, rufen Sie die E-Mail des Kunden/der Kundin über das [Kunden-API](https://docs.stripe.com/api/customers/retrieve.md) ab und senden ihm/ihr einen Link zu Ihrer Website. Es ist hilfreich, die Kunden-ID in die E-Mail einzubetten, zum Beispiel `https://example.com?...&customer={{CUSTOMER_ID}}`. 1. Wenn der Kunde/die Kundin Ihre Website betritt, erstellen Sie eine Kundenportalsitzung mit der Kunden-ID aus dem vorherigen Schritt. 1. [Leiten](https://docs.stripe.com/customer-management/integrate-customer-portal.md#redirect) Sie Kundinnen/Kunden zum Kundenportal weiter, wo sie ihre Zahlungsdetails aktualisieren können. Ihre Kundinnen und Kunden können [ihr pausiertes Abonnement auch im Kundenportal wieder aufnehmen](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#resume-a-paused-subscription), indem sie auf **Abonnement starten** klicken und anschließend eine Zahlungsmethode hinzufügen. Informieren Sie sich im Abschnitt [Kostenlose Testzeiträume](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#create-free-trials-without-payment), wie Sie ein Abonnement so konfigurieren können, dass es pausiert oder gekündigt wird, wenn ein kostenloser Testzeitraum endet und keine Zahlungsmethode hinterlegt ist. # Eingebettete Seite > This is a Eingebettete Seite for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/free-trials?payment-ui=embedded-form. Sie können eine Checkout-Sitzung so konfigurieren, dass das Abonnement eines Kunden/einer Kundin mit einer kostenlosen Testversion gestartet wird, indem Sie einen der folgenden Parameter übergeben: - [subscription_data.trial_period_days](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-trial_period_days), die Dauer (in Tagen) Ihrer kostenlosen Testversion. - [subscription_data.trial_end](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-trial_end), ein Unix-Zeitstempel, der das Ende des Testzeitraums darstellt. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=subscription \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "subscription_data[trial_period_days]=30" ``` ## Kostenlose Testversionen ohne Erfassung der Zahlungsmethode Standardmäßig erfassen Checkout-Sitzungen eine Zahlungsmethode, die nach Ablauf des Testzeitraums verwendet werden soll. Sie können Kundinnen/Kunden für kostenlose Testversionen anmelden, ohne Zahlungsdetails zu erfassen, indem Sie [payment_method_collection=if_required](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_method_collection) übergeben. Wählen Sie, ob das Abonnement gekündigt oder unterbrochen werden soll, wenn der Kunde/die Kundin vor Ablauf des Testzeitraums keine Zahlungsmethode angibt, indem Sie [trial_settings.end_behavior.missing_payment_method](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-subscription_data-trial_settings-end_behavior-missing_payment_method) übergeben. - **Abonnement kündigen**: Wenn das kostenlose Testabonnement ohne Zahlungsmethode endet, wird es sofort gekündigt. Sie können ein weiteres Abonnement erstellen, wenn der Kunde/die Kundin in Zukunft einen kostenpflichtigen Plan abonnieren möchte. - **Abonnementunterbrechen** – Wenn das kostenlose Testabonnement ohne hinterlegte Zahlungsmethode endet, wird es unterbrochen und der Zyklus geht erst weiter, wenn es wieder aufgenommen wird. Wenn ein Abonnement unterbrochen wird, werden keine Rechnungen generiert (im Gegensatz dazu, wenn der [Zahlungseinzug](https://docs.stripe.com/billing/subscriptions/pause-payment.md) eines Abonnements unterbrochen wird). Wenn Ihr Kunde/Ihre Kundin seine/ihre Zahlungsmethode nach der Unterbrechung des Abonnements hinzufügt, können Sie dasselbe Abonnement wiederaufnehmen. Das Abonnement kann auf unbestimmte Zeit ausgesetzt bleiben. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=subscription \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "subscription_data[trial_period_days]=30" \ -d "subscription_data[trial_settings][end_behavior][missing_payment_method]=cancel" \ -d payment_method_collection=if_required ``` ### Zahlungsdetails automatisch erfassen Erfassen Sie Zahlungsdetails von Ihrem Kunden/Ihrer Kundin, bevor die Testversion abläuft. Unter **Benachrichtigungen für kostenlose Testversionen verwalten** in Ihren [E-Mail- und Abonnement-Einstellungen](https://dashboard.stripe.com/settings/billing/automatic) können Sie festlegen, dass automatisch eine Erinnerungs-E-Mail gesendet wird, kurz bevor die Testphase eines Kunden/einer Kundin abläuft. Wählen Sie anschließend die Option **Link zu einer von Stripe gehosteten Seite** aus, damit die Erinnerungs-E-Mail einen Link enthält, über den der Kunde oder die Kundin seine bzw. ihre Zahlungsdaten hinzufügen oder aktualisieren kann. In einer Sandbox versenden wir keine Erinnerungs-E-Mails für kostenlose Testversionen. Erfahren Sie mehr darüber, wie Sie [Erinnerungen für kostenlose Testversionen einrichten](https://docs.stripe.com/billing/revenue-recovery/customer-emails.md#trial-ending-reminders). Wenn Sie Testzeiträume anbieten, müssen Sie die Anforderungen des Kartennetzwerks erfüllen. Hier erhalten Sie weitere Informationen zu [Compliance-Anforderungen für Testzeiträume und Angebote](https://docs.stripe.com/billing/subscriptions/trials/manage-trial-compliance.md). ### Zahlungsinformationen über das Kundenportal von Billing erfassen Sie können die Erinnerungs-E-Mail auch selbst senden und Kunden/innen an das Kundenportal von Billing verweisen, um ihre Zahlungsdetails hinzuzufügen. Konfigurieren Sie zunächst das [Billing-Kundenportal](https://docs.stripe.com/customer-management.md), damit Ihre Kundinnen/Kunden ihre Abonnements verwalten können. Erfassen Sie als Nächstes die Rechnungsinformationen von Ihren Kund/innen: 1. Überwachen Sie das [Ereignis](https://docs.stripe.com/api/events/types.md#event_types-customer.subscription.trial_will_end) `customer.subscription.trial_will_end`. 1. Wenn das Abonnement keine [Standardzahlungsmethode](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-default_payment_method) hat, rufen Sie die E-Mail des Kunden/der Kundin über das [Kunden-API](https://docs.stripe.com/api/customers/retrieve.md) ab und senden ihm/ihr einen Link zu Ihrer Website. Es ist hilfreich, die Kunden-ID in die E-Mail einzubetten, zum Beispiel `https://example.com?...&customer={{CUSTOMER_ID}}`. 1. Wenn der Kunde/die Kundin Ihre Website betritt, erstellen Sie eine Kundenportalsitzung mit der Kunden-ID aus dem vorherigen Schritt. 1. [Leiten](https://docs.stripe.com/customer-management/integrate-customer-portal.md#redirect) Sie Kundinnen/Kunden zum Kundenportal weiter, wo sie ihre Zahlungsdetails aktualisieren können. Ihre Kundinnen und Kunden können [ihr pausiertes Abonnement auch im Kundenportal wieder aufnehmen](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#resume-a-paused-subscription), indem sie auf **Abonnement starten** klicken und anschließend eine Zahlungsmethode hinzufügen. Informieren Sie sich im Abschnitt [Kostenlose Testzeiträume](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#create-free-trials-without-payment), wie Sie ein Abonnement so konfigurieren können, dass es pausiert oder gekündigt wird, wenn ein kostenloser Testzeitraum endet und keine Zahlungsmethode hinterlegt ist. ## See also - [Verwendung von Testzeiträumen bei Abonnements](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md) - [Vor Ablauf der Testphase eine Erinnerung per E-Mail senden](https://docs.stripe.com/billing/subscriptions/trials/manage-trial-compliance.md#notify-customers-with-trial-end-reminder-emails) - [Testzeiträume mit nutzungsbasierter Abrechnung kombinieren](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#trials-usage-based-billing)