Abonnementpläne
Verwenden Sie Abonnementpläne, um Änderungen an Abonnements im Verlauf der Zeit zu automatisieren. Sie können Abonnements direkt über einen Zeitplan erstellen oder einen Zeitplan zu einem bestehenden Abonnement hinzufügen. Verwenden Sie das Attribut phases, um die am Abonnement vorzunehmenden Änderungen zu definieren. Sobald ein Zeitplan alle Phasen beendet hat, wird er gemäß seinem end_behavior abgeschlossen.
Folgende Änderungen könnten für Sie interessant sein:
- Starten eines Abonnements an einem Datum in der Zukunft
- Rückdatieren eines Abonnements auf ein Datum in der Vergangenheit
- Herauf- oder Herabstufen eines Abonnements
Abonnementpläne sind sowohl im Stripe Billing-Dashboard als auch in der API verfügbar. Im folgenden kurzen Video erklären wir Ihnen die Funktionsweise von Abonnementplänen im Dashboard:
Abonnementpläne im Dashboard
In den folgenden Abschnitten der Dokumentation werden Abonnementpläne ausführlicher erläutert. Auf der Seite „Anwendungsszenarien“ finden Sie eine Reihe von Beispielen.
Phasen
Verwenden Sie beim Erstellen eines Abonnementplans das Attribut phases, um zu definieren, wann Änderungen auftreten und welche Eigenschaften des Abonnements geändert werden sollen. Zum Beispiel könnten Sie einen Gutschein über 50 % Rabatt für die ersten drei Monate eines Abonnements anbieten. In diesem Szenario würden Sie einen Abonnementplan mit einer dreimonatigen ersten Phase erstellen, in der der Gutschein über 50 % Rabatt angewendet wird. In der zweiten Phase würde das Abonnement wieder auf den regulären Preis angepasst und der Gutschein wieder entfernt werden. Phasen müssen sequentiell ausgeführt werden, wodurch zu einem bestimmten Zeitpunkt immer nur eine Phase aktiv sein kann.
Die Länge einer Phase festlegen
Das Intervall eines Preises bestimmt, wie häufig ein Abonnement abgerechnet werden soll. Zum Beispiel wird ein monatliches Intervall pro Monat abgerechnet. Phasen haben ein iterations-Attribut, mit dem Sie die Dauer einer Phase festlegen können. Um die Länge der Phase zu bestimmen, multiplizieren Sie diesen Wert mit dem Intervall. Wenn bei einem Abonnementplan ein Preis mit einem monatlichen Intervall verwendet wird und Sie iterations=2
festgelegt haben, erstreckt sich die Phase über zwei Monate.
Das end_date
einer Phase muss dem start_date
der nächsten Phase entsprechen. Durch die Verwendung von iterations
werden start_date
und end_date
automatisch ordnungsgemäß angegeben. Diese Werte können zwar auch manuell festgelegt werden, aber Stripe empfiehlt stattdessen die Verwendung von iterations
. Da das manuelle Festlegen des Start- und Enddatums anfällig für Fehler ist, sollten Sie es nur für erweiterte Anwendungsszenarien verwenden.
In die nächste Phase wechseln
Phasenwechsel erfolgen automatisch nach dem Erreichen des end_date
für eine Phase. Wenn eine Phase startet, aktualisiert Stripe das Abonnement entsprechend den Attributen der nächsten Phase. Sie können optional die anteilmäßige Verrechnung aktivieren, um den Nutzer/innen die nicht genutzten Artikel oder die nicht genutzte Zeit auf dem Abonnementplan gutzuschreiben.
Testzeiträume verwenden
Sie können Testzeiträume hinzufügen, indem Sie trial end für eine Phase festlegen. Wenn die gesamte Phase ein Test sein soll, legen Sie den Wert von trial_end
auf den gleichen Zeitpunkt wie das end_date
der Phase fest. Wenn nur ein Teil der Phase als Testzeitraum gelten soll, können Sie den Wert für trial_end
auch auf einen Zeitpunkt vor dem end_date
festlegen. Beim Terminieren von Aktualisierungen müssen Sie das neue trial_end
für jede Phase angeben.
Einen Zeitplan abschließen
Abonnementpläne enden nach dem Beenden der letzten Phase. Zu diesem Zeitpunkt bleibt das Abonnement bestehen und ist nicht mehr mit dem Zeitplan verknüpft. Wenn Sie ein Abonnement nach Ende der letzten Phase eines Zeitplans kündigen möchten, können Sie end_behavior auf cancel
festlegen.
Phasen-Attribute übernehmen
Wenn eine Phase aktiv wird, werden alle in der Phase festgelegten Attribute auch für das Abonnement festgelegt. Die Attribute bleiben nach dem Ende der Phase unverändert, es sei denn, sie werden durch die folgende Phase geändert oder der Zeitplan hat keine Standardeinstellung. Sie können einige Attribute sowohl für Zeitpläne als auch für Phasen festlegen. Dazu gehören unter anderem:
Wenn eines der Attribute im Zeitplan definiert ist, wird es zur Standardeinstellung für alle Phasen. Wenn die gleiche Eigenschaft sowohl im Zeitplan als auch in der Phase definiert ist, überschreibt das Phasen-Attribut das Zeitplan-Attribut. Dieses Verfahren wird weiter unten erläutert:
Zeitplan-Attribut vorhanden | Phasen-Attribut vorhanden | Ergebnis |
---|---|---|
Nein | Nein | Standardmäßig werden die Kunden- oder Kontoeinstellungen übernommen |
Ja | Nein | Zeitplan-Attribut festgelegt |
Ja | Ja | Phasen-Attribut festgelegt |
Nein | Ja | Phasen-Attribut festgelegt |
Metadaten für Phasen verwenden
Sie können Phasen in Abonnementplänen verwenden, um Metadaten für das zugrunde liegende Abonnement festzulegen. Auf diese Weise können Sie die Metadaten eines Abonnements mit geplanten Aktualisierungen steuern.
Erfahren Sie, wie Sie Abonnementmetadaten in Abonnementrechnungen kopieren.
Abonnementpläne erstellen
Die Seite „Anwendungsszenarien“ enthält ausführliche Beispiele. Im Folgenden finden Sie ein einfaches Beispiel für die Erstellung eines Abonnementplans mit einer Kundin/einem Kunden. Wenn Sie einen Zeitplan so erstellen, wird automatisch auch das Abonnement erstellt.
Notiz
Anders als bei der direkten Erstellung eines Abonnements verhält sich die erste Rechnung eines Abonnementplans, bei der collection_method
auf charge_automatically
festgelegt ist, wie eine wiederkehrende Rechnung und wird nicht sofort finalisiert, wenn das Abonnement des Zeitplans erstellt wird. Die Rechnung beginnt im Status draft
und wird von Stripe etwa 1 Stunde nach Erstellung finalisiert.
Dies bedeutet, dass zum Beispiel beim Erstellen eines zahlungspflichtigen Abonnementplans mit start_date=now
auch ein Abonnement und eine Rechnung im Status draft
erstellt werden. So erhalten Sie ein Zeitfenster von einer Stunde, um Änderungen an der Rechnung vorzunehmen. Später wird die Rechnung je nach Ergebnis des asynchronen Zahlungsversuchs zum Abschlusszeitpunkt automatisch in den Status open
oder paid
versetzt.
Dieser Zeitplan:
- Startet unmittelbar nach Erstellung.
- Legt das Abonnement auf eine Instanz des Produkts zu
price_1GqNdGAJVYItwOKqEHb
fest. - Durchläuft 12 Iterationen und gibt anschließend das Abonnement aus dem Zeitplan frei.
Sie können Abonnementpläne auch durch Übergeben einer Abonnement-ID erstellen:
Wenn Sie einen Zeitplan so erstellen, werden Attribute für das Abonnement verwendet, um Attribute für den Zeitplan festlegen zu können.
Wie auch bei anderen Stripe-APIs können Sie Abonnementpläne abrufen und aktualisieren. Außerdem können Sie sie kündigen und freigeben. Wenn Sie einen Abonnementplan kündigen, wird gleichzeitig auch das Abonnement gekündigt. Wenn Sie nur einen Zeitplan aus einem Abonnement entfernen möchten, verwenden Sie den Aufruf release.
Abonnementpläne ohne Code erstellen
Sie können, ohne Code im Stripe Billing Abonnement-Editor zu verwenden, mehrphasige Abonnementpläne erstellen. Gehen Sie dazu wie folgt vor:
- Öffnen Sie im Dashboard den Abonnement-Editor.
- Kunden/Kundin hinzufügen.
- Fügen Sie einen Preis zur Auswahl im Produktauswahl-Dropdown hinzu.
- Legen Sie eine Dauer für die erste Phase des Abonnementplans fest.
- Klicken Sie auf Phase hinzufügen.
- Wählen Sie die Dauer Ihrer nächsten Phase oder einfach unbegrenzt, um das Abonnement fortzusetzen.
- Nehmen Sie die erforderlichen Änderungen an Ihrer neuen Phase vor. Sie können die Menge und den Preis ändern, Gutscheine hinzufügen oder entfernen, das Datum des Abrechnungszeitraums zurücksetzen, das Verhalten bei anteilmäßigen Verrechnungen ändern oder Metadaten aktualisieren. Wenn Sie die Metadaten in einer Phase ändern, werden die Metadaten des Abonnements aktualisiert, wenn diese Phase aktiviert wird.
- Neue Phase speichern.
- Nach Bedarf weitere Phasen hinzufügen.
- Ein Abonnement erstellen.
Abonnementpläne aktualisieren
Sie können nur die aktuellen und zukünftigen Phasen von Abonnementplänen aktualisieren. Wenn Sie einen Abonnementzeitplan aktualisieren, müssen Sie alle aktuellen und zukünftigen Phasen übergeben. Außerdem müssen Sie alle zuvor festgelegten Parameter übergeben, die Sie beibehalten möchten. Alle zuvor festgelegten Parameter werden für die bestehende Phase nicht konfiguriert, es sei denn, Sie übergeben diese in der aktualisierten Anfrage. In der Antwort erhalten Sie jedoch weiterhin Informationen zu vergangenen Phasen.
Sie können bis zu zehn aktuelle oder zukünftige Phasen angeben. Durch die Aktualisierung der aktiven Phase wird auch das zugrunde liegende Abonnement aktualisiert. Beispielsweise werden bei dem folgenden Aufruf das Start- und das Enddatum beibehalten, die quantity
wird jedoch in zwei geändert:
Sie können die aktuelle Phase auch sofort beenden und eine neue Phase starten. Somit wird die aktive Phase zur vergangenen Phase und die neue Phase wird direkt auf das Abonnement angewendet. Im folgenden Beispiel wird die aktuelle Phase beendet und eine neue Phase gestartet:
Um einem Abonnementplan zusätzliche Phasen hinzuzufügen, übergeben Sie die aktuelle Phase und definieren Sie anschließend Ihre neuen Phasen:
Abonnementpläne ohne Code aktualisieren
Mit dem Abonnement-Editor von Stripe Billing können Sie bestehende Abonnements aktualisieren, um zukünftige Abonnement-Zeitplanphasen zu erhalten. Gehen Sie dazu wie folgt vor:
- Gehen Sie im Dashboard zur Seite Abonnements, wählen Sie ein bestehendes Abonnement aus und klicken Sie auf Aktionen > Abonnement aktualisieren.
- Legen Sie eine Dauer für die aktuelle Phase des Abonnementplans fest, indem Sie ein Enddatum auswählen.
- Klicken Sie auf +Phase hinzufügen.
- Wählen Sie die Dauer Ihrer nächsten Phase oder einfach unbegrenzt, um das Abonnement fortzusetzen.
- Nehmen Sie die erforderlichen Änderungen an Ihrer neuen Phase vor. Sie können die Menge und den Preis ändern, Gutscheine hinzufügen oder entfernen, das Datum des Abrechnungszeitraums zurücksetzen, das Verhalten bei anteilmäßigen Verrechnungen ändern oder Metadaten aktualisieren. Wenn Sie die Metadaten in einer Phase ändern, werden die Metadaten des Abonnements aktualisiert, wenn diese Phase aktiviert wird.
- Neue Phase speichern.
- Nach Bedarf weitere Phasen hinzufügen.
- Ein Abonnement erstellen.
Eine Rechnung anzeigen
Verwenden Sie den Planungs-Parameter in der API für anstehende Rechnungen, um eine Vorschau der nächsten Rechnung für ein Abonnement zu erhalten.
Vorschau der Erstellung und Aktualisierung von Zeitplänen anzeigen
Verwenden Sie die Parameter in schedule_details, um eine Vorschau auf die Erstellung oder Aktualisierung eines Abonnementzeitplans zu erhalten. Übergeben Sie einen vorhandenen Zeitplan, um Stripe mitzuteilen, ob es sich um eine Erstellung oder eine Aktualisierung handelt.
Übergeben Sie alle aktuellen und zukünftigen Phasen, die Sie in der Vorschau anzeigen.
Der folgende Code zeigt beispielsweise eine Vorschau der ersten Rechnung für einen Abonnementzeitplan mit der Phase 1
an, der über 12
Abrechnungszeiträume dauert.
Dashboard-Beschränkungen
Sie können Abonnementpläne ohne Code im Dashboard erstellen und aktualisieren.
Im Dashboard können Sie die folgenden Einstellungen global für alle Phasen festlegen, jedoch nicht pro Phase:
- Abrechnungsschwellen
- Zahlungsmethoden
- Rechnungseinstellungen
- Abonnementbeschreibung
- Testtage (nur in der ersten Phase möglich)
Die folgenden Parameter werden im Dashboard nicht unterstützt:
- Metadaten des Abonnementplan
- Metadaten des Phasenelements
- Währung
- Alle Connect-Parameter