Credit-Based Billing

​

Was ist kreditbasierte Abrechnung?

• AI- und LLM-Plattformen: Gewähren Sie Tokens oder Generierungscredits pro Planstufe
• API-Dienste: Weisen Sie Credits für API-Aufrufe mit Preismodell für Überschreitungen zu
• Infrastrukturplattformen: Stellen Sie Compute-Stunden oder Storage-Credits aus
• Kommunikationsdienste: Stellen Sie Nachrichten- oder Minuten-Credits pro Abonnement bereit
• SaaS mit Verbrauchsstufen: Bündeln Sie die inkludierte Nutzung in Credit-Pools

​

Kernkonzepte

​

Kredittypen

​

Kreditlebenszyklus

​

Quellen zur Vergabe

​

Erstellung von Credits

1

Navigate to Credits

Gehen Sie zu Produkte in Ihrem Dashboard und wählen Sie den Credits-Tab. Klicken Sie auf Credit erstellen, um zu starten.

2

Configure Basic Information

Geben Sie einen Credit-Namen ein - dies ist Ihre interne Kennung für das Credit.

3

Set General Settings

Konfigurieren Sie den Kredittyp und die Anzeigeeigenschaften:

​

Credit Type

string

erforderlich

Wählen Sie Benutzerdefinierte Einheit oder Fiat-Credits.

• Benutzerdefinierte Einheit - Definieren Sie Ihre eigene Metrik (Tokens, API-Anrufe, Compute-Stunden). Erfordert einen Einheitennamen (z. B. “Plattform-Tokens”) und eine Präzisionseinstellung.
• Fiat-Credits - Credits repräsentieren den tatsächlichen Währungswert. Erfordert eine Auswahl Einheitswährung (USD, EUR, GBP, INR, etc.).

​

Unit Name

string

Nur für Credits mit benutzerdefinierter Einheit. Das Label, das Kunden für dieses Credit sehen (z. B. “AI Tokens”, “API-Anrufe”). Im Checkout und im Kundenportal angezeigt.

​

Precision

number

Nur für Credits mit benutzerdefinierter Einheit. Anzahl der zulässigen Dezimalstellen:

• 0 - Ganze Zahlen (am besten für zählbare Elemente wie API-Anrufe)
• 1 - Ein Dezimal (0,0)
• 2 - Zwei Dezimalen (0,00) - Standard
• 3 - Drei Dezimalen (0,000)

Die Präzision kann nicht geändert werden, nachdem das Credit erstellt wurde.

​

Credit Expiry

string

Wie lange Credits nach ihrer Ausgabe gültig bleiben:

• 7 Tage, 30 Tage (Standard), 60 Tage, 90 Tage, Benutzerdefiniert oder Nie

Wählen Sie Benutzerdefiniert, um eine benutzerdefinierte Anzahl von Tagen anzugeben (Minimum 1).

4

Configure Subscription Settings (Optional)

Diese Einstellungen steuern das Verhalten von Credits innerhalb wiederkehrender Abonnements:

​

Rollover

boolean

Erlauben Sie es, dass ungenutzte Credits in den nächsten Abrechnungszyklus übertragen werden. Wenn aktiviert, konfigurieren Sie:

• Maximale Übertragungsquote (0–100 %) - Begrenzen Sie, wie viel übertragen wird
• Übertragungszeitraum - Wie lange übertragene Credits gültig bleiben (z. B. 1 Monat)
• Maximale Anzahl von Übertragungen - Maximale aufeinanderfolgende Übertragungen, bevor Credits verfallen

Wenn Credits ausgehen oder das Abonnement abläuft:

​

Allow Overage

boolean

Lassen Sie Kunden Ihren Service weiter nutzen, nachdem ihr Kreditguthaben auf null gesunken ist. Wenn aktiviert, konfigurieren Sie:

• Überschreitungsgrenze - Maximale Credits, die Kunden über ihr Guthaben hinaus konsumieren können
• Preis pro Einheit - Kosten pro zusätzlichem Credit bei aktivierter Überschreitung (mit Währungsauswahl)

​

Overage Behavior

string

erforderlich

Kontrolliert, wie Überschreitungen am Ende des Abrechnungszyklus behandelt werden:

• Überschreitung bei Zurücksetzung verzeihen (Standard) - Nutzung über das Kreditlimit hinaus wird verfolgt, aber nicht in Rechnung gestellt. Das Guthaben wird in jedem Zyklus zurückgesetzt.
• Überschreitung bei Abrechnung in Rechnung stellen - Nutzung über das Kreditlimit hinaus wird auf der nächsten Rechnung in Rechnung gestellt, dann wird das Guthaben zurückgesetzt.
• Defizit übertragen - Nutzung über das Kreditlimit hinaus wird als negativer Saldo in den nächsten Zyklus übertragen.
• Defizit übertragen (automatische Rückzahlung) - Defizit wird weitergetragen und automatisch mit neuen Credits im nächsten Zyklus zurückgezahlt.

5

Create Credit

Klicken Sie auf Credit erstellen, um zu speichern. Das Credit steht nun zur Verfügung, um es jedem Produkt zuzuordnen.

Ihre Kreditberechtigung ist bereit. Ordnen Sie sie Produkten zu, um Kunden Credits auszustellen.

​

Credits an Produkte anhängen

​

Abonnementprodukte

1

Create or Edit a Subscription Product

Gehen Sie zu Produkte → Produkt erstellen oder bearbeiten Sie ein bestehendes Produkt. Wählen Sie Abonnement als Preistyp und konfigurieren Sie Ihren wiederkehrenden Preis.

2

Open Entitlements Section

Erweitern Sie den Abschnitt Berechtigungen und klicken Sie auf die Anfügen-Schaltfläche neben Credits.

3

Select Credits to Attach

Ein Credits hinzufügen-Panel öffnet sich. Sie können ein bestehendes Credit aus dem Dropdown-Menü auswählen oder auf Neues Credit erstellen klicken, um eines sofort zu definieren.

Sie können bis zu 3 Credits pro Produkt anhängen. Jedes Credit kann seine eigene Konfiguration haben.

4

Configure Credit Settings

Für jedes angehängte Credit konfigurieren:

​

Credits issued per billing cycle

number

erforderlich

Die Anzahl der Credits, die dem Kunden in jedem Abrechnungszeitraum gewährt werden.

​

Low Balance Threshold

number

Benachrichtigen, wenn Credits unter diesen Betrag fallen. Nützlich, um Kunden zu warnen, bevor sie keine Credits mehr haben.

​

Credits During Free Trial

number

Setzen Sie eine andere Anzahl von Credits für Testzeiträume fest. Aktivieren Sie Test-Credits nach Testende verfallen lassen, um ungenutzte Test-Credits zu widerrufen, wenn der Test in ein bezahltes Abonnement umgewandelt wird.

​

Allow Proration

boolean

Berechnen Sie verbleibende Credits anteilig, wenn ein Kunde seinen Abonnementplan aktualisiert oder herunterstuft.

​

Import Default Credit Settings

boolean

Verwenden Sie die Standard-Übertrag, Überschreitungs- und Verfallseinstellungen aus der Kreditberechtigung. Schalten Sie dies aus, um speziell für dieses Produkt Einstellungen anzupassen.

5

Review and Add

Überprüfen Sie das angehängte Credit, das Name, Betrag und Ablaufdatum anzeigt. Klicken Sie auf Zum Abonnement hinzufügen, um zu bestätigen.

​

Einmalige Zahlungsprodukte

1

Create a One-Time Product

Erstellen Sie ein Produkt mit Einzelzahlungs-Preismodell.

2

Attach Credits

Öffnen Sie den Bereich Berechtigungen und fügen Sie Credits hinzu. Konfigurieren Sie die Anzahl der ausgegebenen Credits (insgesamt einmaliges Guthaben) beim Kauf.

​

Nutzungsbasierte Abrechnungsprodukte

1

Create a Usage-Based Product

Wählen Sie Nutzungsbasierte Abrechnung als Preismodell. Konfigurieren Sie den Basispreis und die Abrechnungshäufigkeit.

2

Add a Meter

Klicken Sie auf die +-Schaltfläche im Abschnitt Zähler auswählen, um einen Zähler hinzuzufügen. Ein Abonnement kann bis zu 3 Zähler haben.

3

Enable Credit Billing on the Meter

Schalten Sie Nutzung in Credits abrechnen um, um einen Credit an den Zähler anzuhängen. Wählen Sie die Kreditberechtigung aus dem Dropdown-Menü aus.

​

Free Threshold

number

erforderlich

Die Anzahl der Einheiten, die kostenlos sind, bevor die Credit-Abzüge beginnen.

​

Bill usage in Credits

boolean

Wenn aktiviert, zieht die Zählernutzung vom Kreditguthaben des Kunden ab, anstatt pro Einheit zu berechnen.

​

Meter units per credit

number

erforderlich

Die Anzahl der Nutzungseinheiten, die benötigt werden, um 1 Credit abzuziehen. Zum Beispiel, wenn es auf 1000 eingestellt ist, dann verbrauchen 1.000 API-Anrufe 1 Credit.

4

Configure Credit Issuance

Legen Sie die Anzahl der ausgegebenen Credits fest und passen Sie optional die Credit-Einstellungen für dieses Produkt an.

5

Verify Attachment

Sobald konfiguriert, zeigt der Zähler den angehängten Credit-Namen, den Einheitspreis und den freier Schwellenwert an.

​

Credit-Einstellungen

​

Übertrag

​

Überschreitung

​

Verfall

​

Nutzungsabrechnung mit Credits

​

So funktioniert der Zählerbasierte Credit-Abzug

1. Ihre Anwendung sendet Nutzungsereignisse - Jedes Ereignis enthält eine Kunden-ID, einen Ereignisnamen und Metadaten
2. Zähler aggregieren Ereignisse - Verwendung von Count-, Sum-, Max-, Last- oder Unique-Count-Aggregation
3. Credits werden automatisch abgezogen - Ein Hintergrund-Worker verarbeitet Ereignisse jede Minute, konvertiert Zähleinheiten in Credits mit ihren konfigurierten Raten und zieht sie vom Kundenesaldo mit FIFO-Ordnung (älteste Zuteilungen zuerst) ab
4. Überschreitung wird verfolgt - Wenn der Kreditguthaben auf null sinkt und Überschreitung aktiviert ist, verfolgt das System Überschreitungsnutzung für die Abrechnung am Zyklusende

​

Zähler-Panel

​

Kundenerlebnis

​

Checkout

​

Kundenportal

• Verfügbares Guthaben - Aktuelles Kreditguthaben prominent angezeigt
• Credit-Tabs - Wechseln zwischen verschiedenen Credit-Typen (z. B. “OpenAI-Credits”, “Nutzungs-Token”)
• Neueste Transaktionen - Vollständiger Verlauf mit Datum, Transaktions-ID, Typ, Betrag und laufendem Saldo

​

Abonnementdetails

• Kreditzuweisung pro Abrechnungszyklus (z. B. “1000 Credits pro Zyklus”)
• Verbleibendes Guthaben (z. B. “7500 Credits verbleibend”)
• Erneuerungsdatum für die nächste Credit-Ausgabe
• Nutzungshistorie-Tab mit zählerspezifischer Aufgliederung, die verbrauchte Einheiten, Schwellenwerte, Einheitspreise und Gesamtkosten zeigt

​

Transaktionsdetails

​

Verwaltung von Credits

​

Dashboard-Ansichten

​

Liste der Kreditberechtigungen

​

Kundendaten zu Credits

• Credit-Auswahl - Wechseln zwischen verschiedenen Kreditberechtigungen
• Verfügbares Guthaben - Aktuelles Guthaben in großer, prominenter Darstellung
• Kredit/Debit anwenden - Schaltfläche zur manuellen Anpassung des Guthabens des Kunden
• Neueste Transaktionen - Vollständiges Ledger mit Datum, Transaktions-ID, Typ, Betrag und laufendem Saldo

​

Manuelle Anpassungen

​

Credit-Ledger

​

Webhooks

​

API-Verwaltung

​

Integrationsbeispiel

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode', // defaults to 'live_mode'
});

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_ai_pro_plan',
      quantity: 1,
    }
  ],
  customer: { email: 'customer@example.com' },
  return_url: 'https://yourapp.com/success'
});

await client.usageEvents.ingest({
  events: [{
    event_id: `gen_${Date.now()}`,
    customer_id: 'cus_abc123',
    event_name: 'ai.generation',
    timestamp: new Date().toISOString(),
    metadata: { model: 'gpt-4', tokens: 1500 }
  }]
});

​

Praxisbeispiele

​

Best Practices

• Einfach anfangen: Beginnen Sie mit einer einzigen Kreditart und keinem Übertrag. Fügen Sie Komplexität basierend auf Kundenfeedback und Nutzungsmustern hinzu.
• Klare Erwartungen setzen: Zeigen Sie Kreditzuweisungen, verbleibende Guthaben und Überschreitungspreise prominent auf Ihren Produktseiten und im Kundenportal an.
• Verwenden Sie sinnvolle Einheiten: Benennen Sie Credits nach dem, was sie darstellen (z. B. “API-Anrufe”, “AI Tokens”), anstatt allgemeine Begriffe zu verwenden. Dies hilft den Kunden, den Wert zu verstehen.
• Ablauf sorgfältig konfigurieren: Kurze Fristen (7 Tage) treiben die Dringlichkeit an, können aber Kunden frustrieren. Längere Fristen (30–90 Tage) sind für die meisten SaaS-Produkte kundenfreundlicher.
• Niedrige Guthaben überwachen: Setzen Sie niedrige Guthabenschwellenwerte, um Kunden zu warnen, bevor sie keine Credits mehr haben, und unangenehme Überraschungen bei Überschreitungsgebühren zu reduzieren.
• Im Testmodus testen: Erstellen Sie Credits, hängen Sie sie an Testprodukte an und simulieren Sie den vollständigen Kauf → Nutzung → Abzug → Ablauf-Zyklus, bevor Sie live gehen.