Datum für den Abrechnungszyklus eines Abonnements festlegen

Der Abrechnungszyklus eines Abonnements hängt von zwei Faktoren ab:

• Das wiederkehrende Intervall des Preises oder der Preise, zum Beispiel monatlich, jährlich, wöchentlich usw.
• Der Abrechnungszyklusanker ist der Bezugspunkt, an ein zukünftiges Abrechnungszyklusdatum ausgerichtet wird. Er legt den Wochentag für week-Intervalle, den Tag des Monats für month- und year-Intervalle und den Monat des Jahres für year-Intervalle fest. Der Standardwert is entweder das Erstellungsdatum des Abonnements oder das Enddatum des Testzeitraums (wenn Sie einen Testzeitraum nutzen). Sie können diesen Wert auch explizit bei der Erstellung des Abonnements festlegen.

Im Folgenden finden Sie Beispiele für monatliche Abonnements mit unterschiedlichen Abrechnungszyklen:

• Ein monatliches Abonnement mit einem Abrechnungszyklusanker am 2. September wird immer am 2. Tag des Monats abgerechnet.
• Bei einem monatlichen Abonnement mit dem 31. Januar als Datum des Abrechnungszyklusankers wird der letzte Tag des Monats in Rechnung gestellt, der am nächsten beim Ankerdatum liegt, also der 28. Februar (bzw. 29. Februar in einem Schaltjahr) und dann der 31. März, der 30. April usw.
• Ein wöchentliches Abonnement mit einem Abrechnungszyklusankerdatum am Freitag, dem 3. Juni wird anschließend jeden Freitag abgerechnet.

Vollständige Abrechnungszeiträume beginnen am ersten vollständigen Rechnungsdatum, das oft mit dem Abrechnungszyklusanker übereinstimmt und immer intervallmäßig darauf ausgerichtet ist.

Abrechnungszyklusanker für neue Abonnements bestimmen

Es gibt zwei Möglichkeiten, den Abrechnungszyklusanker für neue Abonnements festzulegen:

• Verwenden Sie billing_cycle_anchor_config, um den Zeitstempel für Sie zu berechnen (nur Monats- oder Jahresabonnements).
• Verwenden Sie billing_cycle_anchor, um den Zeitstempel direkt zu akzeptieren.

Wenn Sie ein Monats- oder Jahresabonnement erstellen, empfehlen wir die Verwendung des Parameters billing_cycle_anchor_config, da dieser automatisch kurze Monate und Schaltjahre für Sie berücksichtigt. Wenn Sie ein Tages- oder Wochenabonnement erstellen oder wenn Sie das Zyklusdatum Ihres Abonnements mit einem Zeitstempel festlegen möchten, verwenden Sie direkt den Parameter billing_cycle_anchor.

billing_cycle_anchor_config verwenden

Um eine Integration mit monatlichen und jährlichen Abonnements zu erstellen, verwenden Sie billing_cycle_anchor_config beim Erstellen eines Abonnements, um den Tag des Monats anzugeben, an dem Sie den Anker setzen möchten.

Legen Sie day_of_month auf 31 fest, um ein monatliches Abonnement zu erstellen, das am Ende des Monats zyklisch abläuft, auch in Monaten mit weniger als 31 Tagen. Wenn ein Monat weniger als 31 Tage hat, läuft das Abonnement am letzten Tag dieses Monats ab.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "billing_cycle_anchor_config[day_of_month]"=31

Sie können auch month angeben, um den Monat des Jahres für den Anker bei mehrmonatigen und jährlichen Abonnements zu steuern.

Um Ihre Jahresabonnements am ersten Juli zu verlängern, erstellen Sie ein Jahresabonnement mit einem month = 7 und day_of_month = 1.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "billing_cycle_anchor_config[month]"=7 \
  -d "billing_cycle_anchor_config[day_of_month]"=1

Mit billing_cycle_anchor_config können Sie den genauen Monat, den Tag, die Stunde, die Minute und die Sekunde für den Abrechnungszyklusanker angeben. Wenn Sie Stunde, Minute und Sekunde nicht angeben, werden standardmäßig die Werte für die Erstellungszeit des Abonnements verwendet.

Für den Abrechnungszyklusanker wird die Koordinierte Weltzeit (UTC) verwendet. Wenn Sie beispielsweise ein Abonnement mit billing_cycle_anchor_config um 17 Uhr EST erstellen, ohne die Stunde anzugeben, wird die Zeit im System als 22 Uhr UTC aufgezeichnet.

billing_cycle_anchor_config unterstützt keine Verankerung an einem rückdatierten Startdatum.

Wenn Sie beispielsweise ein bestehendes Monatsabonnement mit einem billing_cycle_anchor-Zeitstempel haben, der den Tag des Monats, die Stunde, die Minute und die Sekunde von 15, 12, 30 und 0 enthält, können Sie ein neues Monatsabonnement darauf ausrichten. Legen Sie dafür day_of_month hour minute second so fest, dass sie jeweils den gleichen Werten entsprechen.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "billing_cycle_anchor_config[day_of_month]"=15 \
  -d "billing_cycle_anchor_config[hour]"=12 \
  -d "billing_cycle_anchor_config[minute]"=30 \
  -d "billing_cycle_anchor_config[second]"=0

Wenn Sie billing_cycle_anchor_config verwenden, kann dies zu einem billing_cycle_anchor führen, der mehr als einen Abrechnungszeitraum in der Zukunft umfasst. Das Datum für die erste vollständige Rechnung liegt jedoch immer innerhalb eines Abrechnungszeitraums ab Erstellung des Abonnements oder Ende eines kostenlosen Testzeitraums.

Angenommen, Sie erstellen im Februar ein Abonnement mit zweimonatigem Intervall und schließen es am Ende jedes Monats ab, indem Sie day_of_month auf 31 setzen. Der nächste Monat mit 31 Tagen im Zweimonatsintervall ab Februar ist der August, was zu einem Rechnungszyklusanker am 31. August führt. Das Datum der ersten vollständigen Rechnung für dieses Abonnement liegt jedoch immer noch im Februar. Es gibt einen anfänglichen , anteiligen Zeitraum von der Erstellung des Abonnements bis zum 28. Februar (oder 29. in einem Schaltjahr), gefolgt von einem zweimonatigen Abrechnungszeitraum.

billing_cycle_anchor verwenden

Ein Abonnement können Sie mit einem expliziten Abrechnungszyklusanker über die Subscriptions API oder Checkout erstellen.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d billing_cycle_anchor=1611008505

Abrechnungszyklus für bereits bestehende Abonnements ändern

Verwenden Sie die Subscriptions API oder das Dashboard, um das Abrechnungsdatum eines bestehenden Abonnements über eine der folgenden Optionen zu ändern:

• Setzen Sie den Abrechnungszyklusanker auf den aktuellen Zeitpunkt zurück.
• Fügen Sie einen kostenlosen Testzeitraum hinzu. Dadurch wird das Ankerdatum automatisch auf das Ende des Testzeitraums festgelegt. Testzeiträume starten in der Regel, wenn ein Abonnement erstellt wird, sie können aber auch auf bestehende Abonnements angewendet werden. In dem Fall können Sie Kundinnen/Kunden verbleibende Tage aus dem vorherigen Zyklus, die bereits bezahlt wurden, gutschreiben.

Your billing cycle date changes in these scenarios. However, if you create or update a subscription with billing_mode[type]=flexible, the billing cycle anchor remains unchanged. Learn more about configuring flexible billing mode and its limitations.

• Wenn alle Preise Nullbeträge sind, wird durch das Hinzufügen eines oder mehrerer bezahlter Preise der Abrechnungszeitraum sofort zurückgesetzt. Weitere Informationen finden Sie im Leitfaden zum Ändern von Abonnementpreisen.
• Der billing_cycle_anchor wird auf das cancel_at-Datum zurückgesetzt, wenn ein Abonnement erstellt wird, bei dem cancel_at auf ein Datum vor dem nächsten Abonnementzyklus festgelegt ist, oder wenn ein vorhandenes cancel_at-Datum für ein Abonnement mit einem billing_cycle_anchor in der Zukunft des neuen cancel_at-Datums geändert wird.
• Der billing_cycle_anchor wird auf den aktuellen Zeitpunkt zurückgesetzt, wenn zu einem Preis mit einem anderen recurring.interval gewechselt wird.

Abrechnungszyklus auf aktuellen Zeitpunkt zurücksetzen

Um den Abrechnungszyklusanker zurückzusetzen, stellen Sie eine Aktualisierungsanfrage, bei der billing_cycle_anchor auf now festgelegt ist. Dadurch wird der Abrechnungszyklusanker auf den Zeitpunkt der Aktualisierungsanfrage festgelegt. Wenn Sie den Abrechnungszyklusanker zurücksetzen, sendet Stripe sofort eine Rechnung. Aktivieren Sie die anteilmäßige Verrechnung, um der Kundin/dem Kunden bereits bezahlte Tage aus dem vorherigen Zeitraum gutzuschreiben. Wenn Sie die anteilmäßige Verrechnung deaktivieren, kann dies dazu führen, dass Sie Ihren Kundinnen/Kunden zu viel berechnen.

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d billing_cycle_anchor=now \
  -d proration_behavior=create_prorations

Testzeitraum hinzufügen, um den Abrechnungszyklus zu ändern

Durch das Hinzufügen eines nicht anteilig verrechneten Testzeitraums für ein bestehendes Abonnement können Sie den Abrechnungszyklus auf ein beliebiges Datum festlegen.

Wenn Sie den Testzeitraum nutzen, um den Abrechnungszyklus zu ändern, ohne eine anteilmäßige Rechnung auszustellen, deaktivieren Sie in der Regel die anteilmäßige Abrechnung. Die Dauer des Testzeitraums berücksichtigt den bereits bezahlten Anteil aus dem vorherigen Abrechnungszyklus.

Beispiel: Eine Kundin/ein Kunde verfügt über ein aktives Abonnement, für das die nächste Rechnung am 23. Juli gestellt wird. Sie bieten einen Testzeitraum bis zum 1. August an:

• Die Kundin/der Kunde erhält am 15. Juli eine Rechnung über 0 USD.
• Der Kundin/dem Kunden wird am 23. Juli keine Rechnung gestellt.
• Der Kundin/dem Kunden wird die nächste Rechnung am 1. August gestellt, dann am 1. September und so weiter.
• Die Kundin/der Kunde hat im vorherigen Zyklus bereits bis zum 23. Juli bezahlt, sodass der „kostenlose“ Zeitraum nicht wirklich kostenlos ist.
• Für den Zeitraum zwischen dem 23. Juli und dem 31. Juli wird nichts berechnet.
• Der neue Zyklus, der am 1. August in Rechnung gestellt wird, ist ein vollständiger Zyklus zum regulären Preis.

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d trial_end=1611008505 \
  -d proration_behavior=none

Nutzungsbasierte Abrechnung

With usage-based billing, the price paid by the customer varies based on consumption during the billing cycle. When changing the billing cycle results in ending a subscription interval early, you charge the customer for the usage accrued during the shortened billing cycle.

Abrechnungsschwellen

Zusätzlich zum regulären Zyklus können Sie Abonnements für die Abrechnung konfigurieren, wenn der fällige Betrag einen bestimmten Schwellenwert erreicht.

Wenn Sie ein Abonnement für diese Rechnung konfiguriert haben, können Sie dieses so einrichten, dass der Abonnementzyklus zurückgesetzt wird, wenn der Schwellenwert erreicht wird.