Legen Sie das Erneuerungsdatum für die Abrechnungen des Abos fest

Der Rechnungsstellungszeitraum eines Abos 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 Referenzpunkt, an dem zukünftige Rechnungsstellungszeiträume ausgerichtet werden. Er legt den Wochentag für Intervalle in Wochen, den Tag des Monats für Intervalle in Monaten und Jahren sowie den Monat des Jahres für Intervalle in Jahren fest. Der Standardwert ist entweder das Erstellungsdatum des Abos oder das Ende der Testzeitraums (falls Sie einen solchen nutzen). Sie können diesen Wert auch ausdrücklich beim Erstellen des Abos festlegen.

Im Folgenden finden Sie Beispiele für monatliche Abos mit unterschiedlichen Rechnungsstellungszeiträumen:

• 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 monatliches oder jährliches Abo erstellen, empfehlen wir die Verwendung des Parameters billing_cycle_anchor_config, da dieser automatisch kurze Monate und Schaltjahre berücksichtigt. Wenn Sie ein tägliches oder wöchentliches Abo erstellen oder das Verlängerungsdatum Ihres Abos mithilfe eines Zeitstempels festlegen möchten, verwenden Sie den Parameter billing_cycle_anchor direkt.

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 Abo zu erstellen, das am Monatsende verlängert wird – auch in Monaten mit weniger als 31 Tagen. Hat ein Monat weniger als 31 Tage, verlängert sich das Abo am letzten Tag dieses Monats.

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

Ändern Sie den Rechnungsstellungszeitraum bei bestehenden Abos

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 Abo mit einem cancel_at-Datum erstellt wird, das vor der nächsten Verlängerung des Abos liegt oder wenn ein bestehendes cancel_at-Datum bei einem Abo geändert wird, dessen billing_cycle_anchor nach dem neuen cancel_at-Datum liegt.
• Der billing_cycle_anchor wird auf den aktuellen Zeitpunkt zurückgesetzt, wenn zu einem Preis mit einem anderen recurring.interval gewechselt wird.

Setzen Sie den Rechnungsstellungszeitraum auf die aktuelle Zeit zurück

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

Ändern Sie den Rechnungsstellungszeitraum mit einem Testzeitraum

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 anteilige Verrechnung verhindern, wenn Sie ein Abo aktualisieren, um einen kostenlosen Testzeitraum zu starten, indem Sieproration_behavior=none verwenden. Wenn Sie den Testzeitraum nutzen, um den Rechnungsstellungszeitraum zu ändern, ohne eine anteilige Rechnung auszustellen, deaktivieren Sie in den meisten Fällen die anteilige Verrechnung, da die Länge des Testzeitraums den bereits gezahlten Teil des vorherigen Rechnungsstellungszeitraums 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 der Kundin/vom Kunden gezahlte Preis je nach Konsum im Rechnungsstellungszeitraums. Wenn durch die Änderung des Rechnungsstellungszeitraums der Servicezeitraum eines Abos vorzeitig endet, berechnen Sie der Kundin/dem Kunden die Nutzung, die während des verkürzten Rechnungsstellungszeitraums angefallen ist.

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 Abo so konfiguriert haben, dass es auf diese Weise in Rechnung gestellt wird, können Sie es so einrichten, dass der Servicezeitraum des Abos beim Erreichen des Schwellenwerts zurückgesetzt wird.