Nutzungsbasierte Abrechnung konfigurieren

Nachdem Sie Ihr nutzungsbasiertes Abrechnungsmodell erstellt haben, können Sie verschiedene Teile Ihrer Abrechnungskonfiguration ändern. Sie können beispielsweise den Preis eines Abonnementpostens während eines Abrechnungszyklus aktualisieren, ein Abonnement rückdatieren, um die Nutzung in die nächste Rechnung aufzunehmen, oder nutzungsbasierte Abonnements kündigen.

Transform quantities

You can use the transform_quantity option to transform usage before applying the price, which you can use when you want pricing on packages of a product instead of individual units. This allows you to divide the reported usage by a specific number and round the result up or down.

For example, say you have a car rental service and you want to charge customers for each hour they rent a car. In this case, you report usage as a number of minutes.

curl https://api.stripe.com/v1/products \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d name="Car Rental Service"

Create a price for the car rental service product. Charge 10 USD per hour, and round up to charge for a full hour, even if the customer uses only part of the hour.

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d nickname="Car Rental Per Hour Rate" \
  -d unit_amount=1000 \
  -d currency=usd \
  -d "recurring[interval]"=month \
  -d "recurring[usage_type]"=metered \
  -d product={{CAR_RENTAL_SERVICE_PRODUCT_ID}} \
  -d "transform_quantity[divide_by]"=60 \
  -d "transform_quantity[round]"=up

If a customer rents the car for 150 minutes, that customer is charged 30 USD for 3 hours of rental (2 hours and 30 minutes, rounded up).

Preise in der Mitte des Zyklus aktualisieren

Sie können den Preis eines Abonnementpostens während eines Abrechnungszyklus aktualisieren.

Mit Abonnements des Typs billing_mode=flexible erstellen wir einen Rechnungsposten, über den die zuvor gemeldete gemessene Nutzung abgerechnet wird, wenn Sie einen nutzungsbasierten Preis aus einem Abonnement entfernen.

Angenommen, Sie haben ein monatliches Abonnement, das Sie am 16. Januar von Preis A auf Preis B umstellen. Am 16. Januar erstellen wir einen Rechnungsposten für die Abrechnung für die Nutzung vom 1. Januar bis zum 16. Januar. Wenn der Abonnementzyklus am 1. Februar abläuft, berechnen wir Preis B vom 16. Januar bis zum 1. Februar.

Das proration_behavior, das Sie beim Entfernen eines nutzungsbasierten Preises angeben, wirkt sich auf diese nutzungsbasierten Rechnungsposten aus. Wenn Sie einen nutzungsbasierten Preis entfernen möchten, ohne diesen in Rechnung zu stellen, legen Sie proration_behavior auf none fest.

Bei billing_mode=classic-Abonnements gelten Einschränkungen beim Wechsel von einem Zählerpreis zu einem anderen.

Bei zukünftigen Rechnungen berücksichtigen wir nur die Nutzung, die nach der Aktualisierung erfolgt. Angenommen, Sie haben ein monatliches Abonnement, das Sie am 16. Januar von Preis A auf Preis B umstellen. Am Ende des Monats enthält die Rechnung die Nutzung vom 16. Januar bis 31. Januar zum Preis B. Die Nutzung vom 1. Januar bis zum 16. Januar wird nicht abgerechnet.

Eine Ausnahme besteht, wenn Sie Abrechnungslimits verwenden und bereits eine Rechnung mit Mindestbetrag zum alten Preis erstellt wurde. Angenommen, Sie generieren am 10. Januar eine Schwellenwertrechnung mit Preis A. Sie stellen dem Kunden/der Kundin weiterhin diese Schwellenwertrechnung in Rechnung. Am Ende des Monats enthält die Rechnung die Nutzung vom 16. Januar bis 31. Januar zum Preis B. Die frühere Schwellenwertrechnung gleicht die Nutzung für diese Rechnung am Ende des Monats nicht aus.

Ähnliche Einschränkungen gelten, wenn Sie in der Mitte des Abonnementzyklus einen neuen Abonnementposten mit einem Abrechnungszählerpreis hinzufügen. Angenommen, Sie fügen am 16. Januar einen neuen Abonnementposten mit dem Preis C hinzu. Am Ende des Monats enthält die Rechnung die Nutzung vom 16. Januar bis zum 31. Januar zum Preis C für diesen Abonnementposten.

Wählen Sie eine der folgenden Optionen aus, um die zuvor gemeldete Nutzung bei Preisänderungen zu erfassen:

• Melden Sie die aggregierte Nutzung erneut, um sie im Zyklus für den neuen Preis zu erfassen.
• Setzen Sie den Parameter billing_cycle_anchor auf now zurück, wodurch der alte Preis auf die zuvor gemeldete Nutzung angewendet wird.

So aktualisieren Sie den Preis für einen Abonnement-Artikel:

curl https://api.stripe.com/v1/subscription_items/{{SUBSCRIPTION_ITEM_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d price={{NEW_PRICE_ID}}

Abonnementposten löschen:

curl -X DELETE https://api.stripe.com/v1/subscription_items/{{SUBSCRIPTION_ITEM_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Nach dem Löschen zeigt die Rechnung keine Nutzung dieses Postens.

Rückdatiere Abonnements erstellen

Sie können die Nutzung für einen Kunden/eine Kundin aufzeichnen, noch bevor Sie ein Abonnement für ihn/sie erstellen. Nachdem Sie die Nutzung für einen Kunden/eine Kundin aufgezeichnet haben, verwenden Sie das backdate_start_date, um vor dem ersten Bericht ein Abonnement zu erstellen.

Bei billing_mode=flexible-Abonnements enthält die erste Rechnung des Abonnements diese rückdatierte Nutzung.

Bei billing_mode=classic-Abonnements enthält die nächste Rechnung des Abonnements, die während des Zyklus erstellt wird, diese rückdatierte Nutzung.

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

Nutzungsbasierte Abonnements kündigen

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

Sie können gekündigte Abonnements nicht reaktivieren. Stattdessen können Sie aktualisierte Rechnungsinformationen von Ihrem Kunden/Ihrer Kundin erfassen, seine/ihre Standard-Zahlungsmethode aktualisieren und ein neues Abonnement für den bestehenden Kundendatensatz erstellen.

Wenn Sie cancel_at_period_end verwenden, um die Kündigung eines Abonnements zu planen, können Sie das Abonnement bis zum Ende des Zeitraums jederzeit reaktivieren. Ändern Sie dazu cancel_at_period_end in false.

Bei Abonnements, die zum Ende des Zeitraums gekündigt werden, enthält die Abschlussrechnung am Ende des Zyklus die gemessene Nutzung aus dem letzten Abrechnungszyklus.