Abrechnungszyklusdatum festlegen

Sie können den Abrechnungszyklusanker eines Abonnements explizit auf ein festes Datum setzen (zum Beispiel den 1. des nächsten Monats), wenn Sie eine Checkout-Sitzung erstellen. Der Abrechnungszyklusanker bestimmt das Datum der ersten vollständigen Rechnung, wenn Kundinnen/Kunden der volle Abonnementbetrag in Rechnung gestellt wird. Der Abrechnungszyklusanker und das wiederkehrende Intervall seines Preises bestimmen auch die zukünftigen Abrechnungstermine eines Abonnements. Beispielsweise wird ein am 15. Mai erstelltes monatliches Abonnement mit einem Anker am 1. Juni am 15. Mai in Rechnung gestellt, dann immer am 1. des Monats.

Für den anfänglichen Abrechnungszeitraum bis zum Datum der ersten vollständigen Rechnung können Sie mit dem Parameter proration_behavior den Umgang mit anteilsmäßigen Verrechnungen anpassen. Standardmäßig ist proration_behavior auf create_prorations festgelegt, und Kundinnen/Kunden erhalten eine anteilige Rechnung. Wenn proration_behavior none ist, erhalten Kundinnen/Kunden den anfänglichen Zeitraum bis zum Datum der ersten vollständigen Rechnung kostenlos.

Eine Checkout-Sitzung mit einem Abrechnungszyklusanker erstellen

Um einen Abrechnungszyklusanker zu konfigurieren, legen Sie den Parameter subscription_data.billing_cycle_anchor fest, wenn Sie eine Checkout-Sitzung im subscription-Modus erstellen. Der Anker muss einen zukünftigen UNIX-Zeitstempel vor dem nächsten natürlichen Abrechnungsdatum des Abonnements haben.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d "subscription_data[billing_cycle_anchor]"=1611008505

Wenn der Abrechnungszyklusanker in den aktiven Zeitraum einer Sitzung fällt und Kund/innen nach dessen Ablauf Zahlungsversuche unternehmen, zeigt Checkout den gesamten Zeitraum an und rechnet diesen ab, beginnend mit dem Abrechnungszyklusanker, und nicht mit dem anteiligen Zeitraum vor dem Abrechnungszyklusanker.

Anteilmäßige Verrechnung deaktivieren

Um die anteilsmäßige Verrechnung zu deaktivieren, setzen Sie beim Erstellen einer Checkout-Sitzung den Parameter subscription_data.proration_behavior auf none.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d "subscription_data[billing_cycle_anchor]"=1611008505 \
  -d "subscription_data[proration_behavior]"=none

Ähnlich wie bei einer kostenlosen Testversion ist der anfängliche Zeitraum bis zum Abrechnungszyklusanker kostenlos. Im Gegensatz zu einer Testversion wird keine Rechnung über 0 USD erstellt. Kund/innen erhalten am Datum des Abrechnungszyklusankers eine Rechnung mit dem vollen Abonnementbetrag.

Im Antwort-Objekt der Checkout-Sitzung sind Beträge, die an Einzelposten und Gesamtdetails angehängt sind, immer 0, wenn die anteilsmäßige Verrechnung deaktiviert ist. Außerdem wird der Zahlungsstatus der Sitzung auf no_payment_required gesetzt, um anzuzeigen, dass die Zahlung auf ein zukünftiges Datum verschoben wird.