Preisliste verwaltenPrivate Vorschau

In diesem Leitfaden wird beschrieben, wie Sie eine Einrichtung der nutzungsbasierten Abrechnung mit Preislisten aktualisieren und warten. Hierzu zählen unterschiedliche Abrechnungs- und Serviceintervalle, die Einführung neuer Dienste für alle Abonnentinnen und Abonnenten sowie die Einrichtung von Preisversionen nach Nutzergruppe.

Abrechnungszeitraum und Serviceintervall separat einrichten

Sie können Kundinnen/Kunden häufigere Einblicke in die Nutzung liefern, indem Sie die Nutzung wöchentlich bewerten (dies ist das Serviceintervall). Um den Verwaltungsaufwand zu reduzieren, sollten Sie Rechnungen jedoch nur monatlich erstellen (dies ist der Abrechnungszeitraum).

Wenn Sie das Serviceintervall und den Abrechnungszeitraum separat definieren, haben Sie die Flexibilität, die Nutzung zu aggregieren und den Zugriff in einer Häufigkeit (z. B. wöchentlich) bereitzustellen, aber Kundinnen/Kunden mit einer anderen Häufigkeit (z. B. monatlich) abzurechnen. Dies kann dazu beitragen, Ihre Cashflow-Anforderungen zu optimieren.

Führen Sie neue Dienste ohne Code für alle Abonnentinnen/Abonnenten ein

Wenn Sie eine neue Funktion mit neuen Preisen einführen, können Sie diese Preise auf alle Ihre Abonnentinnen und Abonnenten ausweiten, indem Sie der Preisliste einen neuen Tarif hinzufügen. Alle Abonnentinnen und Abonnenten der Live-Version haben Zugriff auf den neuen Dienst, den Sie hinzugefügt haben, und der neue Tarif gilt sofort.

Wenn Sie Ihrer Preisliste einen neuen Preis hinzufügen, ist dieser sofort für alle Abonnentinnen/Abonnenten dieser Version verfügbar. Jede Nutzung, die für den Zähler des neuen Tarifs gemeldet wird, wird entsprechend diesem Tarif berechnet, auch wenn Sie sie in der Mitte eines Abrechnungszyklus hinzufügen. Auf diese Weise können Sie schnell neue abrechenbare Dienste (wie ein neues KI-Modell) einführen, ohne Code schreiben zu müssen.

So fügen Sie Ihrer bestehenden Preisliste über das Dashboard neue Preise hinzu:

1. Gehen Sie zur Seite Preislisten.
2. Wählen Sie eine Preisliste aus und klicken Sie dann auf Preisliste bearbeiten.
3. Klicken Sie auf , um einen neuen Tarif hinzuzufügen.

Verschiedene Preisversionen nach Nutzergruppe einrichten

Preislisten verwenden Versionierung, um Ihnen eine flexible Preisverwaltung zu ermöglichen. Wenn Sie eine Preisliste erstellen, wird eine anfängliche Live-Version automatisch als Standard für neue Abonnentinnen/Abonnenten festgelegt. Durch das Hinzufügen neuer Preise zu einer Preisliste wird keine neue Version erstellt. Dies geschieht nur durch Ändern oder Löschen bestehender Tarife. Die Originalversion bleibt so lange live, bis Sie die Live-Version manuell ändern.

So bieten Sie verschiedenen Kundengruppen unterschiedliche Preise an:

1. Lassen Sie neue Kundinnen und Kunden die aktuelle Live-Version (Standard) einer Preisliste abonnieren.
2. Erstellen Sie verschiedene Versionen für unterschiedliche Kundensegmente.
3. Lassen Sie bestimmte Kundinnen/Kunden ältere Versionen abonnieren.

Wenn Sie ein Preislistenabonnement erstellen, können Sie angeben, welche Version verwendet werden soll:

curl -X POST https://api.stripe.com/v2/billing/rate_card_subscriptions \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-05-28.preview" \
  --json '{
    "rate_card": "rcd_A",
    "billing_cadence": "bc_1",
    "rate_card_version": "rcdv_123"
  }'

Wenn Sie keine Version angeben, verwendet Stripe automatisch die aktuelle Live-Version.

Migrieren von Kundinnen/Kunden zu neuen oder aktualisierten Preislisten

Um die Version für eine/n bestehende/n Abonnenten/Abonnentin zu ändern, müssen Sie sein/ihr Preislistenabonnement kündigen und ein neues mit der neuen Version erstellen. Sie können bestehende Kundinnen und Kunden auf eine neue Preisliste oder auf eine neue Version einer Preisliste umstellen. Kündigen Sie dazu die aktuellen Abonnements, für die die alte Preisliste oder Preislistenversion verwendet wird. Richten Sie dann ein Abonnement für Ihre Kundinnen/Kunden für die neue Preisliste oder Preislistenversion ein.

Preislistenabonnements kündigen

So kündigen Sie ein Preislistenabonnement:

• Gehen Sie im Dashboard zu Preislistenabonnements und wählen Sie das aus, das Sie kündigen möchten. Klicken Sie rechts neben dem Abonnement auf das Überlaufmenü () und wählen Sie Kündigen aus.
• Um die API zu verwenden, stellen Sie eine Anfrage an den Endpoint Preislistenabonnement kündigen:

curl -X POST https://api.stripe.com/v2/billing/rate_card_subscriptions/{{RATE_CARD_SUBSCRIPTION_ID}}/cancel \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-05-28.preview"