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 doesn’t support anchoring on a backdated start date.

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

Das Datum Ihres Abrechnungszyklus ändert sich in diesen Szenarien. Wenn Sie jedoch ein Abonnement mit billing_mode[type]=flexible erstellen oder aktualisieren, bleibt der Abrechnungszyklusanker unverändert. Erfahren Sie mehr über das Konfigurieren des flexiblen Abrechnungsmodus und die damit verbundenen Einschränkungen.

• Wenn alle Preise Nullbeträge sind, wird durch das Hinzufügen eines oder mehrerer bezahlter Preise der Rechnungsstellungszeitraum sofort zurückgesetzt. Weitere Informationen finden Sie in der Anleitung Preise für Abonnements ändern.
• 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 auf die aktuelle Zeit zurückzusetzen, stellen Sie eine Aktualisierungsanfrage mit billing_cycle_anchor auf now. Dadurch wird der Abrechnungszyklusanker auf den Zeitpunkt der Aktualisierungsanforderung gesetzt. Nachdem Sie den Abrechnungszyklusanker zurückgesetzt haben, sendet Stripe sofort eine Rechnung. Aktivieren Sie anteilmäßige Verrechnung, um der Kundin oder dem Kunden die Tage gutzuschreiben, die bereits in dem vorherigen Zeitraum bezahlt wurden. Wenn Sie die anteilmäßige Verrechnung deaktivieren, kann dies zu überhöhten Preisen für Ihre Kundinnen und Kunden führen.

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

Testzeitraum verwenden, um den Abrechnungszyklus zu ändern

Sie können den Abrechnungszyklusanker ändern, indem Sie eine kostenlose Testversion verwenden, um das Ankerdatum des Abrechnungszyklus automatisch auf das Datum trial_end zu setzen.

Wenn eine Kundin oder ein Kunde beispielsweise ein aktives Abonnement abgeschlossen hat, das ursprünglich am 23. Juli in Rechnung gestellt werden sollte, und Sie am 15. Juli einen Testzeitraum einführen, der am 1. August endet:

• Die Kundin oder der Kunde erhält am 15. Juli eine Rechnung über 0 USD. Sie haben bereits im vorherigen Zyklus bis zum 23. Juli gezahlt, daher gilt der „kostenlose“ Zeitraum nur vom 24. Juli bis zum 31. Juli.
• Der Kundin/dem Kunden wird am 23. Juli keine Rechnung gestellt.
• Der neue Zyklus, der am 1. August in Rechnung gestellt wird, ist ein voller Zyklus zum Normaltarif, danach wieder am 1. eines jeden Monats.

Optional können Sie die anteilmäßige Verrechnung verhindern, wenn Sie ein Abonnement aktualisieren, um einen Testzeitraum zu starten, indem Sie proration_behavior=none verwenden. In den meisten Fällen, wenn Sie den Testzeitraum nutzen, um den Abrechnungszyklus zu ändern, ohne eine anteilmäßig verrechnete Rechnung auszustellen, deaktivieren Sie die anteilmäßige Verrechnung, da die Länge des Testzeitraums den bereits bezahlten Anteil des vorherigen Abrechnungszyklus berücksichtigt.

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

Nutzungsbasierte Abrechnung

Bei der nutzungsbasierten Abrechnung variiert der von Kundinnen/Kunden gezahlte Betrag je nach Verbrauch während des Abrechnungszyklus. Wenn eine Änderung des Abrechnungszyklus dazu führt, dass ein Abonnementintervall vorzeitig beendet wird, berechnen Sie dem Kunden/der Kundin die während des verkürzten Abrechnungszyklus angefallene Nutzung.

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.