# Richten Sie ein Pay-as-you-go-Preismodell ein. Stellen Sie Ihren Kundinnen und Kunden Rechnungen auf Grundlage ihrer Nutzung Ihres Produkts oder Ihrer Dienstleistung. Pay-as-you-go ist ein flexibles, skalierbares Modell, mit dem Sie Ihren Kundinnen und Kunden ihre jeweilige Nutzung nachträglich in Rechnung stellen können. KI-Unternehmen, SaaS-Plattformen und Cloud-Dienste verwenden dieses Preismodell häufig. > #### Nicht empfohlen > > Dieser Leitfaden behandelt die grundlegende nutzungsbasierte Abrechnung mit Billing Meters. Sofern Sie keine bestehende Billing-Meters-Integration betreiben, verwenden Sie stattdessen [Metronome](https://docs.stripe.com/billing/usage-based.md), die primäre Plattform von Stripe für die nutzungsbasierte Abrechnung. > > Wenn Sie bereits Billing Meters verwenden, müssen Sie nicht migrieren. Verwenden Sie diesen Leitfaden weiterhin für Ihre bestehende Integration. ## Bevor Sie beginnen: Verwenden Sie Metronome für neue Integrationen Dieser Leitfaden implementiert die nutzungsbasierte Abrechnung (Pay-as-you-go) mithilfe der Billing Meters API. Sofern Sie keine bestehende Billing-Meters-Integration betreiben, verwenden Sie stattdessen [Metronome](https://docs.stripe.com/billing/usage-based.md). Das gilt für Folgendes: - Das Starten einer neuen nutzungsbasierten Abrechnungsintegration von Grund auf - Das Hinzufügen nutzungsbasierter Preise zu bestehenden Pauschalabonnements – wenn Sie derzeit reguläre Stripe-Abonnements haben und die Nutzungsmessung hinzufügen möchten, ist Metronome ein besserer Ausgangspunkt als dieser Leitfaden - Jede Integration, die möglicherweise Prepaid-Guthaben, Unternehmensverträge, dimensionale Preisgestaltung oder Nutzungssichtbarkeit in Echtzeit erfordert Metronome ist die primäre Plattform von Stripe für die nutzungsbasierte Abrechnung. Sie übernimmt die Ereigniserfassung, Nutzungsmessung, Bewertung und Rechnungsgenerierung über eine speziell entwickelte Abrechnungs-Engine und lässt sich für Zahlungseinzug und Steuerzwecke in Stripe integrieren. Gegenüber der direkten Entwicklung mit Billing Meters bietet Metronome zusätzlich Folgendes: - Nutzungssichtbarkeit in Echtzeit (Billing Meters wird nur zum Zeitpunkt der Rechnungsstellung aktualisiert) - Prepaid-Guthaben und Guthabenabzug - Unternehmensverträge mit Commits, Mindestbeträgen und Ramp-up-Plänen - Dimensionale und zusammengesetzte Preiskonfigurationen - Erfassung großer Ereignisvolumen in großem Maßstab Der in diesem Leitfaden enthaltene Billing-Meters-Ansatz in diesem Leitfaden ist nur angemessen, wenn Sie Kundinnen und Kunden schon heute Rechnungen über Billing Meters stellen und über eine unkomplizierte Pay-as-you-go-Preisgestaltung verfügen, die nicht komplexer wird. Lesen Sie [Grundlegende nutzungsbasierte Abrechnung und Metronome im Vergleich](https://docs.stripe.com/billing/subscriptions/usage-based/compare-metronome.md), um beide Optionen zu bewerten. ## Sie werden Folgendes entwickeln In diesem Leitfaden wird beschrieben, wie Sie die nutzungsbasierte Preisgestaltung (Pay-as-you-go) auf Stripe für ein fiktives Unternehmen namens Hypernian implementieren. Hypernian berechnet seinen Kundinnen und Kunden die folgenden Preise für seine LLM-Modelle: | Nutzung | Gebühr | | --- | --- | | Token | 0.04 USD pro 100 Token | Um dieses Preismodell zu implementieren, erstellen Sie einen Zähler, richten Sie Preise und Abrechnung ein und senden Sie Zählerereignisse, um die Nutzung von Kund/innen unter Verwendung von [Produkten](https://docs.stripe.com/api/products.md) und [Preisen](https://docs.stripe.com/api/prices.md) aufzuzeichnen. ## Zähler erstellen Zähler geben an, wie Zählerereignisse über einen Abrechnungszeitraum hinweg zusammengefasst werden. Zählerereignisse stellen alle Aktionen dar, die Kundinnen/Kunden in Ihrem System durchführen (beispielsweise API-Anfragen). Zähler sind an Preise gebunden und bilden die Grundlage für das, was in Rechnung gestellt wird. Für das Hypernian-Beispiel sind Zählerereignisse die Anzahl der Token, die ein Kunde/eine Kundin in einer Abfrage verwendet. Der Zähler ist die Summe der Token über einen Monat. Sie können das Stripe Dashboard oder die API verwenden, um einen Zähler zu konfigurieren. Um die API mit der Stripe CLI zum Erstellen eines Zählers zu verwenden, [starten sie mit der Stripe CLI](https://docs.stripe.com/stripe-cli.md). #### Dashboard 1. Klicken Sie auf der Seite [Zähler](https://dashboard.stripe.com/test/meters) auf **Zähler erstellen**. 2. Im Zähler-Editor: - 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-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_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**. #### API ```curl curl https://api.stripe.com/v1/billing/meters \ -u "<>:" \ -d "display_name=Hypernian tokens" \ -d event_name=hypernian_tokens \ -d "default_aggregation[formula]=sum" \ -d "customer_mapping[event_payload_key]=stripe_customer_id" \ -d "customer_mapping[type]=by_id" \ -d "value_settings[event_payload_key]=value" ``` ## Preismodell erstellen Verwenden Sie das Stripe-Dashboard oder die API, um ein [Preismodell](https://docs.stripe.com/products-prices/pricing-models.md) zu erstellen, das Ihre [Produkte](https://docs.stripe.com/api/products.md) und deren Preisoptionen umfasst. [Preise](https://docs.stripe.com/api/prices.md) legen die Stückkosten, die Währung und den Rechnungsstellungszeitraum fest. Für das Hypernian-Beispiel erstellen Sie ein Produkt mit einem zählerverknüpften Preis von 0,04 USD pro hundert Einheiten, das in einem monatlichen Intervall abgerechnet wird. Sie verwenden den Zähler, das Sie im vorherigen Schritt erstellt haben. #### Dashboard 1. Klicken Sie auf der Seite [Product Catalog](https://dashboard.stripe.com/products?active=true) auf **Produkt erstellen**. 2. 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](https://docs.stripe.com/payments/checkout.md), im [Kundenportal](https://docs.stripe.com/customer-management.md) und in [Angeboten](https://docs.stripe.com/quotes.md) angezeigt wird. - Wählen Sie **Wiederkehrend** aus. - Wählen Sie unter **Rechnungsstellungszeitraum** die Option **Weitere Preisoptionen** aus. 3. Gehen Sie auf der Seite **Preis hinzufügen** wie folgt vor: - Wählen Sie unter **Preismodell auswählen** die Option **Nutzungsbasiert** aus. - Wählen Sie Ihre Preisstruktur: - Wählen Sie für das Hypernian-Beispiel die Option **Pro Paket** aus. Legen Sie unter **Preis** den **Betrag** auf `0,04 USD` pro `100` Einheiten. - Wählen Sie **Pro Einheit** aus, um den Preis nach Anzahl der Nutzer/innen, Einheiten oder Plätze zu ermitteln. - Wählen Sie **Pro Stufe** aus, um die [gestaffelte Preisgestaltung](https://docs.stripe.com/products-prices/pricing-models.md#tiered-pricing) zu aktivieren und die Stückkosten je nach Menge oder Nutzung zu ändern. - Wählen Sie unter **Zähler** den Zähler aus, den Sie in Schritt 1 erstellt haben. Wählen Sie im Hypernian-Beispiel **Hypernian-Tokens** aus dem Dropdown-Menü. - Wählen Sie den entsprechenden **Rechnungsstellungszeitraum** aus. Wählen Sie für das Hypernian-Beispiel **Monatlich**. - Klicken Sie auf **Weiter**. 4. Klicken Sie auf der Seite **Ein Produkt hinzufügen** auf **Produkt hinzufügen**. #### API Sie können Ihre Zähler-ID auf der Detailseite für Zähler finden. ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d currency=usd \ -d unit_amount=4 \ -d billing_scheme=per_unit \ -d "transform_quantity[divide_by]=100" \ -d "transform_quantity[round]=up" \ -d "recurring[usage_type]=metered" \ -d "recurring[interval]=month" \ -d "recurring[meter]={{METER_ID}}" \ -d "product_data[name]=Hypernian tokens" ``` ## Kundin/Kunden erstellen Erstellen Sie als Nächstes eine Kundin oder einen Kunden. #### Dashboard 1. Klicken Sie auf der [Kundenseite](https://dashboard.stripe.com/test/customers) auf **Kund/in hinzufügen**. 2. 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 `John Doe` 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**. #### API > #### Verwenden Sie die Accounts v2 API zum Darstellen von Kundinnen und Kunden > > Die Accounts v2 API ist allgemein für Connect-Nutzer/innen verfügbar und für andere Stripe-Nutzer/innen in der öffentlichen Vorschau. Wenn Sie an der Accounts v2 Vorschau teilnehmen, müssen Sie eine [Vorschauversion](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning) in Ihrem Code angeben. > > Um der Vorschau von Accounts v2 beizutreten, gehen Sie zu [Kontovorschauen und -funktionen](https://dashboard.stripe.com/settings/previews) in Ihrem Dashboard und aktivieren Sie **wiederverwendbare Zahlungsmethoden für Global Payouts**. > > Für die meisten Anwendungsfälle empfehlen wir, [Ihre Kundinnen und Kunden als vom Kunden bzw. von der Kundin konfigurierte Account-Objekte abzubilden](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), anstatt [Customer](https://docs.stripe.com/api/customers.md)-Objekte zu verwenden. Erstellen Sie ein kundenkonfiguriertes [Konto](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer) oder [einen Kunden/eine Kundin](https://docs.stripe.com/api/customers/create.md), wenn Ihr Kunde/Ihre Kundin ein Konto bei Ihrem Unternehmen anlegt oder wenn er/sie eine Zahlungsmethode speichert. Verknüpfen Sie die ID des Objekts mit Ihrer eigenen internen Darstellung eines Kunden/einer Kundin. Erstellen Sie einen neuen Kunden/eine neue Kundin oder rufen Sie einen bestehenden Kunden/eine bestehende Kundin ab, um ihn/sie mit dieser Zahlung zu verknüpfen. #### Accounts v2 ```curl curl -X POST https://api.stripe.com/v2/core/accounts \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-07-29.preview" \ --json '{ "contact_email": "jenny.rosen@example.com", "display_name": "Jenny Rosen", "configuration": { "customer": {} }, "include": [ "configuration.customer" ] }' ``` #### Customers v1 ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ -d "name=Jenny Rosen" \ --data-urlencode "email=jenny.rosen@example.com" ``` ## Abo erstellen Mit [Abos](https://docs.stripe.com/api/subscriptions.md) 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. Für das Hypernian-Beispiel erstellen Sie ein Abo für das Hypernian-Produkt mit einem nutzungsbasierten Preis von 0,04 USD pro 100 Einheiten, das monatlich an John Doe abgerechnet wird. > 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. #### Dashboard 1. Klicken Sie auf der Seite [Abos](https://dashboard.stripe.com/test/subscriptions) auf **Test-Abo erstellen**. 2. 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**. - Wählen Sie unter **Produkt** Ihren Preis aus. Wählen Sie im Hypernian-Beispiel den Preis unter **Hypernian**. - (Optional) Ändern Sie die Abodetails und -einstellungen nach Bedarf. - Klicken Sie auf **Testabo erstellen**. #### API Sie können Ihre Kunden-ID auf der Seite mit den Kundendetails finden. Um Ihre Preis-ID zu finden, gehen Sie auf die Seite mit den Produktdetails und klicken Sie unter **Preisgestaltung** auf das Überlaufmenü (⋯. Wählen Sie **Preis-ID kopieren**. #### Accounts v2 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "items[0][price]={{PRICE_ID}}" ``` #### Customers v1 ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][price]={{PRICE_ID}}" ``` ## Test-Zählerereignis senden Verwenden Sie [Zählerereignisse](https://docs.stripe.com/api/billing/meter-event.md) zur [Aufzeichnung der Kundennutzung](https://docs.stripe.com/billing/subscriptions/usage-based/recording-usage.md) 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](https://dashboard.stripe.com/test/meters) im Dashboard anzeigen. #### Dashboard 1. Wählen Sie auf der Seite [Zähler](https://dashboard.stripe.com/test/meters) den Namen des Zählers aus. Wählen Sie im Hypernian-Beispiel **Hypernian-Token**. 2. Klicken Sie auf der Seite des Zählers auf **Nutzung hinzufügen** > **Nutzung manuell eingeben**. 3. 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**. #### API ```curl curl https://api.stripe.com/v1/billing/meter_events \ -u "<>:" \ -d event_name=hypernian_tokens \ -d "payload[stripe_customer_id]={{CUSTOMER_ID}}" \ -d "payload[value]=25" ``` ## Erstellen Sie eine Rechnungsvorschau [Erstellen Sie eine Rechnungsvorschau](https://docs.stripe.com/api/invoices/create_preview.md), um eine Vorschau einer Kundenrechnung zu sehen, die Details wie Zählerpreis und Nutzungsmenge enthält. #### Dashboard 1. Wählen Sie auf der Seite [Abonnements](https://dashboard.stripe.com/test/subscriptions) ein Abo aus. Wählen Sie im Hypernian-Beispiel das Abo für **John Doe**. 2. 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. 3. 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. #### API ```curl curl https://api.stripe.com/v1/invoices/create_preview \ -u "<>:" \ -d "subscription={{SUBSCRIPTION_ID}}" ``` ## Optional: Rufen Sie die Nutzung für einen spezifischen Zeitraum ab Verwenden Sie die [Zählerereignis-Zusammenfassung](https://docs.stripe.com/api/billing/meter-event-summary.md), um die Gesamtnutzung für einen nutzerdefinierten Zeitraum abzurufen. Die Zählerereignis-Zusammenfassung gibt die aggregierte Nutzung einer Kundin/eines Kunden für einen Zeitraum zurück, basierend auf der vom Zähler definierten Aggregationsformel. Wenn Sie Ihre Kundinnen und Kunden als kundenkonfigurierte [Konten](https://docs.stripe.com/api/v2/core/accounts/object.md) abbilden, übergeben Sie die `Account`-ID an den `customer`-Parameter. 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. ```curl curl -G https://api.stripe.com/v1/billing/meters/{{METER_ID}}/event_summaries \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d start_time=1717249380 \ -d end_time=1717249440 ``` ## Nächste Schritte - [Zahlungen mit Stripe Checkout annehmen](https://docs.stripe.com/payments/checkout.md) - [Warnungen und Schwellenwerte einrichten](https://docs.stripe.com/billing/subscriptions/usage-based/monitor.md) - [Abrechnungsguthaben einrichten](https://docs.stripe.com/billing/subscriptions/usage-based/billing-credits/implementation-guide.md) - [Starten Sie mit Metronome](https://docs.stripe.com/billing/usage-based.md), der von Stripe empfohlenen Plattform für neue Integrationen für nutzungsbasierten Abrechnung - [Grundlegende nutzungsbasierte Abrechnung und Metronome im Vergleich](https://docs.stripe.com/billing/subscriptions/usage-based/compare-metronome.md)