Nutzungsbasierte Abrechnung einrichten
Notiz
Wir haben unseren nutzungsbasierten Abrechnungsprozess aktualisiert. Informationen zu unseren vorherigen Richtlinien finden Sie in unserer ältere Dokumentation für nutzungsbasierte Abrechnung.
In diesem Leitfaden wird das Grundkonzept eines nutzungsbasierten Abrechnungsmodells aus der Perspektive eines fiktiven Gen AI-Unternehmens namens Alpaca AI erläutert. Alpaca AI berechnet seinen Nutzerinnen und Nutzern 0,04 USD pro 1.000 genutzten Token, wobei die Abrechnung am Monatsende rückwirkend erfolgt.
- Zählerereignisse: Sie senden kundenspezifische Informationen, die durch Zählerereignisse dargestellt werden, an Stripe. Diese Ereignisse stellen alle Aktivitäten dar, die eine Kundin/ein Kunde in Ihrem System durchgeführt hat und bilden die Grundlage für die Rechnung. In unserem Beispiel bezieht sich dies auf die Anzahl der Token, die die Kundin/der Kunde in einer Abfrage verwendet.
- Zähler: Zähler sind Konfigurationsobjekte für Zählerereignisse. Mit Richtlinien wird klargestellt, wie die Zählerereignisse über den Abrechnungszeitraum hinweg zusammengefasst werden sollen. In diesem Fall wird die Summe der Token im Laufe eines Monats gezählt. Zähler können mit Preisen verknüpft werden, wodurch die kundenseitige Nutzung zu den Kundenabonnements zugeordnet werden kann.
- Zählerereignisübersicht: Die Ereignisübersicht für eine Kundin/einen Kunden und einen Zähler gibt die zusammengefasste Nutzung für einen Zeitraum zurück (der Zähler legt die Gruppierungsformel fest). In unserem Beispiel gibt die Zählerereignisübersicht die Summe() der Token für eine bestimmte Kundin, einen bestimmen Zähler und ein bestimmtes Zeitfenster zurück. Zählerereignisse sind im Lesepfad nicht verfügbar und werden asynchron zu den Ereignissen der Zählerereignisübersicht zusammengefasst.
- Preise: Preise definieren die Stückkosten, die Währung und den Abrechnungszyklus. In unserem Beispiel definieren Sie einen Paketpreis von 0,04 USD für 1.000 Token, der monatlich abgerechnet wird. Erfahren Sie mehr über Preise).
- Abonnement: Mit Abonnements können Sie wiederkehrende Zahlungen abbuchen, indem Sie einer Nutzerin/einem Nutzer einen bestimmten Preis zuordnen. Erfahren Sie mehr über Abonnements.
Dieses Diagramm veranschaulicht die Grundkonzepte:
Was Sie entwickeln werden
Dieser Leitfaden bietet Informationen zu den folgenden Vorgehensweisen:
- Modellieren Sie Ihr Unternehmen, indem Sie einen Billing-Zähler und einen Produktkatalog erstellen
- Zahlungseinzugssitzung zu Ihrer Seite hinzufügen
- Abonnementereignisse überwachen
Stripe einrichten
Installieren Sie den Stripe-Client Ihrer Wahl:
Installieren Sie als nächstes die Stripe-CLI. Mit der Stripe-CLI können Sie Webhooks testen und Stripe-APIs aufrufen. In einem späteren Abschnitt dieses Leitfadens wird erklärt, wie Sie mithilfe der CLI ein Preismodell einrichten können.
Weitere Installationsoptionen finden Sie unter Mit der Stripe-CLI loslegen.
Zähler erstellen
Erstellen Sie den Zähler im Dashboard oder mit der API. Sie können den Zähler im nächsten Schritt über die Seite „Produkte und Preise“ erstellen.
Erfahren Sie mehr über das Konfigurieren von Zählern.
Preismodell erstellen
Erstellen Sie Ihre Produkte und deren Preise im Dashboard oder mit der Stripe API.
Kunde/Kundin erstellen
Sie müssen für jedes Abonnement eine/einen Kundin/Kunden erstellen. Erfassen Sie im Frontend Ihrer Anwendung alle von den Nutzerinnen/Nutzern benötigten Informationen und übergeben Sie diese ans Backend.
Erstellen Sie das Stripe Customer-Objekt auf dem Server.
Nutzungsbasierten Preis für den Kunden/die Kundin abonnieren
Abonnieren Sie im Backend den nutzungsbasierten Preis für den Kunden/die Kundin.
Dadurch wird ein Abonnementobjekt mit einem SetupIntent zurückgegeben, das Sie zum Erfassen von Zahlungsinformationen benötigen.
Zahlungsinformationen erfassen
Erfahren Sie, wie Sie mit dem in der Antwort zum Erstellen des Abonnements enthaltenen Client-Geheimnis Zahlungsdetails erfassen können.
Nutzung melden
Sie können die Nutzung anhand des Zählers für die Kundin/den Kunden mit Zählerereignissen aufzeichnen. Geben Sie die Kundenreferenz und den Wert in der Nutzlast an. Stripe stellt der Kundin/dem Kunden die gemeldete Nutzung am Ende des Abrechnungszeitraums in Rechnung.
Erfahren Sie mehr über die Nutzungsaufzeichnung.