Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Finanzautomatisierung
Plattformen und Marktplätze
Geldmanagement
Entwickler-Tools
Jetzt starten
Zahlungen
Finanzautomatisierung
Jetzt starten
Zahlungen
Finanzautomatisierung
Plattformen und Marktplätze
Geldmanagement
Übersicht
Billing
    Übersicht
    Über die Billing APIs
    Abonnements
    Invoicing
    Nutzungsbasierte Abrechnung
      Choose a usage-based billing setup
      Nutzung für Abrechnungszwecke aufzeichnen
        Zähler erstellen
        Zähler konfigurieren
        Nutzung mit der API aufzeichnen
        Nutzung im Dashboard aufzeichnen
        Nutzung mit S3 aufzeichnen
        Nachfrist konfigurieren
      Abrechnungsgutschriften anbieten
      Nutzung überwachen
      Nutzungsbasierte Preismodelle
    Connect und Billing
    Tax und Billing
    Angebote
    Umsatzsicherung
    Automatisierungen
    Skripte
    Umsatzrealisierung
    Kundenverwaltung
    Berechtigungen
    Integration testen
Steuer
Berichte
Daten
Start-up-Gründung
StartseiteFinanzautomatisierungBillingUsage-based billingRecord usage for billing

Zähler konfigurieren

Konfigurieren Sie Zähler für die nutzungsbasierte Abrechnung.

Seite kopieren

Bevor Sie die Nutzung des Kunden/der Kundin aufzeichnen können, müssen Sie einen Zähler erstellen und diesen dann konfigurieren. Nachdem Sie den Zähler konfiguriert haben, können Sie außer dem Anzeigenamen nichts mehr ändern.

Konfigurationsattribute des Zählers

ZählerattributBeschreibung
EreignisnameDer Name des Zählerereignisses, für das Sie die Nutzung mit dem Zähler aufzeichnen möchten. Wenn Sie die Nutzung an Stripe senden, geben Sie diesen Ereignisnamen im Feld event_name für das Zählerereignis an. Auf diese Weise kann der richtige Zähler die Nutzung aufzeichnen und zusammenfassen. Sie können einen Ereignisnamen nur mit einem einzelnen Zähler verwenden.

Ereigniseingabe

Legen Sie fest, wie Sie Nutzungsereignisse an Stripe senden:

  • Rohdaten: Behandeln Sie alle Zählerereignisse als eigenständige Ereignisse. Mehrere Ereignisse, die für denselben Zeitstempel gesendet werden, überschreiben sich nicht gegenseitig. Die Zusammenfassung enthält mehrere Ereignisse. Wenn Sie keine Angaben machen, ist dies die Standardoption.
  • Vorab zusammengefasst: Wenn Sie Ereignisse für ein bestimmtes Zeitintervall senden (stündlich oder täglich), verwendet Stripe nur das neueste erhaltene Zählerereignis in diesem Intervall. Ein neueres Ereignis, das innerhalb desselben stündlichen oder täglichen Zeitfensters gesendet wird, überschreibt das vorherige. Der Zeitstempel des Zählerereignisses in UTC bestimmt die Stunden- und Tagesgrenzen.

Gruppierungsformel

Geben Sie an, wie die Nutzung über den Abrechnungszeitraum hinweg zusammengefasst werden soll.

  • Summe: Berechnen Sie Kundinnen/Kunden die Gebühr basierend auf der Summe aller Nutzungswerte für den Abrechnungszeitraum.
  • Anzahl: Berechnen Sie Kundinnen/Kunden die Gebühr basierend auf der Gesamtnutzung für den Abrechnungszeitraum.
  • Letzte: Berechnen Sie Kundinnen und Kunden basierend auf dem Wert des letzten Nutzungsereignisses für den Abrechnungszeitraum.

Überschreibungen der Schlüsselnutzlast

Geben Sie an, welche Schlüssel in der Ereignisnutzlast sich auf die Kunden- und die numerischen Nutzungswerte beziehen:

  • value_settings: Verwenden Sie diesen Parameter, um den Schlüssel in der Ereignisnutzlast zu definieren, der sich auf den numerischen Nutzungswert bezieht. Der Standardschlüssel ist value, aber Sie können auch einen anderen Schlüssel angeben, wie z. B. Token.
  • customer_mapping: Verwenden Sie diesen Parameter, um den Schlüssel in der Ereignisnutzlast zu definieren, der sich auf die Kunden-ID bezieht. Der Standardschlüssel ist stripe_customer_id, aber Sie können auch einen anderen Schlüssel angeben, zum Beispiel customer_id.

Fehlerhafte Nutzungsdaten korrigieren

Wenn Sie im aktuellen Abrechnungszeitraum falsch aufgezeichnete Ereignisse feststellen, können Sie eine Zählerereignisanpassung erstellen, um diese Ereignisse zu stornieren. Sie müssen die Kennung für das Zählerereignis angeben.

Sie können nur Ereignisse stornieren, die innerhalb der letzten 24 Stunden an Stripe gesendet wurden. Wenn Sie eine Nutzung stornieren, die in einer finalisierten Rechnung enthalten ist, aktualisieren wir die Rechnung nicht und stellen keine korrigierte Rechnung für die stornierte Nutzung aus. Wir unterstützen keine Rechnungsanpassungen für die stornierte Nutzung auf einer finalisierten Rechnung, die an eine Kundin/einen Kunden gesendet wurde.

Sie können falsch erfasste Nutzungsdaten auch korrigieren, indem Sie negative Mengen erfassen. Wenn die Gesamtzyklusnutzung negativ ist, meldet Stripe die Nutzungsmenge des Rechnungspostens als 0.

Command Line
cURL
curl https://api.stripe.com/v1/billing/meter_event_adjustments \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d type=cancel \ -d event_name=alpaca_ai_tokens \ -d "cancel[identifier]"={{METER_EVENT_IDENTIFIER}}
War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unser Änderungsprotokoll an.
Fragen? Sales-Team kontaktieren.
LLM? Lesen Sie llms.txt.
Unterstützt von Markdoc
Ähnliche Leitfäden
Nutzungsbasierte Preismodelle
Verwendete Produkte
Billing