Kreditbasiertes Preismodell einrichten

Von Kunden vorbestellte Gutschriften abbuchen

Mit Gutschriften können Sie einen festen Geldbetrag für die Nutzung Ihrer nutzungsbasierten Produkte anbieten. Dieses Modell eignet sich gut, wenn Sie Ihren Kundinnen und Kunden im Voraus Planbarkeit bieten und gleichzeitig den Umsatz direkt an der Nutzung ausrichten möchten. Wenn Sie beispielsweise eine API verkaufen, die Bilder und Cloud-Speicher verarbeitet, können Kund/innen zu Beginn des Monats Gutschriften in 100 USD kaufen. Sie können den Geldbetrag für eine beliebige Kombination aus API-Nutzung und Cloud-Speichernutzung ausgeben und am Ende des Monats einen Zuschlag für beide Dienste zahlen, wenn ihre Nutzung 100 USD übersteigt.

Gutschriften gelten unterschiedslos für alle Zähler. Um spezifische Grenzwerte für Ihre verschiedenen verbrauchsbasierten Produkte festzulegen (z. B. 100 API-Anfragen und 3 GB Speicherplatz), verwenden Sie das Modell mit pauschaler Transaktionsgebühr und Überschreitungsgebühr.

Sie werden Folgendes entwickeln

In diesem Leitfaden erstellen Sie das folgende Abo für das fiktive Unternehmen Hypernian, das LLM-Dienste anbietet. Es berechnet Kundinnen und Kunden die folgenden Preise:

Gutschriften	Gebühr
Pro Nutzer/in	10 USD

Nutzung	Gebühr
Eingabe-Token	0.03 USD pro Token
Ausgabe-Token	0.05 USD pro Token

Zähler erstellen

Zähler legen fest, wie Zählerereignisse über einen Rechnungsstellungszeitraum aggregiert werden. Zählerereignisse repräsentieren alle Aktionen, die Kund/innen in Ihrem System ausführen (z. B. API-Anfragen). Zähler sind an Preise gekoppelt und bilden die Grundlage für die Abrechnung.

Beim Hypernian-Beispiel sind Zählerereignisse die Anzahl der Input- und Output-Token, die ein/e Kund/in in einer Abfrage verwendet. Der Zählerstand entspricht der Summe der Token über einen Monat. In diesem Beispiel erstellen Sie für jeden Token-Typ einen Zähler.

Sie können das Stripe Dashboard oder die API zum Konfigurieren eines Zählers verwenden. Um die API mit der Stripe CLI zum Erstellen eines Zählers zu verwenden, starten Sie mit der Stripe CLI.

Klicken Sie auf der Seite Zähler auf Zähler erstellen.
Gehen Sie auf der Seite Zähler erstellen wie folgt vor:
- Geben Sie für Zählername den Namen des Zählers ein, der angezeigt wird und für organisatorische Zwecke dient. Für das Hypernian-Beispiel geben Sie „Hypernian-Input-Token“ ein.
- Geben Sie für Ereignisname den Namen ein, der in Zählerereignissen angezeigt werden soll, wenn die Nutzung an Stripe gemeldet wird. Für das Hypernian-Beispiel geben Sie „hypernian_input_tokens“ ein.
- Legen Sie die Aggregationsmethode im Dropdown-Menü fest:
  - Wählen Sie im Hypernian-Beispiel Summe aus. Dadurch werden die gemeldeten Werte addiert (in diesem Beispiel die Anzahl der von einer Kundin oder einem Kunden verwendeten Token), um die abrechenbare Nutzung zu ermitteln.
  - Wählen Sie Anzahl, um Ereignisse auf Grundlage der gemeldeten Anzahl abzurechnen.
  - Wählen Sie Zuletzt für die auf dem letzten gemeldeten Wert basierende Rechnung.
  - Verwenden Sie den Vorschaubereich , um beispielhafte Nutzungsereignisse festzulegen und die Aggregationsmethode zu verifizieren.
- Klicken Sie auf Zähler erstellen.
- Um einen Zähler für Output-Token zu erstellen, wiederholen Sie die vorherigen Schritte und legen Sie den Zählernamen auf „Hypernian-Output-Token“ und den Ereignisnamen auf „hypernian_output_tokens“ fest.
- (Optional) Geben Sie unter Erweiterte Einstellungen die Dimensionen an, mit denen Sie Ihre Nutzungsdaten kennzeichnen möchten. Um granulare, segmentspezifische Warnungen zu generieren oder die Nutzung auf der Grundlage einer Kombination von Attributen zu bewerten, übermitteln Sie Ihre Nutzungsdaten mit Dimensionen, die für Analysen und Berichte ausgefüllt werden. Einige Beispiel-Dimensionen sind LLM-Modell, Token-Typ, Region und Ereignistyp.

Preismodell erstellen

Verwenden Sie das Stripe-Dashboard oder die API, um ein Preismodell zu erstellen, das Ihre Produkte und deren Preisoptionen umfasst. Preise legen die Stückkosten, die Währung und den Rechnungsstellungszeitraum fest.

Für das Hypernian-Beispiel erstellen Sie zwei Produkte mit jeweils einem Zähler mit monatlicher Abrechnung. Verwenden Sie den Zähler, den Sie im vorherigen Schritt erstellt haben.

Klicken Sie auf der Seite Product Catalog auf Produkt erstellen.
Gehen Sie auf der Seite Produkt hinzufügen wie folgt vor:
- Geben Sie bei Name den Namen Ihres Produkts ein. Geben Sie für das Hypernian-Beispiel Hypernian ein.
- (Optional) Fügen Sie als Beschreibung eine Beschreibung hinzu, die im Bezahlvorgang, im Kundenportal und in Angeboten angezeigt wird.
- Wählen Sie Wiederkehrend aus.
- Wählen Sie unter Rechnungsstellungszeitraum die Option Weitere Preisoptionen aus.
Gehen Sie auf der Seite Preis hinzufügen wie folgt vor:
- Wählen Sie unter Preismodell auswählen die Optionen Nutzungsbasiert aus.
- Wählen Sie Ihre Preisstruktur:
  - Wählen Sie im Hypernian-Beispiel Pro Einheit aus. Legen Sie unter Preis den Betrag auf 0,03 USD fest.
  - Wählen Sie unter Zähler das von Ihnen erstellten Zähler aus und wählen Sie Hypernian-Input-Token aus dem Dropdown-Menü.
  - Wählen Sie unter Rechnungsstellungszeitraum die Option Monatlich aus.
- Wählen Sie unter Zähler den von Ihnen erstellten Zähler aus. Wählen Sie im Hypernian-Beispiel Hypernian-Input-Token aus dem Dropdown-Menü.
- Wählen Sie den entsprechenden Rechnungsstellungszeitraum aus. Wählen Sie für das Hypernian-Beispiel Monatlich.
- Klicken Sie auf Weiter.
Wiederholen Sie die vorherigen Schritte und erstellen Sie ein Produkt mit der Bezeichnung „Hypernian-Output-Nutzung“ mit einem Preis von 0,05 USD. Hängen Sie es mit demselben monatlichen Rechnungsstellungszeitraum an den Hypernian-Output-Token-Zähler an.

Kundin/Kunden erstellen

Erstellen Sie als Nächstes eine/n Kunden/Kundin.

Klicken Sie auf der Kundenseite auf Kund/in hinzufügen.
Gehen Sie auf der Seite Kunden/Kundin erstellen wie folgt vor:
- Geben Sie für Name den Namen Ihres Kunden oder Ihrer Kundin ein. Für das Hypernian-Beispiel geben Sie Jenny Rosen ein.
- (Optional) Fügen Sie eine E-Mail-Adresse und eine Beschreibung für Ihre/n Kund/in hinzu.
- Klicken Sie auf Kunden/Kundin hinzufügen.

Ihrem Kunden/Ihrer Kundin Abrechnungsgutschriften gewähren

Verwenden Sie das Stripe-Dashboard oder die API, um eine Gutschriftgewährung für Ihre/n Kund/in zu erstellen.

Gutschriften werden am Ende des Abrechnungszeitraums mit zu zahlenden Beträgen verrechnet

Bei dieser Version der nutzungsbasierten Abrechnung werden Gutschriften verrechnet, wenn die Rechnung am Ende des Abrechnungszeitraums erstellt wird. Mit der erweiterten nutzungsbasierten Abrechnung, die sich derzeit in der privaten Vorschau befindet, können Sie die Gewährung von Gutschriften einrichten, die in Echtzeit verrechnet werden. Registrieren Sie sich für die private Vorschau, um Zugriff zu erhalten und mehr zu erfahren.

Abrechnungsgutschriften gelten nur für Posten im Abo, die mit einem Zählerpreis verknüpft sind. Die Usage Records API wird nicht unterstützt.

Wählen Sie auf der Kundenseite den Kundennamen aus.
Klicken Sie auf der Kundenseite unter Gutschriftgewährungen auf das Plus (+).
Gehen Sie auf der Seite Neue Gutschriftgewährung wie folgt vor:

Geben Sie unter Name einen Namen für Ihre Gutschriftgewährung ein.
Geben Sie unter Betrag den Betrag der Gutschriftgewährung an. Geben Sie für das Hypernian-Beispiel 10 ein.
(Optional) Geben Sie unter Datum des Inkrafttretens das Datum an, an dem die Gutschrift gewährt werden soll.
(Optional) Geben Sie unter Ablaufdatum gegebenenfalls das Datum an, an dem die Gutschriften ablaufen.
(Optional) Geben Sie unter Priorität die Priorität für diese Gutschriftgewährung an.
(Optional) Geben Sie unter Anspruch eine Liste der nutzungsbasierten Preise an, für die diese Gutschrift gewährt wird.
Klicken Sie auf Gewährung erstellen.

Abo erstellen

Mit Abos können Sie wiederkehrende Beträge berechnen, indem Sie Kund/innen bestimmte Preise zuweisen.

Verwenden Sie das Stripe Dashboard oder die API, um ein Abo zu erstellen, das den/die Kund/in, das Produkt und den nutzungsbasierten Preis umfasst.

Im Hypernian-Beispiel erstellen Sie ein Abo für die Produkte Hypernian-Input-Token und Hypernian-Output-Token, das monatlich an Jenny Rosen abgerechnet wird.

Hinweis

Sie können einen einzelnen Zählerpreis mit einem oder mehreren Abos verknüpfen.

Wenn Sie ein billing_mode=flexible-Abo erstellen, schließt Stripe nutzungsbasierte Rechnungsposten von der ersten Rechnung aus, da keine vorherige Nutzung zur Abrechnung vorliegt. Stripe erstellt eine Rechnung nur, wenn das Abo mit der zuvor aufgelaufenen Nutzung rückdatiert wird oder ausstehende Rechnungen vorhanden sind. Wenn Sie ein billing_mode=classic-Abo erstellen, generiert Stripe für jeden nutzungsbasierten Posten einen Rechnungsposten ohne Geldwert.

Klicken Sie auf der Seite Abos auf Test-Abo erstellen.
Gehen Sie auf der Seite Testabo erstellen wie folgt vor:
- Wählen Sie unter Kundin/Kunde den Namen Ihres Kunden oder Ihrer Kundin aus. Wählen Sie im Hypernian-Beispiel John Doe.
- Unter Produkt wählen Sie Ihre Preise aus. Im Hypernian-Beispiel wählen Sie den Preis unter Hypernian-Input-Nutzung und Hypernian-Output-Nutzung.
- (Optional) Ändern Sie die Abodetails und -einstellungen nach Bedarf.
- Klicken Sie auf Testabo erstellen.

Test-Zählerereignis senden

Verwenden Sie Zählerereignisse zur Aufzeichnung der Kundennutzung für Ihren Zähler. Am Ende des Rechnungsstellungszeitraums stellt Stripe die gemeldete Nutzung in Rechnung.

Sie können Ihre nutzungsbasierte Abrechnung testen, indem Sie ein Zählerereignis über das Stripe-Dashboard oder die API senden. Wenn Sie die API verwenden, geben Sie die Kunden-ID und den Wert für die payload an.

Nachdem Sie Zählerereignisse gesendet haben, können Sie die Nutzungsdetails für Ihren Zähler auf der Seite Zähler im Dashboard anzeigen.

Wählen Sie auf der Seite Zähler den Namen des Zählers aus. Wählen Sie im Hypernian-Beispiel Hypernian-Input-Token.
Klicken Sie auf der Seite des Zählers auf Nutzung hinzufügen > Nutzung manuell eingeben.
Gehen Sie auf der Seite Nutzung hinzufügen wie folgt vor:
- Wählen Sie Ihren Kunden/Ihre Kundin aus der Dropdown-Liste Kunde/Kundin aus.
- Geben Sie für Wert einen Beispielwert ein. Geben Sie für das Hypernian-Beispiel 3000 ein.
- Klicken Sie auf Absenden.

Erstellen Sie eine Rechnungsvorschau

Erstellen Sie eine Rechnungsvorschau, um eine Vorschau einer Kundenrechnung zu sehen, die Details wie Zählerpreis und Nutzungsmenge enthält.

Wählen Sie auf der Seite Abonnements ein Abo aus. Wählen Sie im Hypernian-Beispiel das Abo für Jenny Rosen.
Scrollen Sie auf der Seite mit den Abonnementdetails nach unten zum Abschnitt Anstehende Rechnung. In der Vorschau der Rechnung wird der Abonnementbetrag angezeigt, der dem Kunden/der Kundin zum angegebenen Datum in Rechnung gestellt werden soll.
Klicken Sie auf Vollständige Rechnung anzeigen, um die vollständigen Details für die anstehende Rechnung anzuzeigen, einschließlich:
- Kunde/Kundin
- Abrechnungsmethode
- Erstellungsdatum
- Verbundenes Abo
- Abo-Details (Verbrauchsmenge und Zählerpreis)
- Fälliger Betrag
Stripe verarbeitet Zählerereignisse asynchron, sodass anstehende Rechnungen möglicherweise kürzlich empfangene Zählerereignisse nicht sofort widerspiegeln.

Abrechnungsgutschriften auf Rechnungen anwenden

Nachdem die Rechnung finalisiert wurde, wendet Stripe automatisch alle anwendbaren Abrechnung an. Das verfügbare Guthaben für die Gutschriftgewährung wird basierend auf der Höhe der auf die Rechnung angewendeten Abrechnungsgutschriften aktualisiert.

Den Betrag der auf eine Rechnung angewendeten Abrechnungsgutschriften finden Sie im Stripe Dashboard.

Wählen Sie auf der Kundenseite den Kundennamen aus.
Wählen Sie auf der Kundenseite unter Rechnungen eine Rechnung aus.
Suchen Sie auf der Rechnungsseite unter Zwischensumme die Zeile Angewendete Gutschriften.

Verfügbare Abrechnungsgutschrift abrufen

Verwenden Sie das Stripe-Dashboard oder die API, um das verfügbare Abrechnungsguthaben eines Kunden/einer Kundin anzuzeigen. Wenn Sie die API verwenden, rufen Sie den Endpoint Guthabenübersicht ab.

Wählen Sie auf der Kundenseite den Kundennamen aus.
Auf der Kundenseite finden Sie unter Gutschriftgewährungen eine Liste der gewährten Gutschriften, die auf Rechnungen angerechnet werden können. Sie können das available_balance der Gutschriftgewährung in der Spalte Verfügbar einsehen.

Transaktionen für eine Gutschriftgewährung auflisten

Verwenden Sie das Stripe-Dashboard oder die API, um die Transaktionen für eine bestimmte Gutschriftgewährung oder einen bestimmten Kunden/eine bestimmte Kundin anzuzeigen. Rufen Sie bei Verwendung der API den Endpoint Guthabentransaktion auf.

Wählen Sie auf der Kundenseite den Kundennamen aus.
Wählen Sie auf der Kundenseite unter Gutschriftgewährungen eine Gutschriftgewährung aus.
Details zu den Guthabentransaktionen anzeigen.

OptionalFinanzierung der gewährten Gutschrift

Verwenden Sie das Stripe Dashboard oder die API, um eine einmalige Rechnung zu erstellen, um Zahlungen von einer Kundin/einem Kunden einzuziehen. Überwachen Sie bei Verwendung der API den invoice.paid-Webhook und gewähren Sie Ihrer Kundin/Ihrem Kunden Abrechnungsgutschriften.

Wählen Sie auf der Kundenseite den Kundennamen aus.
Klicken Sie auf der Kundenseite auf Rechnung erstellen.
Befolgen Sie die Anweisungen zum Erstellen einer Rechnung.

OptionalRufen Sie die Nutzung für einen spezifischen Zeitraum ab

Verwenden Sie die Zählerereignisübersicht, um die Nutzung für einen benutzerdefinierten Zeitraum abzurufen. Die Zählerereignisübersicht gibt die zusammengefasste Nutzung eines Kunden/einer Kundin für einen Zeitraum zurück, der auf der vom Zähler definierten Aggregationsformel basiert.

Im Hypernian-Beispiel gibt die Zählerereignis-Zusammenfassung die Summe der Tokens für eine bestimmte Kundin oder einen bestimmten Kunden, einen bestimmten Zähler und ein bestimmtes Zeitfenster zurück.

Da Stripe Zählerereignisse asynchron verarbeitet, spiegeln anstehende Rechnungen möglicherweise kürzlich empfangene Zählerereignisse nicht sofort wider.