# Wie die erweiterte nutzungsbasierte Abrechnung funktioniert Führen Sie auf Stripe gängige nutzungsbasierte Preismodelle ein. Dank der erweiterten nutzungsbasierten Abrechnung können SaaS- und KI-Unternehmen ihren Kundinnen und Kunden die Kosten entsprechend der Nutzung in Rechnung stellen und gleichzeitig wiederkehrende Gebühren berechnen sowie Guthaben verwalten. Mit der erweiterten nutzungsbasierten Abrechnung können Sie: - Legen Sie Gebühren auf der Grundlage spezifischer Nutzungsattribute (Dimensionen) fest. - Verwalten Sie Dutzende bis Hunderte von Tarifen über einen oder mehrere Zähler - Gutschriftverrechnung in Echtzeit einrichten und Gutschriftvergabe automatisieren - Preisumstellungen verwalten Folgende Preismodelle werden beispielsweise unterstützt: - Pay-as-you-go - Pauschalgebühr und Überschreitungsgebühren - Echtzeit-Guthabenabrechnung mit Aufladungen (See full diagram at https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about) ## Konzepte der erweiterten nutzungsbasierten Abrechnung Hier sind die wichtigsten Konzepte, um zu verstehen, wie die erweiterte nutzungsbasierte Abrechnung funktioniert. | Laufzeit | Definition | | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Abrechenbarer Posten | Ein Posten, der auf einer Rechnung erscheint und einem Preisplan-Abonnement entspricht. Kann nutzungsbasiert (mit Zähler) oder lizenziert sein. | | [Lizenzgebühr](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#license-fee-concepts) | Eine feste, wiederkehrende Zahlung für einen abrechenbaren Posten, wie z. B. eine monatliche Transaktionsgebühr für Abos. Sie umfasst Details wie Preis, Billing und Steuerverhalten. Erfahren Sie mehr über [Lizenzgebühren](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#license-fee-concepts). | | Lizenzierter Posten | Ein abrechnungsfähiger Posten, der lizenziert ist und auf der an Ihre Kundin/Ihren Kunden gesendeten Rechnung erscheint. Sie übergeben die ID des lizenzierten Postens, wenn Sie die Lizenzgebühr erstellen. | | Zähler | [Zähler](https://docs.stripe.com/api/billing/meter.md) legen fest, wie [Zählerereignisse](https://docs.stripe.com/api/billing/meter-event.md) über ein Serviceintervall hinweg aggregiert werden. Zählerereignisse erfassen alle Aktionen, die Kundinnen und Kunden in Ihrem System ausführen (z. B. API-Anfragen). Gemessene Posten sind mit Zählern verknüpft und bilden die Grundlage für die Abrechnung. Ein Unternehmen, das KI-Dienste anbietet, könnte beispielsweise Zählerereignisse haben, die die Anzahl der Token darstellen, die ein Kunde/eine Kundin in einer Abfrage verwendet. Der Zähler summiert die Token über einen Monat hinweg. Die aggregierte Nutzung bildet die Grundlage für die Rechnungen, die für jedes Rechnungsintervall erstellt werden. Sie können im Stripe-Dashboard oder per API einen [Zähler konfigurieren](https://docs.stripe.com/billing/subscriptions/usage-based/meters/configure.md). | | Gezählter Posten | Ein abrechnungsfähiger Posten, der nutzungsbasiert ist, also gezählt wird. Sie können einen nutzungsbasierten Posten erstellen, um den spezifischen Posten darzustellen, für den die Kundin/der Kunde bezahlt, z. B. ein LLM-Modell oder eine Stufe der Tokennutzung. Sie können einen nutzungsbasierten Posten auf mehrere Listenpreise anwenden. Jeder nutzungsbasierte Posten muss mit einem Zähler verknüpft sein. | | [Preisplan](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#pricing-plan-concepts) | Ein anpassbarer Container mit Preiskomponenten (wie Preislisten, Lizenzgebühren und wiederkehrenden Gutschriften). Erfahren Sie mehr über [Preispläne](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#pricing-plan-concepts). | | [Preisplan-Abos](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#pricing-plan-subscription-concepts) | Ein Preisplan-Abo wird erstellt, wenn eine Kundin/ein Kunde eine bestimmte Preisplanversion abonniert hat. Erfahren Sie mehr über [Preisplan-Abos](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#pricing-plan-subscription-concepts). | | Tarif | Die Preiskonfiguration für einen nutzungsbasierten Artikel in einer Preiskarte. Erfahren Sie mehr über [Preiskarten und Preise](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#rate-card-concepts). | | [Preisliste](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#rate-card-concepts) | Eine Sammlung nutzungsbasierter Preise für ein Produkt. Erfahren Sie mehr über [Preislisten](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#rate-card-concepts). | | [Serviceaktion](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#service-action-concepts) | Definiert eine wiederkehrende Gutschrift und die entsprechenden abrechnungsfähigen Posten. Erfahren Sie mehr über [Serviceaktionen](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#service-action-concepts). | | Serviceintervall | Serviceintervalle definieren zwei Dinge: den Zeitraum für die Bewertung der Nutzung Ihres Dienstes im Vergleich zu Ihrem Preismodell und den Zeitpunkt, an dem Ihre Kundin/Ihr Kunde Zugriff auf den Dienst haben sollte. Wenn Sie Mengen- oder Staffelpreise konfiguriert haben (z. B. die ersten 100 Einheiten kostenlos), werden die Limits für jedes Serviceintervall zurückgesetzt. | ### Preisplan-Begriffe Mit Preisplänen können Sie eine Reihe von Preiskomponenten zu einem einzigen Paket zusammenfassen, das Sie in Rechnung stellen können. Sie abonnieren Ihre Kundinnen und Kunden für einen Preisplan, der eine oder mehrere Komponenten für nutzungsbasierte Preise, wiederkehrende Gebühren oder wiederkehrende Gutschriften enthält. Bestehende Komponenten können Sie ändern oder neue zu Preisplänen hinzufügen, um neue Versionen dieses Plans zu erstellen und entscheiden, ob bestehende Kundinnen und Kunden auf die neueste Version migriert werden sollen oder nicht. Ein Preisplan kann eine beliebige Kombination aus Folgendem enthalten: - Eine Preisliste - Lizenzgebühr - Eine Serviceaktion So sieht ein Preisplan mit all seinen Komponenten aus. ![Beispielbild eines Preisplans mit Preisplan, Lizenzgebühr und Serviceaktion.](https://b.stripecdn.com/docs-statics-srv/assets/pricing-plan.295b34e2ba8880b8c20edc782958f4a9.png) Ein Preisplan mit Preisliste, Lizenzgebühr und Serviceaktion. Im Folgenden finden Sie ein Beispiel dafür, wie ein vollständiger Preisplan mit *Checkout* aussieht. Erfahren Sie, wie Sie [mit Checkout einen Preisplan für Kundinnen/Kunden erstellen](https://docs.stripe.com/billing/subscriptions/usage-based/pricing-plans.md?payment-ui=checkout) können. ![Beispiel für einen Preisplan](https://b.stripecdn.com/docs-statics-srv/assets/checkout_pricing_plan_example.2156a15535345b113c30e7efabe72867.png) Ein in Stripe Checkout angezeigter Preisplan | Laufzeit | Definition | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Preisplan | Ein anpassbarer Container von Preiskomponenten (wie Preislisten, Lizenzgebühren und wiederkehrenden Gutschriften), der definiert, wie Sie Ihren Dienst abrechnen. Sie können beispielsweise einen Preisplan erstellen, der Preislisten für die nutzungsbasierte Abrechnung, Lizenzgebühren für wiederkehrende Zahlungen und Serviceaktionen für wiederkehrende Gutschriften. Wenn eine Kundin/ein Kunde einen Preisplan abonniert, werden alle wiederkehrenden Komponenten automatisch aktiviert und entsprechend dem von Ihnen konfigurierten Rhythmus abgerechnet. | | Preisplan-Komponente | Ein Teil des Preisplans, z. B. eine Preisliste, Lizenzgebühr or . Jede Komponente verfügt über eine Version, um sicherzustellen, dass sie einheitlich in Preisplänen verwendet wird. Wenn Sie beim Anhängen an den Preisplan keine Komponentenversion angeben, wird die Standardversion verwendet. | | Preisplan-Abonnements | Ein Preisplan-Abo wird erstellt, wenn eine Kundin oder ein Kunde eine bestimmte Preisplanversion abonniert hat. Abos generieren und belasten die Kunden nach einem zugrunde liegenden Abrechnungsrhythmus. | | Preisplanversion | Eine Preisplanversion ist eine versionierte Momentaufnahme eines Preisplans. Wenn Sie einen Preisplan erstellen, müssen Sie eine Live-Version festlegen, bevor Sie den Plan aktivieren oder Kundinnen und Kunden dafür anmelden können. Durch das Ändern oder Löschen bestehender Komponenten wird eine neue Version erstellt. Durch das Hinzufügen einer Komponente (Preisliste, Lizenzgebühr oder Serviceaktion) wird eine neue Version erstellt. Beim Anmelden von Kundinnen und Kunden können Sie eine Version angeben oder Stripe die aktuelle Live-Version zuweisen lassen. Kundinnen und Kunden bleiben auf der ihnen zugewiesenen Version, sofern diese nicht manuell geändert wird. Auf diese Weise können Sie unterschiedliche Preise für neue und bestehende Kundinnen und Kunden festlegen. | #### Versionierung von Preisplänen Preispläne unterstützen die Versionierung, um Änderungen an Ihrer Abrechnungsstruktur im Laufe der Zeit zu verwalten. Jede Version eines Preisplans ist unveränderlich. Wenn Sie einen Preisplan durch Ändern oder Löschen bestehender Komponenten aktualisieren, erstellt Stripe eine neue Version. Das Hinzufügen einer Komponente (Preisliste, Lizenzgebühr oder Serviceaktion) erstellt ebenfalls eine neue Version. Dieses Versionierungssystem unterstützt Sie in folgender Weise: - Planen Sie Preisänderungen und teilen Sie diese den Kunden/Kundinnen mit. - Verwalten Sie unterschiedliche Preise für verschiedene Kunden/Kundin-Segmente. - Verfolgen und pflegen Sie die Historie Ihrer Preismodelle. Jeder Preisplan hat zwei Versionseigenschaften: - [latest_version](https://docs.stripe.com/api/v2/pricing-plans/pricing-plans/object.md?api-version=preview#v2_pricing_plan_object-latest_version): Dies ist die aktuellste Version nach Updates. - [live_version](https://docs.stripe.com/api/v2/pricing-plans/pricing-plans/object.md?api-version=preview#v2_pricing_plan_object-live_version): Dies ist die Version, die standardmäßig für neue Abonnements verwendet wird, es sei denn, es wird eine bestimmte Version angegeben. ### Konzepte zu Preisplan-Abos Folgende Konzepte sind wichtig, um zu verstehen, wie Preisplan-Abos funktionieren. | Laufzeit | Definition | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Abrechnungsintervall (Rhythmus) | Ein Abrechnungsintervall definiert, wann Sie Rechnungen senden und erstellen. Die erstellte Rechnung konsolidiert nur Zahlungen, die während eines oder mehrerer Serviceintervalle aufgelaufen sind. Sie können entsprechend Ihrem Geschäftsmodell verschiedene Abrechnungsintervalle konfigurieren. Zum Beispiel: - **Monatlich**: Die Kundin oder der Kunde erhält eine monatliche Rechnung für die gesamte Dienstnutzung des vorherigen Monats. - **Vierteljährlich**: Die Nutzungsgebühren fallen monatlich an, aber Sie erstellen Rechnungen nur alle 3 Monate. - **Jährlich**: Sie stellen den Kundinnen und Kunden einmal jährlich alle in diesem Jahr in Anspruch genommenen Dienstleistungen in Rechnung. Abrechnungsintervalle sind Kundinnen und Kunden zugeordnet – ein Abrechnungsintervall ist einem Kundinnen und Kunden zugeordnet. (Jede Kundin/jeder Kunde kann mehrere Abrechnungsintervalle haben.) | | Preisplan-Abonnements | Ein Preisplan-Abo wird erstellt, wenn eine Kundin oder ein Kunde eine bestimmte Preisplanversion abonniert hat. Abos generieren und belasten Kundinnen und Kunden gemäß einem zugrundeliegenden [Abrechnungsintervall](https://docs.stripe.com/api/v2/billing-cadences.md?api-version=preview). | ### Preislistenkonzepte Im Folgenden finden Sie die wichtigsten Begriffe, um zu verstehen, wie Preislisten funktionieren. | Laufzeit | Definition | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Dimension | Mit Dimensionen können Sie nutzungsabhängige Preismodelle erstellen, die sich auf der Grundlage einer oder mehrerer Eigenschaften unterscheiden. Sie können Dimensionen angeben, wenn Sie Erstellen Sie einen Zähler oder einen nutzungsbasierten Posten oder übermitteln Sie die Nutzung. | | Preisliste | Eine Preisliste ist eine Sammlung nutzungsbasierter Tarife, die einen umfassenden Preisplan für ein Produkt darstellt. Sie können für Ihre Kundinnen und Kunden Abos mit einer Preisliste anlegen, indem Sie ein Preisplan-Abo erstellen, das einem Abrechnungsintervall zugeordnet ist. | | Listenpreis | Ein Listenpreis ist die Preiskonfiguration für einen nutzungsbasierten Posten in einer Preisliste. Der Preis definiert die Preisart (Festpreis, Volumen, Staffelung oder Überschreitung), den Preisbetrag und die Mengenkonfiguration (Sie können Einzelpersonen oder Pakete aus Einheiten verkaufen). Jede Preisliste kann mehrere Preise enthalten (bis zu 500). | | Preislistenversion | Eine Preislistenversion ist ein versionierter Snapshot einer Preisliste. Beim Erstellen einer Preisliste wird eine erste Live-Version als Standard für neue Abonnentinnen und Abonnenten festgelegt. Das Ändern oder Löschen bestehender Preise erzeugt eine neue Version; das Hinzufügen neuer Preise erstellt keine neue Version. Beim Abonnieren von Kundinnen und Kunden können Sie eine Version festlegen oder Stripe die aktuelle Live-Version zuweisen lassen. Kundinnen und Kunden bleiben auf ihrer zugewiesenen Version, sofern sie nicht manuell geändert wird, wodurch Sie unterschiedliche Preise für neue und bestehende Kundinnen und Kunden festlegen können. | ### Konzepte zu Lizenzgebühren | Laufzeit | Definition | | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Lizenzgebühr | Eine Lizenzgebühr ist eine feste, wiederkehrende Zahlung für einen abrechenbaren Posten, z. B. eine monatliche Abonnement-Gebühr. Sie enthält Angaben wie Preis, Abrechnungshäufigkeit und Steuerverhalten. | | Version der Lizenzgebühr | Eine Momentaufnahme der Lizenzgebühr. Wenn Sie eine Lizenzgebühr erstellen, wird eine erste Live-Version als Standard für neue Abonnent/innen festgelegt. Wenn Sie eine Lizenzgebühr zu einem Preisplan hinzufügen, können Sie eine Version angeben oder Stripe die aktuelle Live-Version zuweisen lassen. Durch das Hinzufügen oder Aktualisieren einer Lizenzgebühr zu einem Preisplan wird die Version des Preisplans erhöht. Sie können zusätzliche Änderungen am Preisplan vornehmen oder den neuen Preisplan live festlegen. | ### Konzepte zu Serviceaktionen | Laufzeit | Definition | | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Serviceaktion | Eine Serviceaktion definiert eine wiederkehrende Gutschrift, die den Betrag, die Abrechnungshäufigkeit und die anwendbaren abrechenbaren Posten angibt. Diese Gutschrift kann die Zahlung für bestimmte Posten reduzieren, z. B. für nutzungsbasierte Gebühren. | | Typ | Die spezifische wiederkehrende Aktion, die Sie erstellen. (Derzeit wird nur `credit_grant` unterstützt.) | ## Lebensdauer So sieht die Lebensdauer eines Preisplans aus: 1. Sie erstellen den Preisplan, der Preislisten, Lizenzgebühren und Serviceaktionen enthalten kann. 2. Abonnieren Sie den Preisplan für einen Kunden/eine Kundin über Checkout oder die API. 3. Die Nutzung wird für jedes Serviceintervall erfasst und aggregiert. 4. Für das Abonnement wird eine Rechnung gemäß dem Abrechnungsintervall erstellt. 5. Die Zahlungsmethode der Kundin/des Kunden wurde belastet. ## Abrechnungs- und Serviceintervall Der Das Abrechnungsintervall definiert, wann Sie Rechnungen erstellen. Die erstellte Rechnung konsolidiert Zahlungen, die während eines oder mehrerer Serviceintervalle aufgelaufen sind. Sie können verschiedene Abrechnungsintervalle konfigurieren, die zu Ihrem Geschäftsmodell und Ihren Preisstrukturen passen. Sie müssen das Serviceintervall so konfigurieren, dass es länger ist als das Abrechnungsintervall. Sie können beispielsweise ein vierteljährliches Serviceintervall in einem vierteljährlichen Rhythmus, aber nicht ein monatliches Serviceintervall in einem vierteljährlichen Rhythmus konfigurieren. Wenn ein Serviceintervall endet, berechnet Stripe nutzungsbasierte Gebühren und wiederkehrende Gebühren für den betreffenden Zeitraum (z. B. Kundennutzung für die letzte Woche). Diese Gebühren werden auf dem Kundenkonto vermerkt und ein neuer Rechnungsposten wird erstellt, aber nicht unbedingt sofort in Rechnung gestellt. Wenn ein Abrechnungszeitraum endet, werden alle seit dem letzten Abrechnungszeitraum angefallenen Kosten in einer Rechnung zusammengefasst und an die Kundin/den Kunden gesendet. Diese Trennung ermöglicht flexible Abrechnungen, wie z. B. eine monatliche Leistungsmessung mit jährlicher Abrechnung oder eine tägliche Leistungsmessung mit wöchentlicher Abrechnung. ### Beispiele Den Kunden/Kundinnen werden nur abgeschlossene Serviceintervalle in Rechnung gestellt. Wenn einer Kundin / einem Kunden eine Rechnung gestellt wird, solange die Nutzung im Serviceintervall noch nicht abgeschlossen ist, umfasst das Preisplan-Abonnement nur die Nutzung aus dem vorherigen Serviceintervall. Jede neue Nutzung wird der Rechnung für den nächsten Abrechnungsrhythmus hinzugefügt. Lizenzgebühren werden unabhängig vom Abrechnungsintervall ein Serviceintervall im Voraus abgerechnet. #### Serviceintervall von 5 Monaten bei einem jährlichen Abrechnungsintervall In diesem Beispiel hat ein Unternehmen die folgende Einrichtung: - **Serviceintervall**: Alle 5 Monate - **Abrechnungsintervall**: Jährlich am 31. März Der Kunde/die Kundin wird nur für die abgeschlossenen Serviceintervalle innerhalb des jährlichen Rechnungsstellungsintervalls abgerechnet. In diesem Beispiel bezieht sich die Rechnung auf 10 Monate Nutzung, was den zwei abgeschlossenen Serviceintervallen entspricht. ![Diagramm, das zeigt, wie ein 5-monatiges Serviceintervall in einem jährlichen Abrechnungsintervall abgerechnet wird.](https://b.stripecdn.com/docs-statics-srv/assets/service-interval-5-month-cadence-annual-diagram.0ce339d4cc38cd8956e0dda7ad39d9d7.png) Bei einem 5-monatigen Serviceintervall und einem jährlichen Abrechnungsintervall werden dem Kunden/der Kundin nur die abgeschlossenen Serviceintervalle in Rechnung gestellt. ### Separates Abrechnungs- und Serviceintervall einrichten Sie können Kundinnen und Kunden häufigere Nutzungszeiträume anbieten, indem Sie die Nutzung wöchentlich erfassen (dies ist das Serviceintervall). Um jedoch den Verwaltungsaufwand zu reduzieren, entscheiden Sie sich womöglich, nur monatlich Rechnungen zu erstellen (dies ist das Abrechnungsintervall). Die separate Definition von Serviceintervall und Abrechnungsintervall gibt Ihnen die Flexibilität, die Nutzung in einer Frequenz zu aggregieren und den Zugriff bereitzustellen (z. B. wöchentlich), während Kundinnen und Kunden in einer anderen Frequenz abgerechnet werden (z. B. monatlich). Dies kann helfen, Ihren Cashflow zu optimieren. #### Dashboard So richten Sie im Dashboard ein separates Abrechnungs- und Serviceintervall ein: 1. Create a rate card. 2. Definieren Sie ein Serviceintervall, das bestimmt, wie häufig die Nutzung aggregiert wird (z. B. wöchentlich). 3. Eine/n Kunden/Kundin auf eine Preisliste abonnieren. 4. Definieren Sie ein Abrechnungsintervall, das festlegt, wie häufig Rechnungen erstellt werden (z. B. monatlich – dies muss nicht mit der Frequenz des Serviceintervalls übereinstimmen). #### API So richten Sie mit der API ein separates Abrechnungs- und Serviceintervall ein: Zunächst create a rate card. Dabei definieren Sie das `service_interval` sowie einen Anzeigenamen und das Steuerverhalten. In diesem Beispiel handelt es sich um ein wöchentliches Serviceintervall. ```curl curl -X POST https://api.stripe.com/v2/billing/rate_cards \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "display_name": "Hypernian", "service_interval": "week", "service_interval_count": 1, "currency": "usd", "tax_behavior": "exclusive" }' ``` Sie müssen auch nutzungsbasierte Posten erstellen und Preise. Definieren Sie ein monatliches Abrechnungsintervall für Ihren Kunden/Ihre Kundin. Der Parameter `billing_cycle` legt fest, wann und wie der Zahlende/die Zahlende abgerechnet wird. ```curl curl -X POST https://api.stripe.com/v2/billing/cadences \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "payer": { "type": "customer", "customer": "{{CUSTOMER_ID}}" }, "billing_cycle": { "type": "month", "interval_count": 1, "month": { "day_of_month": 20 } } }' ``` Erstellen Sie abschließend ein Preisplan-Abonnement, um den Preisplan mit dem Abrechnungsintervall zu verbinden: ```curl curl -X POST https://api.stripe.com/v2/billing/intents \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "cadence": "{{BILLING_CADENCE_ID}}", "currency": "usd", "effective_at": "on_commit", "actions": [ { "type": "subscribe", "subscribe": { "type": "pricing_plan_subscription_details", "proration_behavior": "none", "pricing_plan_subscription_details": { "pricing_plan": "{{PRICING_PLAN_ID}}", "pricing_plan_version": "{{PRICING_PLAN_VERSION_ID}}", "component_configurations": [] } } } ] }' ``` ## Revenue Recognition [Revenue Recognition](https://docs.stripe.com/revenue-recognition.md) für[nutzungsbasierte Abrechnung](https://docs.stripe.com/billing/subscriptions/usage-based-v2/overview.md) stellt sicher, dass Sie eine genaue Finanzberichterstattung haben und versetzt Ihr KI- oder SaaS-Unternehmen in die Lage, flexible, verbrauchsabhängige Preismodelle zu nutzen. Es folgt ein lieferbasierter Ansatz, bei dem der Umsatz erkannt wird, wenn die Dienstleistung tatsächlich bereitgestellt oder in Anspruch genommen wird, und nicht, wenn sie verkauft oder in Rechnung gestellt wird. Revenue Recognition besteht aus zwei Hauptkomponenten: - **Verkaufs-Transaktion**: Zeichnet den Verkauf von nutzungsbasierten Dienstleistungen und wann die Dienstleistung tatsächlich in Anspruch genommen wurde. - **Rechnungsposten**: Erfasst, wann dem Kunden/der Kundin eine Rechnung gestellt wurde. ### Funktionsweise der Revenue Recognition mit nutzungsbasierter Abrechnung Bei der nutzungsbasierten Abrechnung besteht die Revenue Recognition aus drei Hauptphasen: - **Umsatzabgrenzung**: Der Umsatz wird zum Zeitpunkt der Lieferung auf der Grundlage des tatsächlichen Verbrauchs von Dienstleistungen errechnet. - **Umsatzumkehrung**: Wenn Rechnungen fertiggestellt werden, erfolgt eine Umsatzumkehrung auf die ursprüngliche Umsatzabgrenzung. Dieser Schritt ist wichtig, um sicherzustellen, dass die Revenue Recognition die dem Kunde/Kundin in Rechnung gestellten Beträge genau widerspiegelt. - **Umbuchung der Rechnung**: Wenn die Rechnung fertiggestellt ist, beinhaltet die Umbuchung der Rechnung die Anerkennung der tatsächlichen Behandlung im Vergleich zum Rechnungsbetrag. #### Beispiel In diesem Beispiel verbraucht ein/e Kunde/Kundin über einen Zeitraum von 3 Monaten API-Aufrufe im Wert von und erhält dann die Abrechnung: - Januar (Umsatzabgrenzung): Im ersten Monat verbrauchen sie API-Aufrufe im Wert von . - Februar (Umsatzabgrenzung): Im zweiten Monat verbrauchen sie API-Aufrufe im Wert von . - März (Umsatzabgrenzung): Im dritten Monat verbrauchen sie API-Aufrufe im Wert von . - April (Umsatzumkehrung und Umbuchung der Rechnung): Nach drei Monaten erhält der Kunde/ die Kundin eine Rechnung über (seine gesamte Nutzung). - Mai (Zahlung): Der Kunde/die Kundin zahlt die Rechnung in Höhe von . | Konto | Januar 2025 | Februar 2025 | März 2025 | April 2025 | Mai 2025 | Summe | | ------------------------------------------ | ----------- | ------------ | --------- | ---------- | -------- | ----- | | Umsatz | + | + | + | | | + | | Nicht abgerechnete AR (offene Forderungen) | + | + | + | - | | | | AR | | | | + | - | | | Bargeld | | | | | + | + | ### Einschränkungen Für die Verwendung von Revenue Recognition mit nutzungsbasierter Abrechnung gelten in der privaten Vorschau die folgenden Einschränkungen: - Zähler, die die Aggregationstypen `last` oder `max` verwenden, werden derzeit nicht unterstützt. - Erweiterte nutzungsbasierte Abrechnung nutzen [billable_items](https://docs.stripe.com/api/billing/credit-grant/object.md?api-version=preview#billing_credit_grant_object-applicability_config-scope-billable_items), die in den aktuellen Berichten nicht vollständig unterstützt werden. - Journalbuchungen für nutzungsbasierte Abrechnung zeigen die`billable_item`-ID als Produkt-ID. Produktdetails wie Produktname, -beschreibung und andere Attribute werden in Berichten jedoch leer angezeigt. ## Automatische Steuer Sie können die automatische Steuer für pricing plan subscriptions aktivieren, indem Sie [Stripe Checkout](https://docs.stripe.com/payments/checkout.md) verwenden oder direkt die API nutzen. #### Bezahlvorgang ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -H "Stripe-Version: 2025-09-30.preview;checkout_product_catalog_preview=v1" \ -d customer={{CUSTOMER_ID}} \ -d "checkout_items[0][type]=pricing_plan_subscription_item" \ -d "checkout_items[0][pricing_plan_subscription_item][pricing_plan]={{PRICING_PLAN_ID}}" \ -d "checkout_items[0][pricing_plan_subscription_item][component_configurations][{{LICENSE_COMPONENT_ID}}][type]=license_fee_component" \ -d "checkout_items[0][pricing_plan_subscription_item][component_configurations][{{LICENSE_COMPONENT_ID}}][license_fee_component][quantity]=1" \ -d "automatic_tax[enabled]=true" ``` #### API Um eine/n Kunden/Kundin auf einen Preisplan zu abonnieren, müssen Sie: 1. [Kunden/Kundin erstellen](https://docs.stripe.com/api/customers/create.md). Dies könnte der/die [während der Checkout-Sitzung](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#set-up-checkout) erstellte Kunde/die Kundin sein. 2. Erstellen Sie ein Billing Profil für das Abo des Preisplans. 3. Create a Billing setting mit aktivierter Steuer. 4. Abrechnungsrhythmus erstellen. 5. Erstellen Sie einen [Abrechnungs-Intent](https://docs.stripe.com/api/v2/billing-intents/intents/create.md?api-version=preview), wodurch ein [Preisplan-Abo](https://docs.stripe.com/api/v2/pricing-plan-subscriptions.md) erstellt wird, das auf den Preisplan und den Abrechnungsrhythmus verweist. Erstellen eines Kunden: ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ --data-urlencode "email=jenny.rosen@example.com" \ -d "name=Jenny Rosen" ``` Erstellen Sie ein Abrechnungsprofil: ```curl curl -X POST https://api.stripe.com/v2/billing/profiles \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "customer": "{{CUSTOMER_ID}}", "display_name": "Automatic collection settings", "lookup_key": "billing_profile_cus_123", "metadata": { "test": "data" } }' ``` Um das Steuerverhalten in einem Abrechnungsrhythmus zu steuern, erstellen Sie ein Rechnungseinstellungsobjekt: ```curl curl -X POST https://api.stripe.com/v2/billing/bill_settings \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "display_name": "Re-selling configuration", "calculation": { "tax": { "type": "automatic" } } }' ``` Fügen Sie anschließend das Abrechnungsprofil zum Abrechnungsrhythmus hinzu: ```curl curl -X POST https://api.stripe.com/v2/billing/cadences \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "payer": { "billing_profile": "{{BILLING_PROFILE_ID}}" }, "billing_cycle": { "type": "month", "interval_count": 1, "month": { "day_of_month": 20 } } }' ``` Abonnieren Sie Ihre Kundin oder Ihren Kunden auf den Preisplan, indem Sie einen [Abrechnungs-Intent](https://docs.stripe.com/api/v2/billing-intents/intents/object.md) erstellen und die IDs von Preisplan und Abrechnungsrhythmus übergeben. ```curl curl -X POST https://api.stripe.com/v2/billing/intents \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "currency": "usd", "cadence": "{{CADENCE_ID}}", "actions": [ { "type": "subscribe", "subscribe": { "type": "pricing_plan_subscription_details", "pricing_plan_subscription_details": { "pricing_plan": "{{PRICING_PLAN_ID}}", "pricing_plan_version": "{{PRICING_PLAN_VERSION}}", "component_configurations": [] } } } ] }' ``` Als Nächstes reservieren Sie den Abrechnungs-Intent. Anhand der beim [Reservieren](https://docs.stripe.com/api/v2/billing-intents/intents/reserve.md?api-version=preview) des Abrechnungs-Intents erzeugten Vorschau können Sie bestimmen, wie hoch die Zahlungen Ihrer Kundin oder Ihres Kunden sein sollen. ```curl curl -X POST https://api.stripe.com/v2/billing/intents/{{BILLING_INTENT_ID}}/reserve \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" ``` Als Nächstes bestätigen Sie den Abrechnungs-Intent, um das Preisplan-Abo zu aktivieren und die Kundin/den Kunden gemäß Plan und Abrechnungsintervall zu belasten. Wenn Ihre Zahlungsmethode auf „charge automatically“ eingestellt ist, müssen Sie außerdem die [PaymentIntent](https://docs.stripe.com/api/payment_intents.md)-ID angeben. (Dies ist nicht erforderlich, wenn Sie die Zahlungsmethode auf `send_invoice` gesetzt haben.) Die PaymentIntent-ID finden Sie in der Antwort, indem Sie [alle PaymentIntents auflisten](https://docs.stripe.com/api/payment_intents/list.md) oder auf der [Zahlungsseite im Dashboard](https://dashboard.stripe.com/payments) nachsehen. ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=usd \ -d customer={{CUSTOMER_ID}} \ -d payment_method={{PAYMENT_METHOD_ID}} \ --data-urlencode "return_url=https://example.com/return" \ -d confirm=true ``` ```curl curl -X POST https://api.stripe.com/v2/billing/intents/{{BILLING_INTENT_ID}}/commit \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "payment_intent": "{{PAYMENT_INTENT_ID}}" }' ``` Optional können Sie bei der Abonnement-Erstellung für einen Kunde / eine Kundin eine bestimmte Version eines Preisplan übergeben. Wenn Sie keine Version angeben, verwendet das Abonnement die Live-Version des Preisplans. ```curl curl -X POST https://api.stripe.com/v2/billing/intents \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "currency": "usd", "effective_at": "on_commit", "cadence": "bc_test_61SrjnScUwT6mNskZ16SjPfE4ZSQFjWjdqlzQfWMCVnM", "actions": [ { "type": "subscribe", "subscribe": { "type": "pricing_plan_subscription_details", "proration_behavior": "none", "pricing_plan_subscription_details": { "pricing_plan": "{{PRICING_PLAN_ID}}", "pricing_plan_version": "{{PRICING_PLAN_VERSION}}", "component_configurations": [] } } } ] }' ```