Nutzungsbasiertes Preismodell modellieren

Sie können Testzeiträume für Abonnements mit nutzungsbasierter Abrechnung verwenden. Während des Testzeitraums wird jegliche Nutzung nicht auf den Gesamtbetrag angerechnet, der den Kundinnen und Kunden am Ende des Abrechnungszyklus in Rechnung gestellt wird. Nach Ablauf des Testzeitraums wird die Nutzung summiert und am Ende des nächsten Abrechnungszyklus abgerechnet.

Erfahren Sie mehr über Testphasen und Abonnements.

Webhooks und Tests

Achten Sie darauf, dass Ihre Integration Web-Ereignisse im Zusammenhang mit Statusänderungen des Testzeitraums ordnungsgemäß überwacht und verarbeitet.

Einige Tage vor Ablauf eines Testzeitraums, wenn das Abonnement von trialing auf active wechselt, erhalten Sie das Ereignis customer.subscription.trial_will_end. Wenn dies eintritt, überprüfen Sie, ob Sie eine Zahlungsmethode für die Kundin/den Kundin haben, damit Sie ihr/sein Konto belasten können. Informieren Sie die Kundin/den Kunden optional im Voraus über die Belastung.

Erfahren Sie mehr über Abonnements und Webhooks.

Bei der nutzungsbasierten Abrechnung variiert der von der Kundin/dem Kunden gezahlte Abrechnungsbetrag je nach Verbrauch während des Abrechnungszyklus. Wenn eine Änderung des Abrechnungszyklus dazu führt, dass ein Abonnementintervall vorzeitig beendet wird, berechnen Sie der Kundin/dem Kunden die während des verkürzten Abrechnungszyklus angefallene Nutzung. Bei der nutzungsbasierten Abrechnung unterstützen wir die anteilmäßig Verrechnung nicht.

Nachdem ein Abonnement gekündigt wurde, kann es nicht reaktiviert werden. Sie können stattdessen die aktualisierten Rechnungsinformationen von Ihrer Kundinnen/Kunden erfassen, deren Standard-Zahlungsmethode aktualisieren und ein neues Abonnement für den bestehenden Kundendatensatz erstellen.

Nachdem Sie die Kündigung eines Abonnements mit cancel_at_period_end geplant haben, können Sie es bis zum Ende des Zeitraums jederzeit reaktivieren, indem Sie cancel_at_period_end auf false setzen. Die Schlussrechnung enthält die gemessene Nutzung, wenn das Abonnement zum Ende des Abrechnungszeitraums gekündigt wird.

Verwenden Sie die Option transform_quantity, um die Nutzung anzupassen, bevor Sie den Preis anwenden. Auf diese Weise können Sie die gemeldete Nutzung durch eine bestimmte Zahl teilen und das Ergebnis auf- oder abrunden. Dies wird häufig bei der Preisgestaltung für Pakete eines Produkts anstelle von einzelnen Einheiten verwendet. Die Mengenanpassung ist nicht mit der gestaffelten Preisgestaltung kompatibel.

Angenommen, Sie haben eine Autovermietung. Sie geben die Nutzung als Anzahl der Minuten an und möchten die Kunden/Kundinnen für jede gemietete Stunde belasten.

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

Erstellen Sie als Nächstes einen Preis für das Produkt „Autovermietung“, indem Sie 150 USD pro Stunde berechnen und dabei angefangene Stunden auf die volle Stunde aufrunden (auch wenn nur ein Teil der Stunde benötigt wurde):

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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

Wenn ein Auto für 150 Minuten gemietet wird, werden dem Kunden/der Kundin 30 USD für 3 Stunden Mietzeit in Rechnung gestellt (2 Stunden und 30 Minuten, aufgerundet auf 3 Stunden).

Dezimalbeträge sind praktisch für Preise, die nicht ganzzahlig sind. Beispiel: Als Anbieter von SaaS-Cloudspeicher berechnen Sie einen Preis von 0,05 Cent pro MB und Monat. Die Summe, die sich nach dem Multiplizieren der genutzten MB mit 0,05 Cent ergibt, wird auf den nächsten ganzen Cent gerundet.

Um Preise mit Dezimalbeträgen zu erstellen, nutzen Sie unit_amount_decimal anstelle von unit_amount. Mit unit_amount_decimal können Sie einen Betrag in der kleineren Einheit der Abrechnungswährung angeben. Geben Sie z. B. unit_amount_decimal = 105.5 (USD) an, um die Dezimalbeträge 105,5 Cent oder 1,055 USD darzustellen. In unit_amount_decimal sind Dezimalzahlen mit bis zu 12 Nachkommastellen zulässig.

Wenn Sie Staffelpreise verwenden möchten, können Sie unit_amount_decimal anstelle von unit_amount angeben. Darüber hinaus können Sie mit unit_amount_decimal anstelle von unit_amount auch Rechnungsposten erstellen.

In API-Antworten wird das ganzzahlige Feld unit_amount nicht ausgefüllt, wenn Sie das Objekt mit einem Dezimalwert erstellen. Wenn Sie z. B. einen Preis mit unit_amount_decimal = 0.05 erstellen, enthält die Antwort unit_amount = null und unit_amount_decimal = 0.05. Sie können auch ganzzahlige Werte in unit_amount_decimal übergeben, dann wird unit_amount in der Antwort ausgefüllt. Wenn Sie zum Beispiel einen Preis mit unit_amount_decimal = 5 erstellen, enthält die Antwort unit_amount = 5 und unit_amount_decimal = 5.0.

Standardmäßig finalisiert Stripe Abonnementrechnungen eine Stunde nach ihrer Erstellung. Während dieser einstündigen Nachfrist können Sie die Nutzung für den vorherigen Zeitraum weiterhin melden. Wenn die Rechnung abgeschlossen ist, aktualisieren wir sie, um die neueste Menge für den Abrechnungszeitraum widerzuspiegeln.

Nach Finalisierung der Rechnung gemeldete Verwendungszwecke werden nicht in zukünftigen Rechnungen erfasst.

Sie können eine längere Nachfrist festlegen.

Sie können den Preis eines Abonnementpostens während eines Abrechnungszeitraums aktualisieren. Beim Wechsel von einem Abrechnungszählerpreis zu einem anderen gelten jedoch die folgenden Einschränkungen:

• Wir berücksichtigen nur die Nutzung, die nach der Aktualisierung auf zukünftigen Rechnungen auftritt. Nutzung vor der Änderung wird nicht in Rechnung gestellt. Wenn Sie zum Beispiel ein monatliches Abonnement haben, das Sie am 16. Januar von Preis A auf Preis B umstellen, dann wird am Ende des Monats in der Rechnung die Nutzung vom 16. bis 31. Januar zum Preis B berücksichtigt. Die Nutzung vom 1. Januar bis 16. Januar wird nicht in Rechnung gestellt.
• Es gibt eine Ausnahme von dieser Regel, wenn Sie Abrechnungsschwellenwerte verwenden und eine Schwellenwertrechnung bereits zum alten Preis erstellt wurde. Wenn Sie beispielsweise im obigen Szenario am 10. Januar eine Schwellenwertrechnung mit Preis A erstellt haben, wird diese Schwellenwertrechnung dem Kunden/der Kundin weiterhin in Rechnung gestellt. Die am Monatsende erstellte Rechnung berücksichtigt die Nutzung vom 16. Januar bis zum 31. Januar zu Preis B. Die frühere Schwellenwertrechnung wird nicht mit dem Verbrauch für diese Rechnung am Monatsende verrechnet.
• Ähnliche Einschränkungen gelten, wenn Sie einen neuen Abonnementposten mit einem Abrechnungszählerpreis in der Mitte des Abonnementzyklus hinzufügen. Wenn Sie beispielsweise am 16. Januar einen neuen Abonnementposten mit dem Preis C hinzufügen, wird die Rechnung am Ende des Monats für die Nutzung vom 16. bis 31. Januar zum Preis C für diesen Abonnementposten erstellt.

So können Sie den Preis für einen Abonnementposten aktualisieren:

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

Abonnementartikel löschen:

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

Nach dem Löschen geben wir keine Nutzung dieses Artikels auf der Rechnung an.

Sie können die Nutzung für einen Kunden/eine Kundin melden, noch bevor Sie ein Abonnement für ihn/sie erstellen. Nachdem Sie die Nutzung für einen Kunden/eine Kundin gemeldet haben, können Sie mit backdate_start_date vor dem ersten Bericht ein Abonnement erstellen, um sicherzustellen, dass die Nutzung in der nächsten Abonnementrechnung enthalten ist.

curl -X POST https://api.stripe.com/v2/billing/meter_events \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2024-11-20.acacia" \
  --json '{
    "event_name": "alpaca_ai_tokens",
    "payload": {
        "value": "25",
        "stripe_customer_id": "{{CUSTOMER_ID}}"
    },
    "timestamp": "2024-04-01T12:00:00.000Z"
  }'

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