Transformieren Sie rohe Nutzungsereignisse in abrechenbare Mengen mit Aggregation und Filterung.
Meter wandeln Rohereignisse in abrechenbare Mengen um. Sie filtern Ereignisse und wenden Aggregationsfunktionen (Count, Sum, Max, Last) an, um die Nutzung pro Kunde zu berechnen.
Die Einheit, die auf Rechnungen und in Berichten angezeigt wird. Beispiele: calls, tokens, GB, hours.
3
Filtering (Optional)
Fügen Sie Bedingungen hinzu, um zu filtern, welche Ereignisse gezählt werden:
UND-Logik: Alle Bedingungen müssen übereinstimmen
ODER-Logik: Jede Bedingung kann übereinstimmen
Verfügbare Vergleichsoperatoren: gleich, nicht gleich, größer als, größer oder gleich, kleiner als, kleiner oder gleich, enthält, enthält nicht.Aktivieren Sie die Filterung, wählen Sie Ihre Logik aus und fügen Sie anschließend Bedingungen mit einem Eigenschaftsschlüssel, einem Vergleichsoperator und einem Wert hinzu.
4
Create
Überprüfen Sie Ihre Konfiguration und klicken Sie auf Create Meter.
Standardmäßig werden Kunden für jeden verbrauchten Einheit in Dollar (oder der konfigurierten Währung) belastet. Sie können einen Meter stattdessen so konfigurieren, dass er das Guthaben eines Kunden reduziert. Dadurch verbraucht die Nutzung Credits, anstatt eine Geldbelastung zu erzeugen.
Die creditbasierte Abbuchung erfordert ein Credit Entitlement, das demselben Produkt zugeordnet ist. Erstellen Sie zuerst das Credit Entitlement und verknüpfen Sie es anschließend mit dem Meter.
Erstellen Sie zunächst ein Credit Entitlement unter Products → Credits. Definieren Sie die Einheit (z. B. “API Calls”, “Tokens”), die Genauigkeit und die Lifecycle-Einstellungen (Ablauf, Übertragung, Mehrverbrauch).Sieh dir den Credit-Based Billing guide für detaillierte Anleitungen an.
2
Create or Edit a Usage-Based Product
Gehe zu deinem nutzungsbasierten Produkt und öffne den Konfigurationsbereich Meter.
3
Add a Meter
Klicke auf die +-Schaltfläche, um ein Meter anzufügen. Konfiguriere wie gewohnt den Ereignisnamen, den Aggregationstyp und die Messeinheit.
4
Enable 'Bill Usage in Credits'
Aktivieren Sie Bill usage in Credits in der Meter-Konfiguration, um die Credit-Einstellungen anzuzeigen:
Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.
Die Anzahl der Nutzungseinheiten, die benötigt werden, um 1 Credit abzuziehen. Beispielsweise:
1 = jedes Meter-Ereignis zieht 1 Credit ab
100 = 100 Meter-Ereignisse ziehen 1 Credit ab
1000 = 1.000 API-Aufrufe verbrauchen 1 Credit
5
Free Threshold and Credits
Der Free Threshold gilt für Meter, die in Geld abgerechnet werden, nicht für Meter, die in Credits abgerechnet werden. Wenn ein Meter in Credits abrechnet, zählt jede Einheit für den Credit-Abzug.Beispiel: Bei meter-units-per-credit von 1 werden einem Kunden, der 2.500 API-Aufrufe tätigt, 2.500 Credits abgezogen.
Sobald konfiguriert, läuft die Abzugs-Pipeline automatisch ab:
Ereignisse gehen ein — Ihre Anwendung sendet Nutzungsereignisse über die Event Ingestion API.
Meter aggregiert — Ereignisse werden gemäß Ihrer Meter-Konfiguration aggregiert (Count, Sum, Max, Last).
Hintergrund-Worker verarbeitet — Jede Minute ruft ein Worker neue Ereignisse seit dem letzten Checkpoint ab.
Credits werden abgezogen — Die aggregierte Nutzung wird anhand des meter_units_per_credit-Verhältnisses in Credits umgerechnet und nach FIFO-Reihenfolge abgezogen (Zuteilungen mit dem frühesten Ablaufdatum werden zuerst verbraucht).
Mehrverbrauch wird erfasst — Wenn das Guthaben null erreicht, wird die weitere Nutzung als Mehrverbrauch erfasst und gemäß dem konfigurierten Verhalten behandelt (beim Zurücksetzen erlassen, auf der nächsten Rechnung abgerechnet oder als Defizit vorgetragen). Dodo Payments blockiert die Nutzung nicht, wenn das Guthaben aufgebraucht ist. Um den Zugriff bei null zu stoppen, prüfen Sie das Guthaben in Ihrer Anwendung.
Der Credit-Abzug erfolgt asynchron (etwa alle 1 Minute). Zwischen der Erfassung eines Ereignisses und dem Abzug vom Guthaben kann eine kurze Verzögerung auftreten. Entwickeln Sie Ihre Anwendung so, dass sie diese Verzögerung berücksichtigt, und verlassen Sie sich bei der Zugriffskontrolle für einzelne Anfragen nicht auf Echtzeitprüfungen des Guthabens.
Sie können mehrere Meter desselben Produkts mit demselben Credit Entitlement verknüpfen. Alle Meter ziehen vom selben gemeinsamen Guthaben ab.Beispiel: Eine AI-Plattform mit zwei Metern:
text.generation — 1 Credit pro 1.000 Token
image.generation — 10 Credits pro Bild
Beide ziehen aus dem gleichen „AI Credits“-Pool. Der Kunde sieht ein einheitliches Guthaben in seinem Portal.
Nutze unterschiedliche meter_units_per_credit Sätze pro Meter, um relative Kosten auszudrücken. Teure Operationen (Bildgenerierung) verlangen weniger Meter-Einheiten pro Credit als günstige (Textvervollständigung).
List Customer Ledger
Sieh dir den vollständigen Verlauf der Credit-Abzüge für einen Kunden an.
Get Customer Balance
Prüfe das aktuelle Credit-Guthaben eines Kunden über die API.
