# Konfigurieren Sie Testangebote für Abos Bieten Sie kostenlose oder kostenpflichtige Testzeiträume für Artikel in einem Abo an. ![](https://b.stripecdn.com/docs-statics-srv/assets/trial-offer.2128af954f90482fce40e29d1604a01b.png) Mit der [Trial Offer](https://docs.stripe.com/api/product-catalog/trial-offer.md?api-version=2026-09-30.endive) API lassen sich sowohl kostenlose als auch kostenpflichtige Einführungszeiträume für Ihre [Abonnements](https://docs.stripe.com/subscriptions.md) mit einer einzigen API-Integration verwalten. Mithilfe von Testangeboten können Sie Leads mit hoher Kaufabsicht qualifizieren, den Missbrauch von Testversionen reduzieren und Ihren Kundinnen und Kunden für eine begrenzte Dauer ermäßigte Tarife anbieten (zum Beispiel 1 USD für die erste Woche eines Angebots). ## Use Cases Mit Testangeboten können Sie Tests zu Aktionspreisen und Produktangeboten direkt in Stripe durchführen. Häufige Anwendungsszenarien für Testangebote sind: | Use Case | Beschreibung | | --- | --- | | **Ermäßigte Testzeiträume** | Um die Konversionsrate von Testzeiträumen zu kostenpflichtigen Abonnements zu verbessern und Umsatz zu generieren, können Sie vergünstigte Testzeiträume einrichten. Sie können beispielsweise einen reduzierten Einführungspreis von 4 USD für 4 Wochen oder einen kostenlosen 7-Tage-Testzeitraum anbieten. | | **Kostenlose Testzeiträume** | Um ein kostenloses Testabonnement anzubieten, fügen Sie dem Abo einen Posten mit 0 USD hinzu. | | **Aktualisieren Sie Testzeiträume** | Um mehr Premium-Funktionen zu verkaufen, können Sie Upgrade-Testzeiträume konfigurieren. Beispielsweise bieten Sie einer Kundin oder einem Kunden mit einem Basisplan einen 7-tägigen Testzeitraum an, in dem sie/er zu einem Basispreis auf Premium-Funktionen zugreifen kann. Nach Ablauf des Testzeitraums wird das Abonnement dann automatisch auf den Premium-Preis umgestellt. | | **Testzeiträume auf Postenebene** | Um Add-ons, KI-Pakete und andere Funktions-Bundles zu verkaufen, können Sie Testzeiträume auf Postenebene einrichten. Sie können Kunden/Kundinnen einen Testzeitraum für nur einen Posten in einem Abonnement anbieten, während Sie andere Posten zum regulären Preis in Rechnung stellen. | ## Before you begin - Ihre Integration muss [2026-09-30.endive](https://docs.stripe.com/changelog.md#2026-09-30.endive) oder neuer verwenden. Geben Sie diese [Stripe-Version](https://docs.stripe.com/api/versioning.md) in Ihrem Anfrage-Header an. - Um Testangebote zu nutzen, müssen Sie neue Abonnements erstellen, bei denen der Abrechnungsmodus auf [flexible](https://docs.stripe.com/billing/subscriptions/billing-mode.md#create-a-new-subscription-with-flexible-billing-mode) eingestellt ist, oder bestehende Abonnements, die den Abrechnungsmodus `classic` verwenden, so aktualisieren, dass diese stattdessen `flexible` verwenden. ### Einschränkungen **Integrationsbeschränkungen** - Testangebote werden beim Erstellen oder Aktualisieren von Abonnements im Dashboard oder mit der Subscriptions API unterstützt. Die folgenden Nutzeroberflächen-Integrationen unterstützen keine Testangebote: - Integrationen für [Checkout-Sitzungen](https://docs.stripe.com/payments/subscriptions.md) außerhalb der [privaten Vorschau](https://docs.stripe.com/payments/checkout/trial-offers.md). Eingeladene Konten können Testangebote mit dem von Stripe gehosteten Checkout mit flexiblem Abrechnungsmodus nutzen. - [Preistabellen](https://docs.stripe.com/payments/checkout/pricing-table.md) - [Payment Links](https://docs.stripe.com/payment-links.md) - [Elements mit Checkout-Sessions](https://docs.stripe.com/payments/elements.md) - Sie können Testangebote und den veralteten Parameter `trial_end` nicht zusammen verwenden. Wir empfehlen die Verwendung der Trial Offer API, um rabattierte Testzeiträume und kostenlose Testzeiträume zu konfigurieren. Um zwischen einem Testangebot und einem kostenlosen Testzeitraum für ein Abonnement zu wählen, [vergleichen Sie kostenlose Testzeiträume und Testangebote](https://docs.stripe.com/billing/subscriptions/trials/compare.md). **Dashboard-Beschränkungen** - Testangebote mit Abonnementplänen befinden sich in der öffentlichen Vorschau und werden im Dashboard nicht unterstützt. Verwenden Sie die API, um diese zu verwalten. - Sie können das Kundenportal verwenden, um Testangebote anzuzeigen und zu stornieren. Sie können zudem Abonnements mit Testangeboten reaktivieren. Sie können Abonnements mit Testangeboten nicht aktualisieren, pausieren oder fortsetzen. **Einschränkungen bei Abrechnung und Analysen** - Testangebote gelten nur für wiederkehrende Abonnementposten. Nicht wiederkehrende Posten kommen für kostenpflichtige Testversionen oder vergünstigte Testpreise nicht infrage. - Die Dauer des Testzeitraums kann nach dem Erstellen des Abonnements nicht mehr geändert werden. Sie können auch keine Verlängerungen oder Verkürzungen planen. - Der Preis nach der Testphase muss sich von jedem bereits im Abonnement enthaltenen Preis unterscheiden. - Stripe entfernt das Testangebot aus dem Abonnement, nachdem die Testphase endet. - Es gibt keine systemeigene Methode, um die Löschung eines einzelnen Abonnementpostens zu planen, wenn dessen Testphase endet. - In [Billing Analytics](https://docs.stripe.com/billing/subscriptions/analytics.md) tragen Testangebotsposten nicht zum MRR bei, solange sie sich in einer Testphase befinden. Andere Posten desselben Abonnements tragen weiterhin zum MRR bei. ## Funktionsweise von Testangeboten Bei einem Abonnement wird einer Kundin/einem Kunden ein Produkt zu einem festgelegten Preis regelmäßig in Rechnung gestellt. Wenn Sie ein Testangebot erstellen, geben Sie einen Testpreis und die Dauer der Testphase für ein Produkt an. Nach Ablauf der Testphase wechselt das Abonnement automatisch zum regulären Preis oder zu einem anderen von Ihnen konfigurierten Preis. > Sie benötigen zwei separate wiederkehrende Preisobjekte, um ein Testangebot zu erstellen – eines für die Testphase und eines für die Zeit nach der Testphase. Testangebote ersetzen keine [Produkte oder Preise](https://docs.stripe.com/products-prices/how-products-and-prices-work.md). `Testangebot` ist ein separates Objekt, das einem [Abonnementposten](https://docs.stripe.com/api/subscription_items.md) für eine begrenzte Zeit einen ermäßigten oder kostenlosen Preis zuweist. Der [Preis](https://docs.stripe.com/api/subscription_items/object.md?#subscription_item_object-price) des Postens ist der Testpreis, solange die Testphase aktiv ist, und der Übergangspreis nach deren Ende. ## Testangebot erstellen #### Dashboard So erstellen Sie ein Testangebot im Dashboard: 1. Navigieren Sie zur Seite [Produkte](https://dashboard.stripe.com/products). 2. Klicken Sie auf ein Produkt, um die Produktdetailseite zu öffnen. 3. Klicken Sie im Abschnitt **Testversionen** auf das Plus-Symbol (+). 4. Tragen Sie in das Dialogfenster **Testphase erstellen** den Testpreis, die Dauer und das Endverhalten ein. 5. Klicken Sie auf **Erstellen**. Sie können ein Testangebot auch im Abonnement-Editor erstellen: 1. Gehen Sie zur Seite [Abonnements](https://dashboard.stripe.com/subscriptions). 2. Klicken Sie auf **+ Abonnement erstellen** oder klicken Sie auf ein bestehendes Abonnement und wählen Sie **Aktionen** > **Abonnement aktualisieren**. 3. Klicken Sie auf **Testversion hinzufügen**. 4. Wählen Sie im Dialog **+ Testversion** aus, um ein neues Testangebot zu erstellen. 5. Fügen Sie die Details zur Testversion hinzu, einschließlich des Testpreises, der Dauer und des Endverhaltens. 6. Klicken Sie auf **Erstellen**. #### API Um [ein Testangebot zu erstellen](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-09-30.endive), übergeben Sie einen [Preis](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-09-30.endive#create_product_catalog_trial_offer-price) mithilfe der [price.id](https://docs.stripe.com/api/prices/object.md#price_object-id), um die Kosten während der Testphase zu definieren. Sie können diesen für kostenlose Testphasen auf 0 USD oder für kostenpflichtige Testphasen auf einen beliebigen positiven Betrag festlegen. Setzen Sie [duration.type](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-09-30.endive#create_product_catalog_trial_offer-duration-type) der Testphase auf `relativ` und verwenden Sie [duration.relative.iterations](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-09-30.endive#create_product_catalog_trial_offer-duration-relative-iterations), um die Anzahl der Abrechnungsintervalle zu definieren. Verwenden Sie dann [end_behavior.transition.price](https://docs.stripe.com/api/product-catalog/trial-offer/create.md?api-version=2026-09-30.endive#create_product_catalog_trial_offer-end_behavior-transition-price), um den Preis anzugeben, den das Abonnement verwendet, wenn die Testphase endet. Legen Sie optional `Nickname` fest, um dem Testangebot eine interne Bezeichnung hinzuzufügen. ### Testangebot mit relativer Laufzeit erstellen ```curl curl https://api.stripe.com/v1/product_catalog/trial_offers \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d price=price_trial \ -d "duration[relative][iterations]=1" \ -d "duration[type]=relative" \ -d "end_behavior[transition][price]=price_regular" ``` ### Testangebot mit Zeitstempeldauer erstellen > Die Dauer von Testangeboten mit Zeitstempel befindet sich in der [öffentlichen Vorschau](https://docs.stripe.com/release-phases.md). Die Funktionalität kann sich während der Entwicklung ändern. ```curl curl https://api.stripe.com/v1/product_catalog/trial_offers \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d price=price_trial \ -d "duration[type]=timestamp" \ -d "end_behavior[transition][price]=price_regular" ``` Um ein Testangebot zu archivieren und zu verhindern, dass es für neue Abonnements verwendet wird, [setzen Sie `aktiv` auf `falsch`](https://docs.stripe.com/api/product-catalog/trial-offer/update.md?api-version=2026-09-30.endive). Setzen Sie es auf `wahr`, um die Archivierung aufzuheben. ## Testangebot an ein neues Abonnement anhängen #### Dashboard So hängen Sie ein Testangebot an ein neues Abonnement im Dashboard an: 1. Gehen Sie zur Seite [Abonnements](https://dashboard.stripe.com/subscriptions). 2. Klicken Sie auf **+ Abonnement erstellen**. 3. Klicken Sie auf **Testversion hinzufügen**. 4. Wählen Sie im Dialogfeld ein bestehendes Testangebot aus oder wählen Sie **Neue Testphase**, um ein neues Testangebot zu erstellen, das dem Abonnement hinzugefügt werden soll. #### API Um ein Testangebot an ein [Abonnement](https://docs.stripe.com/api/subscriptions/object.md) anzufügen, geben Sie die [trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-09-30.endive#product_catalog_trial_offer_object-id) im Parameter [items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial) an: #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "billing_mode[type]=flexible" \ -d "items[0][current_trial][trial_offer]=to_123" \ -d "items[0][quantity]=1" ``` #### Customer v1 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer={{CUSTOMER_ID}}" \ -d "billing_mode[type]=flexible" \ -d "items[0][current_trial][trial_offer]=to_123" \ -d "items[0][quantity]=1" ``` ## Abonnements mit einem Testangebot aktualisieren ### Testangebot zu einem bestehenden Abonnement hinzufügen #### Dashboard So fügen Sie einem bestehenden Abonnement im Dashboard ein Testangebot hinzu: 1. Gehen Sie zur Seite [Abonnements](https://dashboard.stripe.com/subscriptions). 2. Klicken Sie auf das zu aktualisierende Abo und wählen Sie anschließend **Aktionen** > **Abo aktualisieren** aus. 3. Klicken Sie auf **Testversion hinzufügen**. 4. Wählen Sie im Dialogfenster ein bestehendes Testangebot oder **+ Testversion** aus, um ein neues Testangebot zu erstellen und dem Abonnement hinzuzufügen. #### API Um ein Testangebot einem bestehenden Abonnement hinzuzufügen, geben Sie die [trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-09-30.endive#product_catalog_trial_offer_object-id) im Parameter [items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial) an: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "items[0][current_trial][trial_offer]=to_123" ``` ### Testangebot zu einem Abonnement mit bestehenden Posten hinzufügen #### Dashboard So fügen Sie ein Testangebot als weiteren Posten zu einem Abonnement hinzu, das bereits Posten im Dashboard enthält: 1. Gehen Sie zur Seite [Abonnements](https://dashboard.stripe.com/subscriptions). 2. Klicken Sie auf das zu aktualisierende Abo und wählen Sie anschließend **Aktionen** > **Abo aktualisieren** aus. 3. Klicken Sie auf **Testversion hinzufügen**. 4. Wählen Sie im Dialogfenster ein bestehendes Testangebot oder **+ Testversion** aus, um ein neues Testangebot zu erstellen und dem Abonnement hinzuzufügen. #### API Um ein Testangebot als weiteren Posten an ein Abonnement anzufügen, das über vorhandene Posten verfügt, fügen Sie dem [Posten](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items)-Array einen Posten hinzu und geben Sie die [trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-09-30.endive#product_catalog_trial_offer_object-id) im Parameter [items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial) an: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "items[0][id]={{SUBSCRIPTIONITEM_ID}}" \ -d "items[1][current_trial][trial_offer]=to_123" \ -d "items[1][quantity]=1" ``` ### Abonnementposten in ein Testangebot umwandeln Um einen bestehenden Posten eines Abonnements in ein Testangebot umzuwandeln, fügen Sie die [items.id](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-id) ein und geben Sie die [trial_offer.id](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-09-30.endive#product_catalog_trial_offer_object-id) im Parameter [items.current_trial.trial_offer](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-current_trial) an: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "items[0][id]={{SUBSCRIPTIONITEM_ID}}" \ -d "items[0][current_trial][trial_offer]=to_123" ``` ### Postenmenge für ein Testangebot ändern #### Dashboard So ändern Sie die Menge des Postens für ein Testangebot im Dashboard: 1. Gehen Sie zur Seite [Abonnements](https://dashboard.stripe.com/subscriptions). 2. Klicken Sie auf das zu aktualisierende Abo und wählen Sie anschließend **Aktionen** > **Abo aktualisieren** aus. 3. Bearbeiten Sie das Mengenfeld, nachdem Sie den Posten für das Testangebot hinzugefügt haben. 4. Klicken Sie auf **Abonnement aktualisieren**. #### API Um die [Menge](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-items-quantity) des Postens für ein Testangebot zu ändern, aktualisieren Sie das Abonnement: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "items[0][id]={{SUBSCRIPTIONITEM_ID}}" \ -d "items[0][quantity]=2" ``` ## Testangebot zu einem Abonnementplan hinzufügen > Testangebote mit Abonnementplänen befinden sich in der [öffentlichen Vorschau](https://docs.stripe.com/release-phases.md). Die Funktionalität kann sich während der Entwicklung ändern. Sie können Zeitstempel-Testangebote nur mit [Abonnementplänen](https://docs.stripe.com/api/subscription_schedules.md?api-version=2026-03-25.preview) verwenden. Im Gegensatz zu Testzeiträumen mit relativer Dauer, die nach einer bestimmten Anzahl von Abrechnungsintervallen enden, ist das Ende bei Zeitstempel-Testzeiträumen ein absolutes Datum. Um eines zu erstellen, setzen Sie den [duration.type](https://docs.stripe.com/api/product-catalog/trial-offer/object.md?api-version=2026-03-25.preview#product_catalog_trial_offer_object-duration-type) des Testangebots auf `timestamp`: ```curl curl https://api.stripe.com/v1/product_catalog/trial_offers \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d price=price_trial \ -d "duration[type]=timestamp" \ -d "end_behavior[transition][price]=price_regular" ``` Verwenden Sie als Nächstes [phases.items.trial_offer](https://docs.stripe.com/api/subscription_schedules/create.md?api-version=2026-03-25.preview#create_subscription_schedule-phases-items-trial_offer), um das Testangebot der [Planphase](https://docs.stripe.com/api/subscription_schedules/create.md?api-version=2026-03-25.preview#create_subscription_schedule-phases) des Abonnementplans zuzuordnen: #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscription_schedules \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d start_date=1610403705 \ -d "phases[0][items][0][trial_offer]=to_123" \ -d "phases[0][end_date]=1610403706" ``` #### Customer v1 ```curl curl https://api.stripe.com/v1/subscription_schedules \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d "customer={{CUSTOMER_ID}}" \ -d start_date=1610403705 \ -d "phases[0][items][0][trial_offer]=to_123" \ -d "phases[0][end_date]=1610403706" ``` ## Abos mit Testangeboten anzeigen Wenn Sie [ein Abo abrufen](https://docs.stripe.com/api/subscriptions/retrieve.md), enthält die Antwort die Konfiguration für jeden Posten, einschließlich Testangebote: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" ``` ## Abo am Ende eines kostenpflichtigen Testzeitraums kündigen So kündigen Sie das Abonnement, wenn die kostenpflichtige Testversion endet: 1. Erstellen Sie ein Abonnement mit einem Testangebot. 2. Legen Sie das Kündigungsdatum auf das Ende des Testzeitraums fest. Dieser Ablauf unterstützt Opt-in-Verlängerungen, sodass Kundinnen und Kunden standardmäßig nicht automatisch auf ein wiederkehrendes Abonnement umgestellt werden. #### Dashboard So kündigen Sie ein Abonnement am Ende einer kostenpflichtigen Testversion im Dashboard: 1. Suchen Sie auf der Seite [Abonnements](https://dashboard.stripe.com/subscriptions) das entsprechende Abonnement, klicken Sie auf das Überlaufmenü (⋯) und wählen Sie **Abonnement kündigen** aus. 2. Wählen Sie **An einem benutzerdefinierten Tag** aus und legen Sie das Datum fest, um die Testversion und das Abonnement zu beenden. 3. Klicken Sie auf **Abonnement stornieren**. Weitere Informationen finden Sie unter [Abonnements kündigen](https://docs.stripe.com/billing/subscriptions/cancel.md#canceling). #### API Um ein Abonnement am Ende einer kostenpflichtigen Testversion zu kündigen, legen Sie den Parameter [cancel_at](https://docs.stripe.com/api/subscriptions/update.md?#update_subscription-cancel_at) auf das Ende des Testzeitraums fest: #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "items[0][current_trial][trial_offer]=to_123" \ -d "items[0][quantity]=1" \ -d cancel_at=1610403706 ``` #### Customer v1 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][current_trial][trial_offer]=to_123" \ -d "items[0][quantity]=1" \ -d cancel_at=1610403706 ``` ## Testangebote mit anderen Funktionen nutzen ### Testangebote mit nutzungsbasierter Abrechnung Beim Erstellen eines [Preisobjekts](https://docs.stripe.com/api/prices/object.md) können Sie anstelle eines wiederkehrenden Preises einen nutzungsbasierten Preis angeben und ihn einem Testangebot zuordnen. So können Sie dieselbe [nutzungsbasierte Abrechnung](https://docs.stripe.com/billing/subscriptions/usage-based.md) zu einem ermäßigten Preis anbieten. Um einen nutzungsbasierten Preis zu verwenden, legen Sie den [usage_type](https://docs.stripe.com/api/prices/object.md?#price_object-recurring-usage_type) auf `metered` fest und fügen Sie einen vorhandenen [Zähler](https://docs.stripe.com/api/prices/object.md?#price_object-recurring-meter) hinzu, um die Nutzung zu erfassen. ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d currency=usd \ -d billing_scheme=per_unit \ -d unit_amount=1 \ -d "recurring[interval]=week" \ -d "recurring[usage_type]=metered" \ -d "recurring[meter]=mtr_123" \ -d "product_data[name]=Trial Period Price" ``` Hängen Sie als Nächstes den Preis an ein Testangebot an – wie bei jedem anderen wiederkehrenden Preis auch: ```curl curl https://api.stripe.com/v1/product_catalog/trial_offers \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d price=price_trial \ -d "duration[relative][iterations]=1" \ -d "duration[type]=relative" \ -d "end_behavior[transition][price]=price_regular" ``` ## Weitere Überlegungen ### Status und Testangebot des Abos Bei der Nutzung von Testangeboten wird der `status` eines Abonnements durch den Testpreis bestimmt: - **Kostenlose Testzeiträume (0 USD)**: Wenn ein Abonnement nur Testangebote enthält und alle Preise für Testangebote auf 0 USD festgelegt sind, lautet der Status des Abonnements `trialing`. Dies entspricht dem Legacy-Verhalten von `trial_end` und ist ideal für kostenlose Testversionen mit Abrechnung ohne Karte oder standardmäßige kostenlose Testabläufe. - **Bezahlte Testversionen (>)**: Wenn das Abonnement einen regulären Posten hat oder die Testangebote einen Preis ungleich Null haben, ist der Status des Abos `active`, `incomplete` oder `past_due`. Dieses Verhalten imitiert andere Abonnements ohne Testangebote. Da für einen kostenpflichtigen Testzeitraum eine sofortige erfolgreiche Zahlung erforderlich ist, folgt das Abonnement dem Standard-Lifecycle `PaymentIntent`. Dadurch wird sichergestellt, dass Ihre bestehende Abrechnungslogik – etwa Webhooks für erfolgreiche Zahlungen – konsistent bleibt, unabhängig davon, ob der Kunde/die Kundin einen Aktionspreis oder den vollständigen wiederkehrenden Betrag zahlt. ### Ereignisse Jedes Mal, wenn sich ein Testzeitraum ändert, werden [Ereignisse](https://docs.stripe.com/api.md#event_types) ausgelöst. Stellen Sie sicher, dass Ihre Integration diese verarbeitet. Eventuell möchten Sie beispielsweise vor Ablauf eines Testzeitraums eine E-Mail an eine Kundin oder einen Kunden senden. Weitere Informationen zum [Umgang mit Abonnementereignissen](https://docs.stripe.com/billing/subscriptions/webhooks.md#events). In der folgenden Tabelle werden die Ereignisse beschrieben, die ausgelöst werden, bevor ein Testzeitraum abläuft, wenn ein Testabonnement unterbrochen oder gekündigt wird sowie wenn ein Abonnement wiederaufgenommen und aktiviert wird. | Ereignis | Beschreibung | Use Case | | --- | --- | --- | | `customer.subscription.deleted` | Wird gesendet, wenn ein Abonnement endet. | Verweigern Sie als Reaktion auf dieses Ereignis den Zugriff auf Ihr Produkt. Wenn ein Testzeitraum ohne Angabe einer Zahlungsmethode endet und das Endverhalten `missing_payment_method` des Abonnements auf `abbrechen` festgelegt ist, so geht das Abonnement in den Status `abgebrochen` über und versendet dieses Ereignis. | | `customer.subscription.resumed` | Wird gesendet, wenn ein Abonnement nicht mehr unterbrochen ist. Wenn Sie dieses Ereignis empfangen, gewähren Sie dem Kunden/der Kundin Zugriff auf das Produkt, wenn dieser widerrufen wurde, während das Abonnement pausiert war. | Unterbrochene Abonnements werden nach der Wiederaufnahme in aktive Abonnements umgewandelt. Die Wiederaufnahme eines Abonnements kann eine Rechnung und einen entsprechenden Payment Intent generieren, die bezahlt werden müssen, bevor das Abonnement den Status `pausiert` verlässt. | | `customer.subscription.paused` | Wird gesendet, wenn ein Abonnement vollständig ausgesetzt wurde. Die Invoicing erfolgt erst, wenn das Abonnement wieder aufgenommen wird. Wenn Sie dieses Ereignis erhalten, können Sie den Zugriff des/der Kund/in auf das Produkt widerrufen, bis er/sie eine Zahlungsmethode hinzufügt und das Abonnement wiederaufgenommen wird. | Beenden Sie als Reaktion auf dieses Ereignis den Zugriff auf Ihr Produkt. Das Abonnement wechselt in den Status `pausiert` und sendet dieses Ereignis, nachdem eine Testphase ohne Zahlungsmethode endet, sofern das Endverhalten für `missing_payment_method` des Abonnements auf `pausieren` gesetzt ist. Das Abonnement bleibt auf `pausiert`, bis es ausdrücklich fortgesetzt wird. | | `customer.subscription.updated` | Wird gesendet, wenn sich ein Abonnement oder dessen Posten ändern, einschließlich wenn ein Testangebot zu seinem Preis nach der Testphase übergeht. | Aktualisieren Sie Ihren Zugriffs- und Abrechnungsstatus basierend auf Änderungen an den Abonnementposten. | | `customer.subscription.trial_will_end` | Wird gemäß der Einstellung **Ereignisse zum Ende der Testphase** im Dashboard gesendet, die standardmäßig auf 3 Tage vor Ende der Testphase eingestellt ist. Wenn die Testphase kürzer als das konfigurierte Intervall ist, wird das Ereignis sofort ausgelöst. | Verwenden Sie dieses Ereignis, um Ihre eigene Erinnerungs-E-Mail zu senden. Von Stripe gehostete Erinnerungs-E-Mails werden 7 Tage vor Ende der Testphase gesendet. Weitere Informationen finden Sie unter [Compliance-Anforderungen für Testphasen und Werbeaktionen verwalten](https://docs.stripe.com/billing/subscriptions/trials/manage-trial-compliance.md). | ### Verhalten des Abrechnungszyklusankers Das Hinzufügen eines Testangebots zu einem bestehenden Abonnement setzt den [Abrechnungszyklus-Anker](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-trial_settings) des Abonnements nicht zurück. Wenn Sie einem Abonnement ein Testangebot hinzufügen, wird der Abrechnungszyklus des Postens für das Testangebot zunächst bei `trial_start` verankert, unabhängig vom [Abrechnungszyklus-Anker](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-trial_settings) des Abonnements. Das Hinzufügen des Testangebots ändert den Abrechnungszyklus-Anker des Abonnements nicht. Beispielsweise endet eine zweimonatige Testphase, die am 28. Februar beginnt, am 28. April, unabhängig davon, ob der Abrechnungszyklus-Anker des Abonnements auf den 29. oder 30. des Monats fällt. Wenn Sie den [Abrechnungszyklus-Anker](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-billing_cycle_anchor) des Abonnements auf `now` zurücksetzen, während ein Testangebot aktiv ist, richtet Stripe auch die Rechnungsstellungszeiträume des Postens für das Testangebot auf den neuen Abrechnungszyklus-Anker des Abonnements aus. `trial_start` oder `trial_end` dieses Postens bleiben unverändert. Stripe verarbeitet alle daraus resultierenden [anteiligen Verrechnungen](https://docs.stripe.com/billing/subscriptions/prorations.md) gemäß dem `proration_behavior` der Abonnementaktualisierung. Wenn das Testangebot endet und zum regulären wiederkehrenden Preis übergeht, können Sie mithilfe von `trial_settings.end_behavior.billing_cycle_anchor` konfigurieren, ob der Abrechnungszyklusanker des Abonnements zurückgesetzt wird: - `now` (Standard): Setzt den `billing_cycle_anchor` des Abonnements auf genau den Zeitpunkt zurück, zu dem das Testangebot abgeschlossen ist. Dadurch wird ein neuer Abrechnungszyklus für den regulären Preis erstellt und eine Rechnung mit vollem Betrag ohne anteilmäßige Verrechnung generiert. - `Unverändert`: Behält den ursprünglichen Anker von dem Zeitpunkt bei, zu dem das Abonnement erstellt wurde. Der Zeitraum zwischen dem Ende des Testzeitraums und dem nächsten natürlichen Ankerdatum wird als anteiliger Betrag in Rechnung gestellt. Wenn Sie beispielsweise einen 7-tägigen Testzeitraum für 1 USD anbieten und möchten, dass die erste monatliche Zahlung von 20 USD ab Tag 8 einen ganzen Monat abdeckt: 1. Januar 1: Abonnement mit 7-tägigem Testangebot erstellt. 2. Januar 8: Der Testzeitraum endet. Der `billing_cycle_anchor` wird automatisch auf den 8. Januar zurückgesetzt. 3. Rechnung: Stripe generiert eine Rechnung über den vollen wiederkehrenden Preis von 20 USD für den Zeitraum vom 8. Januar bis zum 8. Februar. Es wird keine anteilmäßige Verrechnung angewendet. #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "items[0][current_trial][trial_offer]={{TRIAL_OFFER_ID}}" \ -d "trial_settings[end_behavior][billing_cycle_anchor]=unchanged" ``` #### Customer v1 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Version: 2026-09-30.endive" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][current_trial][trial_offer]={{TRIAL_OFFER_ID}}" \ -d "trial_settings[end_behavior][billing_cycle_anchor]=unchanged" ``` ### Verhalten bei fehlender Zahlungsmethode Wenn ein Testangebot endet, können Sie mithilfe von `trial_settings.end_behavior.missing_payment_method` konfigurieren, wie Stripe reagiert, wenn die Kundschaft keine Zahlungsmethode hinterlegt hat. Stripe wendet dieses Verhalten am Ende jedes Testangebots an. Folgende Optionen stehen zur Verfügung: - `create_invoice` (Standard): Erstellt eine Rechnung. Wenn die Rechnung nicht bezahlt werden kann, wechselt das Abonnement zu `past_due`. - `Abbrechen`: Kündigt das Abonnement. - `Pausieren`: Pausiert das Abonnement, bis Sie es fortsetzen. Testangebote haben dieselben Einschränkungen wie veraltete kostenlose Testphasen ohne Zahlungsmethode, einschließlich der Einschränkung, dass nutzungsabhängige Posten nicht unterstützt werden. Konfigurationsbeispiele und weitere Details finden Sie unter [Kostenlose Testphasen ohne Erfassung der Zahlungsmethode erstellen](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#create-free-trials-without-payment). > #### Vorababrechnung überschreibt das Endverhalten der Testphase > > Die Vorababrechnung überschreibt `trial_settings.end_behavior.missing_payment_method`, wenn sie über das Ende einer Testphase hinausgeht, auch wenn `missing_payment_method` auf `pausieren` oder `abbrechen` gesetzt ist. Das Abonnement setzt seinen normalen Abrechnungszyklus nach Ende der Testphase fort. Weitere Informationen finden Sie unter [Vorababrechnung](https://docs.stripe.com/billing/subscriptions/prebilling.md). ## See also - [Produkte und Preise](https://docs.stripe.com/products-prices/overview.md) - [Preise](https://docs.stripe.com/api.md#prices) - [Abos](https://docs.stripe.com/api.md#subscriptions) - [Verwalten von Abo-Rechnungsstellungszeiträumen](https://docs.stripe.com/billing/subscriptions/billing-cycle.md)