Jeder „Neu …“-Dialog, in einfacher Sprache erklärt

Der Name deines Unternehmens oder Teams. Reines Etikett — du kannst ihn später ändern.

Wohin Rechnungen und Abrechnungshinweise für dein MeterFlow-Konto gehen würden. Optional; das Format wird geprüft, aber es wird nichts zur Bestätigung verschickt.

Zu welcher Organisation das Projekt gehört. Vorausgewählt, wenn bereits eine aktiv ist.

Der Produktname, z. B. „PixelForge AI“. Erscheint überall im Dashboard und im Projektumschalter.

Freitext für deine eigene Referenz.

Ein Etikett, damit du weißt, wo der Schlüssel verwendet wird — „Produktions-Backend“, „Staging“, „CI-Tests“. Ohne technische Wirkung.

Live-Schlüssel beginnen mit mf_live_, Test-Schlüssel mit mf_test_ — und sie greifen auf zwei vollständig getrennte Datensätze im selben Projekt zu. Abonnements, Guthaben und Verbrauch, die mit einem Test-Schlüssel erzeugt wurden, sind für Live-Schlüssel unsichtbar (und umgekehrt), während Meter und Pläne geteilt werden — Tests laufen also immer gegen deine echte Abrechnungskonfiguration. Nutze Test-Schlüssel für Entwicklung, Staging und CI; Live-Schlüssel nur für echten Produktionsverkehr.

Das menschenfreundliche Etikett im Dashboard — „Erzeugte Bilder“, „Video-Render-Sekunden“. Nur für menschliche Augen.

Der Maschinenschlüssel — und ja, er wird in der Datenbank gespeichert und exakt abgeglichen. Wenn deine Anwendung Nutzung meldet, sendet sie einen Ereignisnamen; MeterFlow sucht in dem Projekt den aktiven Meter, dessen event_name exakt übereinstimmt, Groß-/Kleinschreibung inklusive. Existiert keiner, wird das Ereignis mit einem 404-Fehler abgelehnt („No active meter found for event …“) und nichts wird erfasst. Jeder Ereignisname ist innerhalb eines Projekts eindeutig. Konvention: klein mit Punkten, z. B. image.generated.

Wie viele einzelne Ereignisse in den Nutzungsübersichten zu einer Zahl zusammengefasst werden. Siehe Tabelle unten — das ist das Herz des Meters.

Pflicht bei Sum, Max, Min und Unique count; bei Count abgelehnt, denn Count liest keine Eigenschaft. Es benennt eine Eigenschaft deiner Ereignisse. Bei Sum, Max und Min kommt die Menge von dort, wenn deine App value weglässt — ein Meter mit dem Feld seconds liest properties.seconds; ein von deiner App gesendetes value hat immer Vorrang, und ein Ereignis ohne beides zählt als 1. Bei Unique count ist es die Eigenschaft, deren verschiedene Werte gezählt werden — model, um die Modelle zu zählen, die ein Kunde genutzt hat.

Freitext für dein Team.

Der Name der Stufe — „Free“, „Pro“, „Enterprise“. Pflicht; der Erstellen-Button bleibt deaktiviert, bis er ausgefüllt ist.

Freitext, z. B. der Marketing-Einzeiler der Stufe.

Die wiederkehrende Abogebühr: Price ist der Betrag (0 ist für eine Gratis-Stufe völlig in Ordnung), Currency ein Code wie USD, und Billing period der Rhythmus — monatlich, jährlich, wöchentlich oder einmalig. Nach der Erstellung fest — späteres Bearbeiten des Plans kann sie nicht ändern (lege stattdessen einen neuen Plan an, damit sich die Konditionen bestehender Abonnenten nicht stillschweigend ändern).

Gratistage am Anfang jedes neuen Abonnements. Mit 14 verbringt ein neuer Abonnent 2 Wochen im Status „trialing“, bevor die bezahlte Periode beginnt. 0 = keine Testphase.

Ob der Plan für deine Kunden überhaupt existiert. Ausgeschaltet ist er ein Entwurf: Du kannst Preis, Limits und Feature-Keys über mehrere Sitzungen festlegen, und deine API-Schlüssel sehen ihn nie — er fehlt in der Planliste des SDK, eine durchgesickerte Plan-ID antwortet 404, und niemand kann ihn abonnieren. Neue Pläne sind veröffentlicht; schalte es aus, um einen in Ruhe vorzubereiten, und wieder ein, wenn er verkauft wird. Später wieder auszuschalten schließt die Tür für neue Abonnenten, ohne die bestehenden anzutasten.

Die An/Aus-Vorteile, die der Plan enthält — kurze Schlüssel, die du dir ausdenkst, etwa sso oder priority-support (Kleinbuchstaben, Ziffern, - und _). Deine App fragt das SDK entitlements.check(customerId, 'sso') und bekommt nur für Kunden auf einem Plan, der den Schlüssel führt, ein Ja. Jederzeit änderbar, bei neuen wie bestehenden Plänen; für Dinge, die du zählst, nimm stattdessen ein Meter-Limit weiter unten.

Auf welche gemessene Größe sich dieses Limit bezieht. Das Dropdown listet die Meter, die du in diesem Projekt angelegt hast — nicht mehr, nicht weniger. Es ist kein fester Katalog: Jede neue Produktfähigkeit braucht nur zuerst einen neuen Meter, und er erscheint hier sofort.

Das im Planpreis enthaltene Kontingent, pro Abrechnungszeitraum. „Pro enthält 500 Bilder pro Monat“ → 500. In einer Hard- oder Soft-Zeile ist eine Zahl Pflicht, bevor der Plan angelegt werden kann — ein leeres Kontingent würde nichts begrenzen — es sei denn, du hakst unten Unlimited an und sagst damit, dass genau das gemeint war. In einer Metered-Zeile ist leer bereits eine Aussage: Pay-as-you-go ab der ersten Einheit.

Nur in Hard- und Soft-Zeilen, und der ausdrückliche Weg zu sagen „kein Limit für diesen Meter“. Angehakt wird Included units abgeschaltet und geleert; nicht angehakt bleibt die Zahl Pflicht. Metered-Zeilen haben den Schalter nicht, weil leer dort schon etwas bedeutet.

Der Preis in Credits pro Einheit, sobald der Kunde die inkludierten Einheiten überschreitet — 0.5 heißt: Jede zusätzliche Einheit kostet einen halben Credit von seinem Guthaben. Er gehört nur zum Typ Metered: Das Formular verlangt ihn in einer Metered-Zeile und blendet ihn bei Hard und Soft aus, und die API lehnt einen Satz in einer Hard- oder Soft-Zeile ab (422). Eine Metered-Zeile ohne inkludierte Einheiten und ohne Satz würde jede Einheit ablehnen, deshalb lehnt die API auch diese Zeile ab (422).

Was entitlements.check() des SDK antwortet, sobald die inkludierten Einheiten aufgebraucht sind — der Aufruf, den deine App vor der Arbeit macht. Hard (blockieren) — check() antwortet nein (hard_limit_reached) und deine App lehnt die Aktion ab; der Kunde stößt bis zur nächsten Periode oder einem Upgrade an eine Wand. Soft (warnen) — check() antwortet weiterhin ja, markiert mit soft_limit_exceeded, deine App lässt es also durch und bewegt den Kunden zum Upgrade. Metered (abrechnen) — check() antwortet ja, solange die Credits des Kunden die zusätzlichen Einheiten decken, und jede zusätzliche Einheit wird zum Mehrverbrauchssatz vom Guthaben abgebucht; reicht das Guthaben nicht, lautet die Antwort nein (insufficient_credits). Metered ist die „Pay-as-you-go“-Option und die einzige, die von selbst Geld (Credits) bewegt. Ein Metered-Limit wird bei einem Max- oder Min-Meter abgelehnt (422): Ein Höchst- oder Tiefstwert lässt sich nicht pro Einheit abrechnen. In einer Metered-Zeile kann ein Ausgabenlimit am Abonnement des Kunden check() schon mit nein antworten lassen, bevor das Guthaben aufgebraucht ist (spend_cap_reached). Hard und Soft lösen den Webhook limit.reached einmal pro Abrechnungszeitraum aus, beim ersten Überschreiten der Grenze. In jedem Fall zeichnet MeterFlow die Ereignisse, die deine App sendet, weiter auf — das Tor ist check(), in deinem Code.

Dein eigener Bezeichner für den Endkunden — eine beliebige Zeichenkette deiner Wahl: eine Nutzer-ID aus deiner Datenbank (user-842), eine E-Mail, ein Tenant-Kürzel. MeterFlow validiert sie gegen nichts; was du sendest, ist, wem das Abonnement gehört. Verwende überall dieselbe ID (Abonnements, Credits, Nutzung), sonst finden die Teile nicht zueinander.

Auf welcher Preisstufe er ist — das Dropdown listet die Pläne dieses Projekts. Hat der Plan Testtage, startet das Abonnement im Status „trialing“, sonst „active“.

Sein Guthaben und jede Ledger-Zeile dahinter, mit Grant und Deduct — die Dialoge sind weiter unten erklärt.

Was er genutzt hat, Meter für Meter.

Sein Plan und dessen Status, mit Cancel oder Reactivate.

Was sein Plan gewährt, Feature für Feature: was von jedem abgerechneten Kontingent übrig ist, und der Grund, aus dem ein Feature abgelehnt wird, genau wie entitlements.check() ihn liefern würde.

Wie viele Credits hinzukommen (Grant) oder abgehen (Deduct). Muss größer als null sein — die Richtung bestimmt der Button, der den Dialog geöffnet hat, nicht ein Minuszeichen.

Ein optionaler Vermerk auf dem Journaleintrag — „Willkommensbonus“, „Erstattung wegen Ausfall“, „Support-Kulanz“. Dein zukünftiges Ich wird es dir danken.

Gilt 60 Minuten, sofern du nicht expires_in_minutes setzt — höchstens 24 Stunden — und lässt sich vorher nicht zurückziehen. Er öffnet die Seite eines einzigen Kunden, nur lesend: Er kann nichts ändern und keinen anderen Kunden zeigen. Ein mit einem Testschlüssel (mf_test_…) erzeugter Link zeigt Testdaten, unter einem Badge Test data.

Projekt öffnen → Portal: Firmenname, Logo, helles / dunkles / automatisches Theme, Farben und Eckenradius, dazu die Standardwerte — Buy-more-URL, Back-URL und Gültigkeitsdauer — für Links, die sie weglassen. Ein Häkchen überträgt den Look auf alle Projekte der Organisation.

In der Tabelle Customers erzeugt die Zeilenaktion Create a portal link ohne Code einen Link für diesen Kunden — ebenso Portal link in seinem Tab Credits.

Muss exakt dem Ereignisnamen eines existierenden, aktiven Meters in diesem Projekt entsprechen (Groß-/Kleinschreibung zählt). Über diese Übereinstimmung weiß MeterFlow, welchen Zähler dieses Ereignis speist. Kein passender Meter → die API lehnt das Ereignis mit 404 ab und nichts wird gespeichert. Die exakte Schreibweise findest du auf der Meters-Seite.

Welcher deiner Kunden es getan hat — dieselbe frei wählbare ID-Zeichenkette wie bei Abonnements und Credits. Konsistenz ist alles: user-842 und USER-842 sind zwei verschiedene Kunden.

Die Menge — optional. Lässt du sie weg, liest ein Sum-, Max- oder Min-Meter sie aus der Ereigniseigenschaft, die sein Aggregationsfeld benennt (deine App schickt sie unter properties); sonst zählt das Ereignis 1. Die Bedeutung hängt von der Aggregation des Meters ab: Bei einem Count-Meter wird der Wert ignoriert (jedes Ereignis zählt als ein Vorkommen); bei Sum ist es die zu addierende Menge (42 Sekunden, 1 300 Tokens); bei Max/Min der verglichene Messwert; ein Unique count-Meter zählt die verschiedenen Werte seines Aggregationsfelds.

Wohin MeterFlow die Ereignisse sendet, z. B. https://api.acme.dev/meterflow.

Von welchen Ereignissen dieser Endpunkt erfährt: usage.recorded, credit.granted, credit.deducted (eine Abbuchung oder eine abgerechnete Metered-Nutzung — sein transaction_type sagt, welche), subscription.created, .updated, .renewed und .canceled, limit.reached, cap.reached, balance.exhausted, dazu die beiden unten.

Ein Guthaben, in Credits. Setzt du ihn, erhält der Endpunkt auch balance.low, wenn das Guthaben eines Kunden darunter fällt, und balance.topped_up, wenn es wieder darüber steigt; löschst du ihn, enden beide. Die zwei Ereignisse kommen und gehen mit dem Schwellenwert, denn ohne Linie lässt sich einem Endpunkt kein Überschreiten melden.

Über welchen der fünf deine Kunden zahlen.

Live — das Produktivkonto deines Anbieters, das Live-Daten schreibt; Test — seine Sandbox, die Testdaten schreibt. Ein Connector pro Anbieter und Konto.

Das Geheimnis, mit dem dein Anbieter seine Webhooks signiert — bei Chargebee, das nichts signiert, Benutzername und Passwort, die es stattdessen mitschickt. Es wird bei jedem Aufruf geprüft und nie wieder angezeigt: Die Tabelle zeigt nur seine letzten vier Zeichen.

Wird angezeigt, sobald der Connector angelegt ist: Füge sie in die Webhook-Einstellungen deines Anbieters ein.

Welcher Preis deines Anbieters — ein Produkt bei Polar, eine Variante bei Lemon Squeezy, ein Plan bei Chargebee und Razorpay — einen Kunden auf welchen deiner Pläne setzt. Ein Ereignis zu einem Preis ohne Zuordnung wird protokolliert und ändert nichts.

Jedes Ereignis, das der Connector empfangen hat, mit dem, was er damit tat, in einem Satz: was angewendet wurde und warum der Rest ignoriert wurde.

Wohin die Einladung geht. MeterFlow schickt einen Link, der einmal funktioniert, 7 Tage lang, nur für diese Adresse: Die Person öffnet ihn und tritt bei — mit ihrem Konto oder indem sie über den Link eines anlegt.

Admin — Organisationseinstellungen, Einladungen, API-Schlüssel, Webhooks, Connectoren, Projekte und Abrechnung. Member — wer täglich arbeitet: Meter, Pläne und die Seiten Subscriptions, Usage und Kunde. Viewer — nur lesen. Eine Option „Owner“ gibt es absichtlich nicht: Eigentümerschaft wird nicht per Einladung vergeben.

Stehen auf der Seite Members, bis sie angenommen, widerrufen werden oder ablaufen. Revoke stoppt den Link sofort.

In der Zeile jedes Mitglieds, für Owner und Admins. Die Mitgliedschaft des Owners und deine eigene lassen sich dort nicht ändern. Wer entfernt wird, verliert den Zugang; sein Konto und was er angelegt hat, bleiben.