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 Name ein – dies ist Ihre interne Kennung für den Credit.

3

Set General Settings

Konfigurieren Sie den Kredittyp und die Anzeigeeigenschaften:

​

Credit Type

string

erforderlich

Wählen Sie Benutzerdefinierte Einheit oder Fiat-Credits.

• Custom Unit: Definieren Sie Ihre eigene Metrik (Tokens, API-Aufrufe, Compute-Stunden). Erfordert einen Unit Name (zum Beispiel „Platform tokens“) und eine Einstellung für Precision.
• Fiat Credits: Credits stellen einen realen Währungswert dar. Erfordert die Auswahl einer Unit Currency (USD, EUR, GBP, INR usw.).

​

Unit Name

string

Nur für Credits vom Typ Custom Unit. Die Bezeichnung, die Kunden für diesen Credit sehen (zum Beispiel „AI Tokens“ oder „API Calls“). Sie wird im Checkout und im Customer Portal angezeigt.

​

Precision

number

Nur für Credits in benutzerdefinierten Einheiten. Anzahl der zulässigen Dezimalstellen, von 0 bis 10:

• 0: Ganze Zahlen (ideal für zählbare Elemente wie API-Aufrufe)
• 1: Eine Dezimalstelle (0.0)
• 2: Zwei Dezimalstellen (0.00) – Standard
• 3: Drei Dezimalstellen (0.000)
• Bis zu 10: Für Einheiten mit hoher Genauigkeit (zum Beispiel Bruchteile von Tokens oder geringfügige Nutzung)

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:

• Max Rollover Percentage (0–100 %): Begrenzen Sie, wie viel übertragen wird
• Rollover Timeframe: Wie lange übertragene Credits gültig bleiben (zum Beispiel 1 Month)
• Max Rollover Count: Maximale Anzahl aufeinanderfolgender Ü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:

• Overage Limit: Maximale Anzahl an Credits, die Kunden über ihr Guthaben hinaus verbrauchen können
• Price Per Unit: Kosten pro zusätzlichem Credit, wenn eine Überschreitung aktiviert ist (mit Währungsauswahl)

​

Overage Behavior

string

erforderlich

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

• Forgive overage at reset (Standard): Die Nutzung über das Credit-Limit hinaus wird erfasst, aber nicht berechnet. Das Guthaben wird in jedem Zyklus zurückgesetzt.
• Bill overage at billing: Die Nutzung über das Credit-Limit hinaus wird auf der nächsten Rechnung berechnet; anschließend wird das Guthaben zurückgesetzt.
• Carry over deficit: Die Nutzung über das Credit-Limit hinaus wird als negatives Guthaben in den nächsten Zyklus übertragen.
• Carry over deficit (auto-repay): Das Defizit wird übertragen und im nächsten Zyklus automatisch mit neuen Credits 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 5 Credits pro Produkt zuweisen. 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 das Guthaben unter diesen Prozentsatz fällt (0–100). Nützlich, um Kunden zu benachrichtigen, bevor ihr Guthaben aufgebraucht ist.

​

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 im Abschnitt Select meter auf die Schaltfläche +, um einen Meter hinzuzufügen. Ein Abonnement kann bis zu 50 Meter enthalten.

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

Gilt nur, wenn der Meter in Geld abrechnet. Wenn der Meter in Credits abrechnet, wird jede Einheit vom Credit-Guthaben abgezogen.

​

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

​

Ablauf

​

Nutzungsabrechnung mit Credits

​

So funktioniert der meterbasierte Credit-Abzug

1. Ihre Anwendung sendet Nutzungsereignisse: Jedes Ereignis enthält eine Kunden-ID, einen Ereignisnamen und Metadaten
2. Meter aggregieren Ereignisse: Mithilfe der Aggregation Count, Sum, Max oder Last
3. Credits werden automatisch abgezogen: Ein Hintergrund-Worker verarbeitet Ereignisse jede Minute, konvertiert Meter-Einheiten anhand Ihres konfigurierten Satzes in Credits und zieht sie mithilfe der FIFO-Reihenfolge (zuerst ablaufende Gutschriften zuerst) vom Guthaben des Kunden ab
4. Überschreitungen werden erfasst: Wenn das Credit-Guthaben null erreicht und Überschreitungen aktiviert sind, erfasst das System die Nutzung der Überschreitung für die Abrechnung am Zyklusende

​

Meters-Bereich

​

Kundenerlebnis

​

Checkout

​

Customer Portal

• Available Balance: Das aktuelle Credit-Guthaben wird prominent angezeigt
• Credit Tabs: Wechsel zwischen verschiedenen Credit-Typen (zum Beispiel „OpenAI Credits“ oder „Usage Tokens“)
• Recent Transactions: Vollständiger Verlauf mit Datum, Transaktions-ID, Typ, Betrag und laufendem Guthaben

​

Abonnementdetails

• Credit allocation pro Abrechnungszyklus (zum Beispiel „1000 credits each cycle“)
• Remaining balance (zum Beispiel „7500 credits remaining“)
• Renewal date für die nächste Ausgabe von Credits
• Registerkarte Usage History mit Aufschlüsselung auf Meter-Ebene, einschließlich verbrauchter Einheiten, Schwellenwerten, Stückpreisen und Gesamtkosten

​

Transaktionsdetails

​

Credits verwalten

​

Dashboard-Ansichten

​

Liste der Credit-Berechtigungen

​

Credit-Details eines Kunden

• Credit Selector – Wechsel zwischen verschiedenen Credit-Berechtigungen
• Available Balance – Aktuelles Guthaben in großer, prominenter Darstellung
• Apply Credit/Debit – Schaltfläche zum manuellen Anpassen des Guthabens des Kunden
• Recent Transactions – Vollständiges Ledger mit Datum, Transaktions-ID, Typ, Betrag und laufendem Guthaben

​

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: 'pdt_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 }
  }]
});

​

Beispiele aus der Praxis

​

Best Practices

• Einfach beginnen: Beginnen Sie mit einem einzigen Credit-Typ und ohne Übertragung. Fügen Sie abhängig vom Kundenfeedback und den Nutzungsmustern weitere Komplexität hinzu.
• Klare Erwartungen schaffen: Zeigen Sie Credit-Kontingente, verbleibende Guthaben und Preise für Überschreitungen prominent auf Ihren Produktseiten und im Customer Portal an.
• Bedeutungsvolle Einheiten verwenden: Benennen Sie Credits nach dem, was sie darstellen (zum Beispiel „API Calls“ oder „AI Tokens“), statt allgemeine Begriffe zu verwenden. Dies hilft Kunden, den Wert zu verstehen.
• Ablauf sorgfältig konfigurieren: Kurze Ablaufzeiträume (7 Tage) erhöhen die Dringlichkeit, können Kunden aber frustrieren. Längere Zeiträume (30–90 Tage) sind für die meisten SaaS-Produkte kundenfreundlicher.
• Niedrige Guthaben überwachen: Legen Sie Schwellenwerte für niedrige Guthaben fest, um Kunden vor dem Aufbrauchen zu benachrichtigen und unerwartete Überschreitungsgebühren zu reduzieren.
• Im Testmodus testen: Erstellen Sie Credits, verknüpfen Sie sie mit Testprodukten und simulieren Sie den vollständigen Zyklus aus Kauf → Nutzung → Abzug → Ablauf, bevor Sie live gehen.