# Kostenlose Testzeiträume bei Abonnements verwenden Bieten Sie kostenlose Testzeiträume für Abonnements mit dem Legacy-Parameter trial_end an. > #### Legacy > > Die folgenden Inhalte beschreiben einen *Legacy* (Technology that's no longer recommended)-Integrationspfad für das Anbieten kostenloser Testzeiträume. > > Wenn Sie eine neue Integration entwickeln, empfehlen wir Ihnen, [Testangebote für Abonnements zu konfigurieren](https://docs.stripe.com/billing/subscriptions/trials.md). Um sich zwischen einem kostenlosen Testzeitraum und einem Testangebot zu entscheiden, [vergleichen Sie kostenlose Testzeiträume und Testangebote](https://docs.stripe.com/billing/subscriptions/trials/compare.md). Sie können das *Abonnement* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis) eines Kunden/einer Kundin mit einer kostenlosen Testphase starten, indem Sie beim [Erstellen des Abonnements](https://docs.stripe.com/api.md#create_subscription) das Argument `trial_end` angeben. #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "items[0][price]={{PRICE_ID}}" \ -d trial_end=1610403705 ``` #### Customers v1 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][price]={{PRICE_ID}}" \ -d trial_end=1610403705 ``` > #### Verwenden Sie die Accounts v2 API zum Darstellen von Kundinnen und Kunden > > Die Accounts v2 API ist allgemein für Connect-Nutzer/innen verfügbar und für andere Stripe-Nutzer/innen in der öffentlichen Vorschau. Wenn Sie an der Accounts v2 Vorschau teilnehmen, müssen Sie eine [Vorschauversion](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning) in Ihrem Code angeben. > > Um der Vorschau von Accounts v2 beizutreten, gehen Sie zu [Kontovorschauen und -funktionen](https://dashboard.stripe.com/settings/previews) in Ihrem Dashboard und aktivieren Sie **wiederverwendbare Zahlungsmethoden für Global Payouts**. > > Für die meisten Anwendungsfälle empfehlen wir, [Ihre Kundinnen und Kunden als vom Kunden bzw. von der Kundin konfigurierte Account-Objekte abzubilden](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), anstatt [Customer](https://docs.stripe.com/api/customers.md)-Objekte zu verwenden. Der Parameter `trial_end` benötigt einen Zeitstempel, der den genauen Zeitpunkt des Endes des Testzeitraums angibt. Beim Erstellen eines Abos können Sie alternativ den Parameter [trial_period_days](https://docs.stripe.com/api.md#create_subscription-trial_period_days) verwenden: eine Ganzzahl, die die Anzahl der Tage angibt, die der Testzeitraum ab dem aktuellen Zeitpunkt dauert. Der Testzeitraum muss 730 Tage (2 Jahre) oder weniger betragen. Testzeiträume werden normalerweise zu Beginn eines Abos angewendet, aber Sie können auch einen Testzeitraum für ein bestehendes Abo verwenden, [um den Rechnungsstellungszeitraum (Zyklus) des Abos zu ändern ](https://docs.stripe.com/billing/subscriptions/billing-cycle.md). Wenn Sie ein Abonnement mit Testzeitraum erstellen, müssen Sie keine Zahlungsmethode hinzufügen. Es wird weiterhin eine sofortige *Rechnung* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) erstellt, aber der Betrag ist 0 und die [Beschreibungen der Rechnungsposten](https://docs.stripe.com/api/invoices/object.md#invoice_object-lines-data-description) enthalten den Wortlaut „Kostenlose Testversion“. Wenn der Testzeitraum endet und der `status` des Abos nicht auf `paused` gesetzt ist, erstellen wir eine Rechnung und senden eine `invoice.created`-Ereignisbenachrichtigung. Ungefähr eine Stunde später versuchen wir, diese Rechnung zu belasten. Ein neuer Rechnungsstellungszeitraum beginnt ebenfalls für die Kundin/den Kunden, wenn der Testzeitraum endet. Um eine Testversion vorzeitig zu beenden, führen Sie einen API-Aufruf zum [Aktualisieren des Abos](https://docs.stripe.com/api.md#update_subscription) durch und legen Sie den Wert `trial_end` auf einen neuen Zeitstempel fest, oder auf **now**, um sofort zu enden: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d trial_end=now ``` ## Testversionen mit nutzungsbasierter Abrechnung Sie können Testzeiträume für Abonnements mit nutzungsbasierter Abrechnung verwenden. Stripe stellt keine Rechnung für die während des Testzeitraums aufgezeichnete Nutzung, aber Sie können die Nutzung in der [Zählerereignisübersicht](https://docs.stripe.com/api/billing/meter-event-summary.md) für den Testzeitraum anzeigen. Nach Ablauf des Testzeitraums wird die Abrechnung für die aufgezeichnete Nutzung fortgesetzt. Stellen Sie sicher, dass Ihre Integration [Webhook-Ereignisse](https://docs.stripe.com/billing/subscriptions/webhooks.md) im Zusammenhang mit Änderungen des Status der Testversion ordnungsgemäß überwacht und verarbeitet. Einige Tage vor Ablauf einer Testphase, wenn das Abonnement von `trialing` zu `active` wechselt, erhalten Sie ein `customer.subscription.trial_will_end`-Ereignis. Wenn Sie dieses Ereignis erhalten, stellen Sie sicher, dass Sie im Kundenkonto über eine Zahlungsmethode verfügen, um sie zu belasten. Optional können Sie die Kundinnen/Kunden vorab über die bevorstehende Zahlung informieren. ### Nutzungsbasierte Abrechnung mit unterbrochenen Abonnements Sie können [Zählerereignisse](https://docs.stripe.com/api/billing/meter-event.md) senden, die mit einem Preis für ein Abo verknüpft sind, auch wenn es pausiert ist, aber diese Nutzung wird nicht in Rechnung gestellt. Zukünftige Rechnungen enthalten nur Zählerereignisse nach dem Wiederaufnahmedatum. Wenn Sie [ältere Nutzungsaufzeichnungen](https://docs.stripe.com/billing/subscriptions/usage-based-legacy.md) verwenden, können Sie keine neuen Nutzungsaufzeichnungen erstellen, während ein Abo pausiert ist. ## Hinzufügen einer neuen Testversion zu einem Abonnement, das zuvor in einer Testversion enthalten war Sie können einem Abonnement ohne Testzeitraum einen neuen Testzeitraum hinzufügen, indem Sie das Abonnement aktualisieren und dabei [trial_end](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-trial_end) angeben oder den zugehörigen Abonnementplan aktualisieren. Für Abonnements müssen Sie [phases.trial_end](https://docs.stripe.com/api/subscription_schedules/create.md?#create_subscription_schedule-phases-trial_end) angeben. Bei den meisten Abonnements, die nach dem Ende eines vorherigen Testzeitraums für eine neue Testversion verwendet werden, bleibt das Feld `trial_start` auf den Beginn der ersten Testphase festgelegt. Ab der [API Version vom 30.04.2025](https://docs.stripe.com/changelog/basil.md#2025-04-30.preview) wird bei [billing_mode](https://docs.stripe.com/api/subscription_schedules/create.md#create_subscription_schedule-billing_mode) auf `flexible`, `trial_start` der Beginn des aktuellen Testzeitraums angegeben. ## Abonnement in einer Testversion aktualisieren Abonnements in einer Testversion können Sie wie gewohnt aktualisieren. Durch Hinzufügen von Artikeln zu einem `billing_mode=flexible`- oder `billing_mode=classic`-Abonnement in einer Testversion wird eine Rechnung für diese Posten mit einem Betrag von 0 generiert. Bei `billing_mode=classic` kann die Rechnung mit einem Betrag von 0 Posten enthalten, die zuvor in Rechnung gestellt wurden. ## Testphasen mit add_invoice_items kombinieren Sie können Testzeiträume für Abonnements mit Einmalpreisen und `add_invoice_items` kombinieren. Dies ist nützlich, wenn Sie gleichzeitig mit dem Start eines Testzeitraums eine einmalige Gebühr oder ein Add-on berechnen möchten. Stripe generiert dann automatisch eine Rechnung für die einmalige Zahlung, obwohl der Testzeitraum noch nicht beendet ist. Der Kunde/die Kundin zahlt den einmaligen Betrag im Voraus, die wiederkehrende Abonnementabrechnung beginnt nach dem Ablauf des Testzeitraums. ## Erstellen Sie kostenlose Testversionen, ohne die Zahlungsmethode zu erfassen > Wenn Sie eine kostenlose Testversion ohne Zahlungsmethode starten, können Ihre potenziellen Kundinnen und Kunden Ihr Produkt oder Ihre Dienstleistung schneller ausprobieren. Spammer können jedoch auch viele gefälschte Kundinnen/Kunden, Nutzungen und Abonnements erstellen. Wir empfehlen, den Anmeldevorgang sorgfältig zu überdenken, um ein Gleichgewicht zu finden, das es für echte Kundinnen/Kunden einfach und für Spam-Bots schwierig macht, ihn zu missbrauchen (z. B. indem Kundinnen/Kunden ein Nutzerkonto erstellen und ein Captcha ausfüllen müssen, bevor sie ihr kostenloses Probeabonnement starten). Sie können Kund/innen für den kostenlosen Testzeitraum eines Abonnements registrieren, ohne deren Zahlungsdetails im Dashboard, in der API oder bei Checkout zu erfassen. Beim Erstellen des Abonnements können Sie angeben, ob das Abonnement gekündigt oder unterbrochen werden soll, wenn der Kunde/die Kundin während des Testzeitraums keine Zahlungsmethode angegeben hat. Um das Abonnement zu kündigen bzw. zu unterbrechen, legen Sie beim Erstellen oder Aktualisieren des Abonnements den Parameter `trial_settings.end_behavior.missing_payment_method` fest: - **Abonnement kündigen** – Wenn das kostenlose Testabonnements ohne Angabe einer Zahlungsmethode endet, wird dieses sofort gekündigt. Sie können ein weiteres Abonnement erstellen, wenn der/die Kund/in künftig einen kostenpflichtigen Plan abonnieren möchte. Legen Sie `missing_payment_method=cancel` fest, um das Abonnement zu kündigen, wenn ein Testzeitraum ohne verfügbare Zahlungsmethode endet. - **Abonnement unterbrechen** – Wenn das kostenlose Testabonnement ohne hinterlegte Zahlungsmethode endet, wird dieses unterbrochen. Wenn ein Abonnement unterbrochen wird, werden keine Rechnungen generiert (im Gegensatz dazu, wenn der [Zahlungseinzug](https://docs.stripe.com/billing/subscriptions/pause-payment.md) unterbrochen wird). Fügt Ihre Kundin/Ihr Kunde die gewünschte Zahlungsmethode nach der Unterbrechung des Abonnements hinzu, so kann dasselbe Abonnement wiederaufgenommen werden. Die Unterbrechung kann auf unbestimmte Zeit erfolgen. Legen Sie `missing_payment_method=pause` fest, um das Abonnement zu unterbrechen, wenn ein Testzeitraum ohne hinterlegte Zahlungsmethode abläuft. Alternativ legen Sie `missing_payment_method=create_invoice` so fest, dass die Rechnung erst am Ende des Testzeitraums in Rechnung gestellt wird, wenn keine Zahlungsmethode angegeben ist. Wenn bei der Finalisierung der Rechnung keine Zahlungsmethode angegeben wird, wird das Abonnement in `past_due` verschoben. Konfigurieren Sie in Ihren [Benachrichtigungseinstellungen für kostenlose Testzeiträume](https://dashboard.stripe.com/settings/billing/automatic) Erinnerungs-E-Mails, um die Zahlungsdetails Ihrer Kundinnen und Kunden zu erfassen. ### Kostenlose Testzeiträume ohne Zahlungsmethoden kündigen Über das Dashboard, die API oder Checkout können Sie kostenlose Testzeiträume für Abonnements erstellen, ohne Zahlungsdetails von Ihren Kund/innen erfassen zu müssen. Dort können Sie Ihre Abonnements auch so konfigurieren, dass diese nach Ablauf des Testzeitraums gekündigt werden, wenn keine Zahlungsmethode hinterlegt wurde. #### Dashboard Sie können das Dashboard verwenden, um Kundinnen und Kunden für eine kostenlose Testversion eines Abonnements anzumelden, ohne deren Zahlungsdaten zu erfassen: 1. Wählen Sie in den Abonnementeinstellungen des Dashboard die Option **+Abonnement erstellen** aus. 2. Nachdem Sie Ihre Kunden- und Produktinformationen hinzugefügt haben, wählen Sie **+Kostenlose Testversion hinzufügen** aus und geben Sie dann an, wie viele Tage die kostenlose Testversion dauert. 3. Wählen Sie die Option **Unterbrechen oder kündigen, wenn der kostenlose Testzeitraum ohne Zahlungsmethode endet** und wählen anschließend **Sofort kündigen** aus. Wenn Sie [Test-Uhren](https://docs.stripe.com/billing/testing/test-clocks.md) verwenden, gehen Sie zum Ende des Testzeitraums. In dem Fall wird Ihnen keine anstehende Rechnung für das Abonnement angezeigt. 4. Überwachen Sie das Ereignis `customer.subscription.deleted`, denn dieses informiert Sie darüber, wenn ein Abonnement am Ende eines Testzeitraums ohne hinterlegte Zahlungsmethode gekündigt wird. Wenn Sie eine Zahlungsmethode angeben oder die Option **Rechnung mit Link zur Zahlungsseite per E-Mail an Kund/in senden** auswählen, wird die Option **Unterbrechen oder kündigen, wenn der kostenlose Testzeitraum ohne Angabe einer Zahlungsmethode endet** nicht angezeigt. #### API Mit den folgenden API-Aufrufen können Sie Kund/innen für kostenlose Testzeiträume eines Abonnements anmelden, ohne deren Zahlungsdetails erfassen zu müssen. Wird am Ende des Testzeitraums keine Zahlungsmethode angegeben, so wird das Abonnement gekündigt. #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "items[0][price]={{PRICE_ID}}" \ -d trial_period_days=30 \ -d "payment_settings[save_default_payment_method]=on_subscription" \ -d "trial_settings[end_behavior][missing_payment_method]=cancel" ``` #### Customers v1 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][price]={{PRICE_ID}}" \ -d trial_period_days=30 \ -d "payment_settings[save_default_payment_method]=on_subscription" \ -d "trial_settings[end_behavior][missing_payment_method]=cancel" ``` Verwenden Sie den folgenden API-Aufruf, um bestehende Abonnements zu aktualisieren: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d "trial_settings[end_behavior][missing_payment_method]=cancel" ``` #### Checkout Sie können Stripe Checkout verwenden, um Kund/innen für eine kostenlose Testversion eines Abonnements anzumelden, ohne deren Zahlungsdaten zu erfassen. Erstellen Sie eine Checkout-Sitzung mit den folgenden Elementen: - Wörterbuch `subscription_data` mit: - Das Feld `trial_period_days`, das auf die Länge Ihres kostenlosen Testzeitraums (in Tagen) festgelegt ist. In diesem Beispiel beträgt der Testzeitraum 30 Tage. - Der Parameter `trial_settings[end_behavior]` wird auf `cancel` eingestellt. So wird sichergestellt, dass das Abonnement gekündigt wird, wenn der kostenlose Testzeitraum ohne verknüpfte Zahlungsmethode endet. - Das Feld `payment_method_collection` mit dem Wert `if_required`. Dadurch wird Stripe mitgeteilt, dass die Erfassung von Zahlungsinformationen beim Bezahlvorgang optional ist. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=subscription \ -d "line_items[0][price]=price_abc" \ -d "line_items[0][quantity]=1" \ -d "subscription_data[trial_settings][end_behavior][missing_payment_method]=cancel" \ -d "subscription_data[trial_period_days]=30" \ -d payment_method_collection=if_required \ --data-urlencode "success_url=https://example.com/success" ``` Wenn Sie beim Erstellen einer Checkout-Sitzung das Feld `trial_settings.end_behavior.missing_payment_method=cancel` des Abonnements bzw. das Abonnement im Feld `subscription_data` festlegen, wird das Abonnement bei fehlender Zahlungsmethode vor Ablauf des Testzeitraums gekündigt. ### Kostenlose Testzeiträume ohne Zahlungsmethoden unterbrechen Über das Dashboard, die API oder Checkout können Sie kostenlose Testzeiträume für Abonnements erstellen, ohne Zahlungsdetails von Ihren Kund/innen erfassen zu müssen. Dort können Sie Ihre Abonnements auch so konfigurieren, dass diese nach Ablauf des Testzeitraums unterbrochen werden, wenn keine Zahlungsmethode hinterlegt wurde. #### Dashboard Sie können das Dashboard verwenden, um Kund/innen für eine kostenlose Testversion eines Abonnements anzumelden, ohne deren Zahlungsdaten zu erfassen: 1. Wählen Sie in den Abonnementeinstellungen des Dashboard die Option **+Abonnement erstellen** aus. 2. Nachdem Sie eine Kundin oder einen Kunden ohne Zahlungsmethode ausgewählt und Produktinformationen hinzugefügt haben, wählen Sie **+Testtage hinzufügen** aus und geben Sie anschließend die Anzahl der Testtage ein, die die kostenlose Testphase dauert. 3. Wählen Sie unter dem Feld für die kostenlosen Testtage **Pausieren oder kündigen, wenn die kostenlose Testphase ohne Zahlungsmethode endet** aus und wählen Sie dann **Pausieren**. Wenn Sie [Test-Uhren](https://docs.stripe.com/billing/testing/test-clocks.md) verwenden, spulen Sie bis zum Ende der Testphase vor. Sie sehen keine anstehende Rechnung für das Abonnement. 4. Überwachen Sie das Ereignis `customer.subscription.paused`, denn dieses informiert Sie darüber, wenn ein Abonnement am Ende eines Testzeitraums ohne hinterlegte Zahlungsmethode unterbrochen wird. Wenn Sie eine Zahlungsmethode angeben oder die Option **Rechnung mit Link zur Zahlungsseite per E-Mail an Kund/in senden** auswählen, wird die Option **Unterbrechen oder kündigen, wenn der kostenlose Testzeitraum ohne Angabe einer Zahlungsmethode endet** nicht angezeigt. #### API Mit den folgenden API-Aufrufen können Sie Kund/innen für kostenlose Testzeiträume eines Abonnements anmelden, ohne deren Zahlungsdetails erfassen zu müssen. Wird am Ende des Testzeitraums keine Zahlungsmethode angegeben, so wird das Abonnement unterbrochen. #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "items[0][price]={{PRICE_ID}}" \ -d trial_period_days=30 \ -d "payment_settings[save_default_payment_method]=on_subscription" \ -d "trial_settings[end_behavior][missing_payment_method]=pause" ``` #### Customers v1 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][price]={{PRICE_ID}}" \ -d trial_period_days=30 \ -d "payment_settings[save_default_payment_method]=on_subscription" \ -d "trial_settings[end_behavior][missing_payment_method]=pause" ``` Verwenden Sie den folgenden API-Aufruf, um bestehende Abonnements zu aktualisieren: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d "trial_settings[end_behavior][missing_payment_method]=pause" ``` #### Checkout Sie können Stripe Checkout verwenden, um Kund/innen für eine kostenlose Testversion eines Abonnements anzumelden, ohne deren Zahlungsdaten zu erfassen. Erstellen Sie eine Checkout-Sitzung mit den folgenden Elementen: - Wörterbuch `subscription_data` mit: - Das Feld `trial_period_days`, das auf die Länge Ihres kostenlosen Testzeitraums (in Tagen) festgelegt ist. In diesem Beispiel beträgt der Testzeitraum 30 Tage. - Der Parameter `trial_settings[end_behavior]` wird auf `pause` eingestellt. So wird sichergestellt, dass das Abonnement unterbrochen wird, wenn der kostenlose Testzeitraum ohne verknüpfte Zahlungsmethode endet. - Das Feld `payment_method_collection` mit dem Wert `if_required`. Dadurch wird Stripe mitgeteilt, dass die Erfassung von Zahlungsinformationen beim Bezahlvorgang optional ist. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=subscription \ -d "line_items[0][price]=price_abc" \ -d "line_items[0][quantity]=1" \ -d "subscription_data[trial_settings][end_behavior][missing_payment_method]=pause" \ -d "subscription_data[trial_period_days]=30" \ -d payment_method_collection=if_required \ --data-urlencode "success_url=https://example.com/success" ``` Wenn Sie beim Erstellen einer Checkout-Sitzung das Feld `trial_settings.end_behavior.missing_payment_method=pause` des Abonnements bzw. das Abonnement im Feld `subscription_data` festlegen, wird das Abonnement bei fehlender Zahlungsmethode vor Ablauf des Testzeitraums unterbrochen. ### Zahlungsdetails von Ihren Kund/innen vor Ablauf des Testzeitraums einholen Konfigurieren Sie Ihr Abonnement so, dass automatisch eine Erinnerungs-E-Mail gesendet wird, wenn der Testzeitraum des Kunden/der Kundin bald abläuft. Sie müssen die Anforderungen des Kartennetzwerks erfüllen, wenn Sie Testversionen anbieten. Erfahren Sie mehr über die [Konformitätsanforderungen für Testzeiträume und Werbeaktionen](https://docs.stripe.com/billing/subscriptions/trials/manage-trial-compliance.md). ### Verwenden Sie das Kundenportal, um Zahlungen einzuziehen Nachdem Sie ein Abonnement für einen Kunden/eine Kundin erstellt haben, ohne eine Zahlungsmethode zu erfassen, können Sie ihn/sie zum Kundenportal von Billing weiterleiten, um seine/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. Achten Sie auf das Ereignis [customer.subscription.trial_will_end](https://docs.stripe.com/api/events/types.md#event_types-customer.subscription.trial_will_end). 2. Wenn das Abonnement keine [Standard-Zahlungsmethode](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-default_payment_method) hat, rufen Sie die Kunden-E-Mail-Adresse vom zugehörigen kundenseitig konfigurierten [Account](https://docs.stripe.com/api/v2/core/accounts/retrieve.md) oder [Customer](https://docs.stripe.com/api/customers/retrieve.md) ab. Senden Sie der Kundin oder dem Kunden eine Nachricht mit einem Link zu Ihrer Website. Betten Sie die Kunden-ID in die E-Mail ein, zum Beispiel **https://example.com?..&customer={{CUSTOMER\_ID}}**. 3. Wenn der Kunde/die Kundin Ihre Website betritt, erstellen Sie eine Kundenportal-Sitzung mit der Kunden-ID aus dem vorherigen Schritt. 4. Leitet Kundinnen/Kunden zum Kundenportal weiter, wo sie ihr Abonnement mit den Zahlungsdetails aktualisieren können. ### Erlauben Sie Kundinnen/Kunden, ihre Abonnements im Kundenportal zu reaktivieren Um das Abonnement einer Kundin/eines Kunden, dessen Testversion `paused` wurde, über das Kundenportal zu aktivieren, aktivieren Sie die kostenlose Testversion ohne Zahlungsmethode, wenn Sie ein neues Abonnement im Dashboard erstellen. ### Testversion konvertieren, wenn Kund/innen vor Ablauf der Testphase Zahlungsinformationen bereitstellen Abonnements und anstehende Rechnungen werden zu Beginn des Testzeitraums erstellt und am Ende des Testzeitraums aktiv, wenn der/die Kund/in eine Zahlungsmethode angibt. ### Konfigurieren der Unterbrechung, wenn keine Zahlungsmethode angegeben wird Nach Ablauf einer kostenlosen Testphase können Sie Abonnements so konfigurieren, dass sie pausiert werden, wenn für ein Abonnement pro Abonnement keine Standardzahlungsmethode verfügbar ist. Sie können unterbrochene Abonnements aktualisieren. Aktualisierungen, die in der Regel zu anteiligen Verrechnungen führen (Hinzufügen von Artikeln, Ändern von Preisen oder Plänen, Änderung der Menge usw.), erzeugen keine anteiligen Posten, da Kund/innen während dem unterbrochenen Abonnement keine Kosten in Rechnung gestellt werden. Möchten Sie einen Testzeitraum verlängern, nachdem ein Abonnement in den Status `paused` übergegangen ist, so müssen Sie das Abonnement erst wiederaufnehmen, bevor Sie einen Testzeitraum konfigurieren können. Wir überprüfen `default_source` und `default_payment_method` für das Abonnement und den/die Kund/in, um festzustellen, ob in einem Abonnement am Ende eines Testzeitraums eine Zahlungsmethode fehlt. ### Ein unterbrochenes Abonnement wiederaufnehmen Verwenden Sie das Dashboard, die API, das Kundenportal oder die gehostete Rechnungsseite, um ein unterbrochenes Abonnement wiederaufzunehmen. #### Dashboard So aktivieren Sie ein unterbrochenes Abonnement im Dashboard wieder: 1. Gehen Sie zum Abonnement, klicken Sie auf das Überlaufmenü (⋯) und wählen Sie **Abo wiederaufnehmen** aus. 2. Klicken Sie auf das Überlaufmenü (⋯) und wählen Sie **Abonnement aktualisieren** aus. 3. Wählen Sie **Abrechnungszyklus-Anker auf jetzt zurücksetzen** aus, um den Kunden/die Kundin sofort zu belasten. 4. Um dem Kunden/der Kundin den anteiligen Betrag in Rechnung zu stellen, klicken Sie auf **Rechnung für anteiligen Änderungsbetrag stellen**. 5. Klicken Sie auf **Abonnement aktualisieren**. #### API Wenn ein unterbrochenes Abonnement wiederaufgenommen wird, beginnt die Wiederaufnahme des Abonnements sofort. Mit dem Endpoint `resume` können Sie ein Abonnement wiederaufnehmen und optional das Datum in `billing_cycle_anchor` ändern oder anteilsmäßige Verrechnungen erstellen. Für den Wert `billing_cycle_anchor` für `unchanged` erstellen wir eine anteilsmäßige Verrechnung für den Teilzeitraum zwischen dem `proration_date` (der Standardwert ist `now`) und dem Ende des aktuellen Abrechnungszeitraums (es sei denn, `proration_behavior=none`). Dadurch wird auch eine Rechnung für den aktuellen Zeitraum erstellt, wenn `proration_behavior=always_invoice`. Verwenden Sie den Endpoint `resume`, um ein angehaltenes Abonnement fortzusetzen. Es muss keine Zahlungsmethode für das Abonnement angegeben werden, bevor Sie es wiederaufnehmen können (z. B. wenn Sie die Rechnung erstellen oder anzeigen möchten, bevor ein Kunde/eine Kundin die Zahlung vornimmt), die Rechnung muss jedoch bezahlt sein, bevor das Abonnement reaktiviert wird . Die Rechnung wird nach 23 Stunden automatisch storniert, wenn der zugehörige PaymentIntent keine Zahlungsmethode zugeordnet hat und nicht bestätigt wird. Wenn Sie ein Abonnement reaktivieren, werden die Zeitstempel `items.current_period_start` und `items.current_period_end` um die aktuelle Uhrzeit erweitert. Wenn `billing_cycle_anchor=now`, dann gilt `items.current_period_start == now`, wodurch ein neuer Zyklus gestartet wird, ähnlich wie bei der Konvertierung nach dem Ende der Testphase. #### Kundenportal Verwenden Sie das [Kundenportal zum Einzug von Zahlungen](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#use-the-customer-portal-to-collect-payment), und [leiten](https://docs.stripe.com/customer-management/integrate-customer-portal.md#redirect) Sie den Kunden/die Kundin dann an das Kundenportal. Die Kundinnen/Kunden können **Abonnement starten** auswählen und dann eine Zahlungsmethode hinzufügen, um ihr Abonnement fortzusetzen. #### Gehostete Rechnungsseite Um ein pausiertes Abonnement auf der [gehosteten Rechnungsseite](https://docs.stripe.com/invoicing/hosted-invoice-page.md) fortzusetzen, geben Sie eine Zahlungsmethode an und wählen Sie dann **Autorisieren und bezahlen** aus. ### Ein Abonnement in Invoicing stellen Während des Pausierens wird für ein Abonnement keine Rechnung erstellt. Wenn Sie mit der Erstellung von Rechnungen fortfahren möchten, verwenden Sie `pause_collection`, um den Einzug von Zahlungen zu stoppen, während Sie mit der Rechnungsstellung fortfahren und Abrechnungszeiträume vorrücken. Um eine Vorschau der Rechnung anzuzeigen, die bei der Wiederaufnahme eines pausierten Abonnements generiert wird, geben Sie [subscription_details.resume_at](https://docs.stripe.com/api/invoices/create_preview.md#create_create_preview-subscription_details-resume_at) an. ## Kombinieren Sie Testzeiträume mit einem bestimmten Abrechnungszyklusanker Sie können Testzeiträume mit `billing_cycle_anchor` kombinieren, wodurch ein kostenloser Zeitraum gefolgt von einem anteilsmäßig verrechneten Zeitraum entsteht, der in einen festen Rechnungsstellungszeitraum übergeht. Diese Funktion ist über die API verfügbar. Wenn Sie beispielsweise einer Kundin oder einem Kunden ab dem 15. Juli einen 7-tägigen kostenlose Testzeitraum anbieten und am 1. August mit der normalen Abrechnung beginnen möchten: - Am 15. Juli gewähren Sie der Kundin oder dem Kunden einen kostenlosen 7-Tage-Testzeitraum (bis zum 22. Juli). - Die Kundin oder der Kunde erhält am 22. Juli eine Rechnung über einen anteilmäßig verrechneten Betrag für den Zeitraum bis zum 1. August. - Der Kundin oder dem Kunden wird der volle Betrag am 1. August in Rechnung gestellt, dann am 1. September und so weiter. #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "items[0][price]={{PRICE_ID}}" \ -d trial_end=1753170047 \ -d billing_cycle_anchor=1627801200 ``` #### Customers v1 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][price]={{PRICE_ID}}" \ -d trial_end=1753170047 \ -d billing_cycle_anchor=1627801200 ``` Sie können auch `trial_end` verwenden, um den Rechnungsstellungszeitraum für ein bestehendes Abo zu ändern. Weitere Informationen finden Sie unter [Rechnungsstellungszeitraum bei bestehenden Abos ändern](https://docs.stripe.com/billing/subscriptions/billing-cycle.md#changing). ## See also - [Produkte und Preise](https://docs.stripe.com/products-prices/overview.md) - [Preise](https://docs.stripe.com/api.md#prices) - [Abonnements](https://docs.stripe.com/api.md#subscriptions) - [Verwalten von Abo-Rechnungsstellungszeiträumen](https://docs.stripe.com/billing/subscriptions/billing-cycle.md)