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_BQokikJOvBiI2HlWgH4olfQ2
: \
  -X POST \
  -d quantity=100 \
  -d timestamp=1754167545 \
  -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.
• Der Endpoint für die Nutzungsberichte verfügt über eine Ratenbegrenzung und die Stripe API hat eine Ratenbegrenzung von 100 Aufrufen pro Sekunde pro Konto. Auf Anfrage können wir diese Anzahl auf 200 Aufrufe pro Sekunde und Konto erhöhen. Wenn Sie eine Dienstleistung anbieten, von der Sie erwarten, dass sie dieses Limit überschreitet, sollten Sie Ihr Produkt in Beträge „bündeln“. Wenn Sie beispielsweise pro 1000 Anfragen abrechnen, sollten Sie Ihr Produkt auf „pro 1000 Transaktionen“ setzen und einen Nutzungsdatensatz pro 1000 senden.

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 eine Vorschau-Rechnung für das Abonnement erstellen. Die Nutzung wird als quantity des Rechnungspostens für ein 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 https://api.stripe.com/v1/invoices/create_preview \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d subscription={{SUBSCRIPTION_ID}}