Verwendung von Testphasen bei Abonnements

Verzögern Sie Zahlungen für aktive Abonnements mit Testphasen.

Sie können das Abonnement eines Kunden/einer Kundin mit einer kostenlosen Testphase starten, indem Sie beim Erstellen des Abonnements das Argument trial_end angeben.

Der Parameter trial_end verwendet einen Zeitstempel, der das genaue Ende der Testphase angibt. Beim Erstellen eines Abonnements können Sie alternativ das Argument trial_period_days verwenden: eine Ganzzahl, die die Anzahl der Tage angibt, die die Testversion ab dem aktuellen Zeitpunkt dauert. Der Testzeitraum darf nicht mehr als 730 Tage (2 Jahre) andauern.

Wenn Sie ein Abonnement mit einer Testphase erstellen, ist für den Kunden/die Kundin keine Zahlungsmethode erforderlich. Es wird trotzdem sofort eine Rechnung erstellt, jedoch mit einem Betrag von 0 USD.

Wenn der status des Abonnements nicht paused lautet, generieren wir eine Rechnung und senden eine Benachrichtigung über das Ereignis invoice.created. Etwa eine Stunde später versuchen wir, diese Rechnung zu belasten. Mit Ablauf der Testphase beginnt für den/die Kund/in ebenfalls ein neuer Abrechnungszyklus.

Um eine Testversion vorzeitig zu beenden, führen Sie einen API-Aufruf zum Aktualisieren des Abos durch und legen Sie den Wert trial_end auf einen neuen Zeitstempel fest, oder auf now, um sofort zu enden:

Testphasen mit Abrechnungszyklusanker kombinieren

Seit der API-Version 2018-02-05 können Sie Testphasen auch mit billing_cycle_anchor kombinieren, wodurch auf den kostenlosen Zeitraum ein anteilsmäßig verrechneter Zeitraum folgt und darauf ein fester Abrechnungszyklus.

Angenommen, es ist der 15. eines Monats und Sie möchten Ihrem Kunden eine kostenlose 7-Tage-Testversion (bis zum 22.) geben und dann mit der normalen Abrechnung am 1. beginnen. Sie können dies über die API tun, indem Sie Testversionen mit billing_cycle_anchor kombinieren. (Dies ist derzeit nicht über das Dashboard verfügbar.)

In diesem Beispiel erhält der/die Kund/in am 22. eine Rechnung über einen anteiligen Betrag (für den Zeitraum bis zum 1.). Dann wird ihm/ihr am 1. des nächsten Monats erneut der vollständige Betrag in Rechnung gestellt und so weiter.

Gestaffelte Abrechnung mit unterbrochenen Abonnements

Sie können Zählerereignisse senden, die mit einem Preis für ein Abonnement verknüpft sind, auch wenn es pausiert ist. Nach der Wiederaufnahme des Abonnements enthält die Rechnung jedoch keine Zählerereignisse, die während der Unterbrechung gesendet wurden. Zukünftige Rechnungen enthalten nur Zählerereignisse, die nach dem Wiederaufnahmedatum auftreten. Wenn Sie ältere Nutzungsdatensätze verwenden, können Sie keine neuen Nutzungdatensätze erstellen, während ein Abonnement pausiert ist.

Hinzufügen einer neuen Testversion zu einem Abonnement, das zuvor in einer Testversion enthalten war

Sie können eine neue Testversion zu einem Abonnement hinzufügen, das nicht im Testbetrieb verwendet wird, indem Sie das Abonnement unter Angabe von trial_end aktualisieren oder den zugehörigen Abonnementplan aktualisieren. Sie müssen phases.trial_end für Abonnements angeben.

Wenn ein Abonnement nach Ablauf eines vorherigen Testzeitraums in eine neue Testphase aufgenommen wird, bleibt das Feld trial_start auf den Beginn des ersten Testzeitraums festgelegt. Ab der API-Version vom 30.04.2025 gibt trial_start automatisch den Beginn der neu hinzugefügten Testversion für Abonnements an, wobei billing_mode auf credits_attributed_to_debits festgelegt ist.

Testphasen mit add_invoice_items kombinieren

Testphasen für Abonnements können mit Einmalpreisen und add_invoice_items kombiniert werden. Dies kann zum Beispiel passieren, wenn Sie eine einmalige Gebühr oder einen Zusatz gleichzeitig mit dem Beginn einer Testphase abbuchen möchten. Beachten Sie, dass dadurch eine Rechnung über den Betrag des einmaligen Artikels zu Beginn der Testphase sofort gekürzt wird.

Anforderungen an die Konformität in Verbindung mit Testphasen und Sonderangeboten

Sie müssen die Anforderungen des Kartennetzwerks erfüllen, wenn Sie Testversionen anbieten, unabhängig davon, ob diese kostenlos sind oder nicht. Dazu zählen Szenarien wie kostenlose Testversionen oder die Berechnung eines ermäßigten Preises für die ersten Monate und dann automatisch die Berechnung Ihres normalen Preises. Wenn Sie unsere Testfunktionen nutzen, können Sie die Nachrichteneinstellungen im Stripe-Dashboard aktivieren, um die Anforderungen zu erfüllen.

Wenn Sie Nutzer/innen über erfolgreiche Zahlungen benachrichtigen, zeigt Stripe in diesen Benachrichtigungen automatisch Informationen zu der Testversion und der Kündigungs-URL an.

Wenn Sie diese Einstellungen nicht verwenden, sind Sie dennoch für die Einhaltung der Anforderungen verantwortlich.

Wenn Kunden-E-Mails aktiviert sind, wird sieben Tage vor Ablauf einer Testphase eine Erinnerung gesendet. Wenn eine Testphase kürzer als sieben Tage ist, wird die Erinnerungs-E-Mail versendet, sobald diese beginnt. Werden Testphasen verlängert, wird eine Erinnerungs-E-Mail erneut gesendet.

Wenn während einer Testphase sowohl Testphasen-Erinnerungen als auch Erinnerungen an Abonnementverlängerungen aktiviert sind, erhalten Kund/innen nur die Erinnerung an den Ablauf der Testversion. E-Mails bezüglich Abonnementverlängerungen werden für nachfolgende Abrechnungszeiträume versendet.

Der Link zur Kündigungsrichtlinie ist eine URL, die zusammen mit anderen Informationen zur Testphase auf Kundenbelegen angezeigt wird. Diese Informationen sind bei allen Kartenzahlungen enthalten. Die Kündigungs-URL ist auch in der Erinnerungs-E-Mail enthalten, die sieben Tage vor Ablauf der Testphase an die Kund/innen gesendet wird.

Zahlungsbeschreibungen in der Abrechnung: Wenn Sie die Zahlungsbeschreibung in der Abrechnung für die Rechnung manuell festlegen, wird der Text für die Testphase nicht angehängt, sodass Sie ihn selbst hinzufügen müssen. Wenn Sie Produktzahlungsbeschreibungen verwenden, wird der Testphasentext automatisch angehängt. Das Zeichenlimit liegt bei 22, sodass nach dem 10. Zeichen alles mit * TRIAL OVER überschrieben wird.

Wenn Sie die Zahlungsbeschreibung in der Abrechnung nicht manuell festlegen oder Produktzahlungsbeschreibungen verwenden, wird der Testphasentext an die Zahlungsbeschreibung Ihres Kontos angehängt. Bei Bedarf können Sie eine verkürzte Zahlungsbeschreibung einrichten, um sicherzustellen, dass der Testphasentext korrekt angezeigt wird.

Vorschriften einhalten, ohne die Funktionen von Stripe zu nutzen

Wenn Sie Testphasen oder Sonderaktionen anbieten, ohne unsere Testphasenoptionen zu verwenden, müssen Sie die Vorschriften trotzdem einhalten. Sie können auf das Ereignis invoice.upcoming warten, um zu bestimmen, wann E-Mail-Benachrichtigungen gesendet werden sollen. So fügen Sie einen Text in Ihre Zahlungsbeschreibung in der Abrechnung hinzu, der über das Ende der Sonderaktion informiert:

Auf das Ereignis customer.subscription.updated warten
Überprüfen, ob eine Testphase oder Sonderaktion abgelaufen ist
Aktualisieren Sie die Zahlungsbeschreibung in der Abrechnung auf der latest_invoice des Abonnements

Sie müssen die letzte Rechnung innerhalb einer Stunde nach ihrer Erstellung aktualisieren, noch während sie sich im Entwurfstatus befindet.

Erstellen Sie kostenlose Testversionen, ohne die Zahlungsmethode zu erfassen

Sicherheitshinweis

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 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 Erinnerungs-E-Mails, um die Zahlungsdetails Ihrer Kund/innen in Ihren Benachrichtigungseinstellungen für kostenlose Testzeiträume 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.

Sie können das Dashboard verwenden, um Kund/innen für eine kostenlose Testversion eines Abonnements anzumelden, ohne deren Zahlungsdaten zu erfassen:

Wählen Sie in den Abonnementeinstellungen des Dashboard die Option +Abonnement erstellen aus.
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.
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 verwenden, gehen Sie zum Ende des Testzeitraums. In dem Fall wird Ihnen keine anstehende Rechnung für das Abonnement angezeigt.
Ü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.

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.

Sie können das Dashboard verwenden, um Kund/innen für eine kostenlose Testversion eines Abonnements anzumelden, ohne deren Zahlungsdaten zu erfassen:

Wählen Sie in den Abonnementeinstellungen des Dashboard die Option +Abonnement erstellen aus.
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.
Wählen Sie die Option Unterbrechen oder kündigen, wenn der kostenlose Testzeitraum ohne Zahlungsmethode endet und wählen anschließend Unterbrechen aus. Wenn Sie Test-Uhren verwenden, gehen Sie zum Ende des Testzeitraums. In dem Fall wird Ihnen keine anstehende Rechnung für das Abonnement angezeigt.
Ü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.

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. Wenn Sie Testversionen anbieten, müssen Sie die Anforderungen des Kartennetzwerks erfüllen. Erfahren Sie mehr über die Konformitätsanforderungen für Testphasen und Promoaktionen.

Ereignisse

Ereignisse werden jedes Mal ausgelöst, wenn ein kostenloser Testzeitraum geändert wird. Stellen Sie sicher, dass Ihre Integration die Ereignisse ordnungsgemäß verarbeitet. Beispielsweise dann, wenn Sie Ihren Kundinnen/Kunden vor Ablauf eines kostenlosen Testzeitraums eine E-Mail senden möchten. Hier erfahren Sie mehr über den Umgang mit Abonnementereignissen.

In der folgenden Tabelle werden die Ereignisse beschrieben, die ausgelöst werden, bevor ein kostenloser Testzeitraum abläuft, wenn ein Testabonnement unterbrochen oder gekündigt wird und ebenfalls wenn ein Abonnement wiederaufgenommen und aktiviert wird.

Ereignis	Beschreibung	Anwendungsszenario
`customer.subscription.deleted`	Wird gesendet, wenn ein Abonnement endet.	Verweigern Sie als Reaktion auf dieses Ereignis den Zugriff auf Ihr Produkt. Wenn ein kostenloser Testzeitraum ohne Angabe einer Zahlungsmethode endet und das Endverhalten `missing_payment_method` des Abonnements auf `cancel` festgelegt ist, so geht das Abonnement in den Status `canceled` ü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 `paused` 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.	Verweigern Sie als Reaktion auf dieses Ereignis den Zugriff auf Ihr Produkt. Wenn ein kostenloser Testzeitraum ohne Angabe einer Zahlungsmethode endet und das Endverhalten `missing_payment_method` des Abonnements auf `pause` festgelegt ist, so geht das Abonnement in den Status `paused` über und versendet dieses Ereignis. Das Abonnement verbleibt im Status `paused`, bis es ausdrücklich wiederaufgenommen wird.
`customer.subscription.trial_will_end`	Drei Tage vor Ablauf des Testzeitraums. Wenn der Testzeitraum weniger als 3 Tage beträgt, wird dieses Ereignis ausgelöst.	Konfigurieren Sie das Abonnement so, dass Ihre Kund/innen 3 Tage vor Ablauf des Testzeitraums automatisch per E-Mail an dessen Ende erinnert werden.

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, damit Ihre Kundinnen/Kunden ihre Abonnements verwalten können.

Erfassen Sie als Nächstes die Rechnungsinformationen von Ihren Kund/innen:

Überwachen Sie das Ereignis customer.subscription.trial_will_end.
Wenn das Abonnement keine Standard-Zahlungsmethode hat, rufen Sie die E-Mail des/der Kund/in über die Customers API ab und senden Sie ihnen eine Nachricht mit einem Link zu Ihrer Seite. Es ist hilfreich, die Kunden-ID in die E-Mail einzubetten. Zum Beispiel: https://example.com?...&customer={{CUSTOMER_ID}}.
Wenn der Kunde/die Kundin Ihre Website betritt, erstellen Sie eine Kundenportal-Sitzung mit der Kunden-ID aus dem vorherigen Schritt.
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.

Vor Ablauf der Testphase eine Erinnerung per E-Mail senden

Um vor Ablauf des Testzeitraums eine Erinnerungs-E-Mail zu senden, wählen Sie in der Einstellung „Abonnements und E-Mails“ die Option Link zu einer von Stripe gehosteten Seite aus. Die Erinnerungs-E-Mail enthält einen Link, über den Kundinnen und Kunden ihre Zahlungsdetails hinzufügen oder aktualisieren können. Wir versenden keine Erinnerungs-E-Mails an kostenlose Testversionen in einer Sandbox. Erfahren Sie mehr darüber, wie Sie Erinnerungen zu kostenlosen Testzeiträumen einrichten können.

Verwenden Sie das Ereignis customer.subscription.trial_will_end, um Ihre eigenen gehosteten E-Mails an Kund/innen zu senden. Nachdem Sie das Ereignis im Dashboard sehen, wird bestätigt, dass Ihre E-Mail gesendet wurde.

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.

Um ein unterbrochenes Abonnement im Dashboard wiederaufzunehmen, navigieren Sie zu dem Abonnement und wählen Sie dann im Menü Aktionen die Option Abonnement wiederaufnehmen aus. Wählen Sie im Modal Abonnement wiederaufnehmen Abrechnungszyklus zurücksetzen oder Immer abrechnen (wenn Sie den Abrechnungszyklus nicht zurücksetzen) aus, um Kund/innen sofort zu belasten.

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 an.