Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden

Nutzungsbasierte Abrechnung mit Preislisten einrichtenPrivate Vorschau

Belasten Sie Kundenkonten basierend auf komplexen Preismodellen mit Preislisten und Abonnements.

Sie können Kundinnen/Kunden über eine Preisliste viele verschiedene Preise für nutzungsbasierte Dienste anbieten. Sie können der Preisliste neue Tarife hinzufügen und diese neuen Tarife sofort auf die Kunden/Kundinnen anwenden. Preislisten sind versioniert, sodass Sie die Preise für neue Kundinnen und Kunden anpassen können, während Sie für bestehende Kundinnen und Kunden einen älteren Preis beibehalten.

Private Vorschau

Preislisten befinden sich derzeit in der privaten Vorschau und können sich hinsichtlich Funktionalität und Integrationspfad noch ändern, bevor sie allgemein für alle Stripe-Nutzer/innen verfügbar sind. Kontakt hier, um Zugriff anzufordern.

Bevor Sie starten

Preislisten nutzen /v2-API-Endpoints, z. B. Preislistenabonnements. Erfahren Sie mehr über die /v2- und /v1-Namespaces.

Verwenden Sie Sandboxes, um Ihre Preislisten-Integration zu testen. Sie können den Test-Modus nicht mit /v2-APIs wie Rate Cards verwenden.

Preisliste erstellen

Verwenden Sie das Stripe-Dashboard oder die API, um eine Preisliste zu erstellen, die mehrere Preise enthält, wobei jeder Preis einen abrechenbaren Artikel, einen Zähler und ein Preismodell angibt.

Für jede Preisliste können Sie Folgendes konfigurieren:

  • Serviceintervall: Monatlich, jährlich, wöchentlich oder nutzerdefiniert.
  • Währung
  • Steuer soll in Preisen enthalten sein: Geben Sie an, ob die Steuer in Ihren Preis einbezogen werden soll (inklusive) oder ob sie zur Zwischensumme der Rechnung hinzuaddiert werden soll (exklusive). Erfahren Sie mehr über inklusive und exklusive Steuern für die Abrechnung.

Sie können das Serviceintervall, die Währung oder die Steuerberechnungsparameter nicht mehr ändern, nachdem Sie die Preisliste erstellt haben.

Nachdem Sie das Serviceintervall, die Währung und die Steuerparameter festgelegt haben, können Sie mehrere Preise in der Preisliste definieren. Jeder Preis gibt einen abrechenbaren Posten (das, was Sie verkaufen), den Zähler, der die Nutzung dieses Postens verfolgt, und das auf die Nutzung angewendete Preismodell an:

  • Preistyp: Festpreis, Volumen oder gestaffelt.
  • Verkaufen als: Berechnen Sie nach einzelnen Einheiten oder nach Einheitengruppen in Form von Paketen. Wenn Sie Pakete verwenden, geben Sie die Anzahl der Einheiten pro Paket an und wie Teilpakete auf- oder abgerundet werden sollen.
  • Erweiterte Einstellungen: Sie können optional den Produktsteuercode angeben. Sie können auch eine Einheitenbezeichnung, einen Suchschlüssel und Metadaten zum Preis und zum abrechenbaren Posten hinzufügen.

Sie können jederzeit neue Preise zu einer Preisliste hinzufügen. Wenn Sie vorhandene Preise ändern oder löschen, wird eine neue Version der Preisliste erstellt.

  1. Gehen Sie zur Registerkarte Preislisten auf der Seite „Nutzungsbasierte Abrechnung“. Klicken Sie auf + Preisliste erstellen.
    • Name der Preisliste: Fügen Sie einen Namen für Ihre Preisliste hinzu. Beispiel: Alpaca AI.
    • Service-Intervall: Wählen Sie den Zeitraum aus, in dem die Nutzung eines Kunden/einer Kundin aggregiert wird und die Preise dafür festgelegt werden. Erfahren Sie mehr über das Serviceintervall.
    • Währung: Wählen Sie die Währung aus.
    • Steuerverhalten: Wählen Sie aus, ob Folgendes gelten soll: Steuer soll in Preisen enthalten sein. Standardmäßig werden Steuern nicht in die Preise einbezogen. Erfahren Sie mehr über Steuerverhalten und Preislisten.
    • Klicken Sie auf Fortfahren.
  2. Fügen Sie im nächsten Bildschirm des Preislisten-Editors einen nutzungsbasierten Artikel hinzu:
    • Nutzungsbasierter Artikel: Geben Sie einen Namen für Ihren Artikel ein. Beispiel: Alpaca AI tokens.
    • Zähler: Wählen Sie einen vorhandenen Zähler aus oder erstellen Sie einen neuen, indem Sie auf das +-Symbol klicken.
    • Preiskonfiguration: Wählen Sie den Preistyp aus: Festbetrag, Volumen oder Gestaffelt. Alpaca AI verwendet zum Beispiel einen Festbetrag.
      • Wählen Sie aus, ob Sie als einzelne Einheiten verkaufen oder als Gruppe von Einheiten verkaufen möchten. Zum Beispiel könnte ein KI-Unternehmen seine Token als Pakete mit 100 Einheiten zu 0.04 USD pro Paket verkaufen.
      • Geben Sie für Pakete Einheiten pro Paket ein.
      • Wählen Sie aus, ob für Teilpakete auf- oder abgerundet werden soll. Wenn Sie aufrunden, werden einem/einer Nutzer/in, der/die 110 Einheiten nutzt, 0,08 USD in Rechnung gestellt.
      • Geben Sie den Preis pro Paket ein.
    • (Optional) Sie können optional Erweiterte Einstellungen für Ihren Posten konfigurieren, wie z. B. die Angabe eines Produktsteuercodes (erfahren Sie mehr über Steuercodes), einer Artikelbezeichnung, eines Suchschlüssels und Metadaten. Sie können dem Preis auch Metadaten hinzufügen.
    • Klicken Sie auf Speichern.
  3. Klicken Sie auf , um einen weiteren Tarif hinzuzufügen.
  4. Klicken Sie auf Preisliste erstellen.

Ihren Kunden/Ihre Kundin für eine Preisliste registrieren

Bevor Sie ein Abonnement erstellen, müssen Sie ein Customer-Objekt erstellen und Rechnungsinformationen angeben. Sie können dies im Dashboard, mit der API oder über Stripe Checkout durchführen.

Erstellen Sie manuell einen Kunden/eine Kundin im Dashboard und fügen Sie seine/ihre Rechnungsinformationen hinzu. Oder Sie erstellen einen Kunden/eine Kundin, wenn Sie das Preislistenabonnement erstellen.

  1. Gehen Sie zur Seite Preislisten und klicken Sie auf die Preisliste, die Sie für Ihren Kunden/Ihre Kundin registrieren möchten.
  2. Klicken Sie auf der Detailseite der Preisliste auf das Überlaufmenü () neben Preisliste bearbeiten.
  3. Im Preislisten-Abonnement-Editor:
    • Suchen Sie nach einer Kundin/einem Kunden oder fügen Sie eine Kundin/einen Kunden hinzu.
    • Definieren Sie den Abrechnungszeitraum, also wie oft und wann eine Rechnung an den Kunden/die Kundin gesendet werden soll.
    • Klicken Sie auf Abonnement erstellen.

Kundennutzung aufzeichnen

Nachdem Sie für einen Kunden/eine Kundin eine Preisliste registriert haben, können Sie die Nutzung Ihrer Dienstleistung aufzeichnen, indem Sie Zählerereignisse an einen Zähler senden.

  1. Gehen Sie zur Registerkarte Preislisten-Abonnements.
  2. Klicken Sie auf das Abonnement, für das Sie die Nutzung aufzeichnen möchten.
  3. Klicken Sie auf das Überlaufmenü () in der Zeile des Artikels, für den Sie die Nutzung aufzeichnen möchten, und dann auf Verbrauch anzeigen.
  4. Klicken Sie auf der Detailseite des Zählers auf + Nutzung hinzufügen und wählen Sie dann Nutzung manuell eingeben aus.
  5. Gehen Sie im Dialogfeld Nutzung hinzufügen wie folgt vor:
    • Wählen Sie einen Kunden/eine Kundin aus.
    • Geben Sie einen Wert für die Nutzung an.
    • Wählen Sie ein Datum für den Zeitstempel aus.
  6. Klicken Sie auf Absenden.

Eine Rechnungsvorschau erstellen

Erstellen Sie eine Rechnungsvorschau, um eine Vorschau der Rechnung eines Kunden/einer Kundin anzuzeigen, die Details wie den Zählerpreis und die Nutzungsmenge enthält.

  1. Gehen Sie zur Registerkarte Preislisten-Abonnements.

  2. Klicken Sie auf das Abonnement, für das Sie eine Rechnungsvorschau anzeigen möchten.

  3. Scrollen Sie nach unten zum Abschnitt Anstehende Rechnung. Die Rechnungsvorschau zeigt den Abonnementbetrag an, der dem Kunden/der Kundin zum angegebenen Datum in Rechnung gestellt werden soll.

  4. 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 Abonnement
    • Abonnement (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.

Wartungsereignisse überwachen

Preislistenabonnements geben Ereignisbenachrichtigungen aus, wenn sich der Status der Wartung ändert. Erfahren Sie mehr darüber, wie das Serviceintervall funktioniert.

Überwachen Sie diese Ereignisse und verwenden Sie sie, um Ihre Geschäftslogik zu erstellen:

v2.billing.rate_card_subscription.servicing_activatedWird gesendet, wenn ein Kunde/eine Kundin ein Abonnement zum ersten Mal aktiviert.
v2.billing.rate_card_subscription.servicing_pausedWird gesendet, wenn Kundinnen/Kunden ein Abonnement unterbrechen.
v2.billing.rate_card_subscription.servicing_canceledWird gesendet, wenn ein Kunde/eine Kundin ein Abonnement kündigt.

Um diese v2-Ereignisse zu verarbeiten, konfigurieren Sie ein Ereignisziel und verweisen Sie es auf Ihren Webhook-Endpoint. Sie können entweder:

Nachdem Sie ein Ziel erstellt haben, können Sie Ihren Webhook-Endpoint so einrichten, dass er diese Ereignisse verarbeitet:

server.rb
require 'stripe'

post '/v2_webhook_endpoint' do
  payload = request.body.read
  sig_header = request.env['HTTP_STRIPE_SIGNATURE']
  event = nil

  begin
    event = Stripe::Webhook.construct_event(
      payload, sig_header, endpoint_secret
    )
  rescue JSON::ParserError => e
    status 400
    return
  rescue Stripe::SignatureVerificationError => e
    status 400
    return
  end

  client = Stripe::StripeClient(
"sk_test_BQokikJOvBiI2HlWgH4olfQ2"
)

  case event.type
  when 'v2.billing.rate_card_subscription.servicing_activated'
    # The customer clicked Pay on Stripe Checkout, which activates the service.
    subscription_id = event.related_object.id
    subscription = client.v2.billing.rate_card_subscriptions
      .retrieve(subscription_id)

    # Look up your user in the database using the metadata passed into
    # Checkout Session create
    user_id = subscription.metadata["my_user_id"]
    user = User.find_by_id(user_id)

    # Fill in your logic here:
    mark_subscription_active(user, subscription)
  when 'v2.billing.rate_card_subscription.servicing_paused'
    # The customer paused the subscription.
    subscription_id = event.related_object.id
    subscription = client.v2.billing.rate_card_subscriptions
      .retrieve(subscription_id)

    # Look up your user in the database using the metadata passed into
    # Checkout Session create
    user_id = subscription.metadata["my_user_id"]
    user = User.find_by_id(user_id)

    # Fill in your logic here:
    mark_subscription_paused(user, subscription)
  when 'v2.billing.rate_card_subscription.servicing_canceled'
    # The customer canceled the subscription.
    subscription_id = event.related_object.id
    subscription = client.v2.billing.rate_card_subscriptions
      .retrieve(subscription_id)

    # Look up your user in the database using the metadata passed into
    # Checkout Session create
    user_id = subscription.metadata["my_user_id"]
    user = User.find_by_id(user_id)

    # Fill in your logic here:
    mark_subscription_canceled(user, subscription)
  end

  status 200
end
War diese Seite hilfreich?
JaNein