Nutzung für Abrechnungszwecke aufzeichnenLegacy
Erfahren Sie, wie Sie die Nutzung für Ihre Kundinnen und Kunden aufzeichnen und melden.
Notiz
Wir haben die Funktionsweise der nutzungsbasierten Abrechnung aktualisiert. Weitere Informationen finden Sie in der Dokumentation zur aktualisierten nutzungsbasierten Abrechnung.
So läuft die Migration ab.
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.
Best Practices für die Aufzeichnung der Nutzung![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- 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
istincrement
. Bei diesem Wert wird vorausgesetzt, dass der Preis mitaggregate_
konfiguriert ist und dass Sie die Nutzung in Echtzeit erfassen und mit dem aktuellenusage=sum timestamp
an Stripe übergeben. - Der Wert
set
für den Parameteraction
ist für den Fall geeignet, dass Sie die Nutzung selbst zusammenfassen und den Preis mitaggregate_
oderusage=last_ during_ period aggregate_
konfigurieren.usage=last_ ever - 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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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_
= 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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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_
angegeben. Der Gesamtnutzungswert entspricht möglicherweise nicht der aktuellen Menge, da es zu geringfügigen Verzögerungen bei der Verarbeitung kommen kann.