Nutzung für Abrechnungszwecke aufzeichnenLegacy

Während jedes Abrechnungszeitraums müssen Sie die Nutzung an Stripe melden, damit den Kundinnen und Kunden die korrekten Beträge in Rechnung gestellt werden. Sie können Ihr eigenes System zum Erfassen des Nutzungsverhaltens verwalten und Stripe Nutzungsdaten für Abonnements bereitstellen.

Sie können Informationen zur Nutzung an Stripe weitergeben, indem Sie Nutzungsdaten mit einem Abonnementartikel, der genutzten Menge und einem Zeitstempel erstellen. Wie häufig Sie die Nutzung melden, bleibt Ihnen überlassen. Sie können den Code beispielsweise in einem Intervall (zum Beispiel alle 24 Stunden) für jedes nutzungsbasierte Abonnement ausführen. Am Ende des Abrechnungszeitraums berechnet Stripe automatisch den Gesamtpreis und erstellt Rechnungen für die gesamte Nutzung während des Abrechnungszeitraums.

curl https://api.stripe.com/v1/subscription_items/{{SUBSCRIPTION_ITEM_ID}}/usage_records \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -X POST \
  -d quantity=100 \
  -d timestamp=1733946561 \
  -d action=increment

Best Practices für die Aufzeichnung der Nutzung

• Sie müssen einen Teil Ihrer eigenen Geschäftslogik schreiben, bevor Sie die Nutzungsdaten erstellen. Rufen Sie einen Datensatz einer Kundin/eines Kunden aus Ihrer Datenbank ab und extrahieren Sie die Posten-ID und die Tagesnutzung des Stripe-Abonnements. Wenn Sie keine Abonnementposten-IDs speichern, rufen Sie das Abonnement ab und suchen Sie nach Abonnementposten.
• Mit Idempotenz-Schlüsseln stellen Sie sicher, dass die Nutzung aufgrund von Latenz oder anderen Problemen nicht mehr als einmal gemeldet wird.
• Der timestamp muss innerhalb des aktuellen Abrechnungszeitraums liegen, andernfalls schlägt der Aufruf fehl.
• Der Standardwert für den Parameter action ist increment. Bei diesem Wert wird vorausgesetzt, dass der Preis mit aggregate_usage=sum konfiguriert ist und dass Sie die Nutzung in Echtzeit erfassen und mit dem aktuellen timestamp an Stripe übergeben.
• Der Wert set für den Parameter action ist für den Fall geeignet, dass Sie die Nutzung selbst zusammenfassen und den Preis mit aggregate_usage=last_during_period oder aggregate_usage=last_ever konfigurieren.
• The usage reporting endpoint is rate-limited, and the Stripe API has a rate limit of 100 calls per second per account. We can increase this to 200 calls per second per account, on request. If you have a service that you expect to exceed this limit, consider “bundling” your product into amounts. For example, if you charge per 1000 requests, consider basing your product on “per 1000 transactions” and send 1 usage record per 1000.

Uhrenfehler

Das Melden der Nutzung außerhalb des aktuellen Abrechnungszeitraums führt zu einem Fehler. Um Uhrenfehler zwischen Ihrem Server und den Stripe-Systemen auszugleichen, gewähren wir einen kurzen Kulanzzeitraum im Standard-Gruppierungsmodus (aggregate_usage = sum). Bei allen anderen Gruppierungsmodi muss der timestamp innerhalb des aktuellen Zeitraums liegen.

In den ersten Minuten jedes Abrechnungszeitraums können Sie die Nutzung melden, die in den letzten Minuten des vorherigen Zeitraums stattgefunden hat. Wenn die Rechnung für den vorherigen Zeitraum nicht finalisiert wurde, fügen wir die Nutzung zu dieser Rechnung hinzu. Andernfalls rechnen wir die Nutzung für den aktuellen Zeitraum ab. Nach dem Kulanzzeitraum können Sie die Nutzung aus dem vorherigen Abrechnungszeitraum nicht mehr melden.

Verlassen Sie sich nicht auf den Kulanzzeitraum, um Nutzung außerhalb eines Abrechnungszeitraums zu melden. Dieser ist nur gedacht, um eine mögliche Abweichung der Uhr zu berücksichtigen, und wir können ihn nicht garantieren.

Aktuelle Nutzung abrufen

Um die Gesamtnutzung für den aktuellen Zeitraum zu prüfen, können Sie die anstehende Rechnung für das Abonnement abrufen. Die Nutzung ist als quantity des Rechnungspostens für das subscription_item angegeben. Der Gesamtnutzungswert entspricht möglicherweise nicht der aktuellen Menge, da es zu geringfügigen Verzögerungen bei der Verarbeitung kommen kann.

curl -G https://api.stripe.com/v1/invoices/upcoming \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d subscription={{SUBSCRIPTION_ID}}