Nutzungsbasierte AbrechnungLegacy

Sie können Testphasen für Abonnements mit nutzungsbasierter Abrechnung nutzen. Während des Testzeitraums wird jegliche Nutzung nicht auf den Gesamtbetrag angerechnet, der dem Kunden/der Kundin am Ende des Abrechnungszyklus in Rechnung gestellt wird. Nach Ablauf des Testzeitraums wird die Nutzung summiert und am Ende des nächsten Abrechnungszyklus abgerechnet.

Erfahren Sie mehr über Testphasen und Abonnements.

Webhooks und Testzeiträume

Achten Sie darauf, dass Ihre Integration Web-Ereignisse im Zusammenhang mit Statusänderungen des Testzeitraums ordnungsgemäß überwacht und verarbeitet.

Einige Tage vor Ablauf eines Testzeitraums, wenn das Abonnement von trialing auf active wechselt, erhalten Sie das Ereignis customer.subscription.trial_will_end. Wenn dies eintritt, überprüfen Sie, ob Sie eine Zahlungsmethode für die Kundin/den Kundin haben, damit Sie ihr/sein Konto belasten können. Informieren Sie die Kundin/den Kunden optional über die Belastung.

Erfahren Sie mehr über Abonnements und Webhooks.

Bei der nutzungsbasierten Abrechnung variiert der von der Kundin/vom Kunden gezahlte Preis je nach Konsum im Rechnungsstellungszeitraums. Wenn durch die Änderung des Rechnungsstellungszeitraums der Servicezeitraum eines Abos vorzeitig endet, berechnen Sie der Kundin/dem Kunden die Nutzung, die während des verkürzten Rechnungsstellungszeitraums angefallen ist.

Wenn ein Abonnement gekündigt wurde, kann es nicht reaktiviert werden. Sie müssen stattdessen die aktualisierten Rechnungsinformationen von Ihrer Kundinnen/Kunden erfassen, deren Standard-Zahlungsmethode aktualisieren und ein neues Abonnement für den bestehenden Kundendatensatz erstellen.

Wenn die Kündigung eines Abonnements mit cancel_at_period_end geplant wurde, können Sie es bis zum Ende des Zeitraums jederzeit reaktivieren, indem Sie cancel_at_period_end auf „false“ setzen. Die Schlussrechnung enthält die gemessene Nutzung, wenn das Abonnement zum Ende des Abrechnungszeitraums gekündigt wird.

Anteilmäßige Verrechnung

Wenn Ihr Kunde/Ihre Kundin sein/ihr Abonnement ändert, kommt es häufig zu einer Anpassung des zu zahlenden Betrags. Diese Anpassung wird als anteilmäßige Verrechnung bezeichnet. Mithilfe des Endpoints zum Erstellen einer Rechnungsvorschau können Sie Ihren Kundinnen und Kunden den angepassten Betrag anzeigen.

Übergeben Sie im Frontend die Details der Vorschau der Rechnung an einen Backend-Endpoint.

function createPreviewInvoice(
  customerId,
  subscriptionId,
  newPriceId,
  trialEndDate
) {
  return fetch('/create-preview-invoice', {
    method: 'post',
    headers: {
      'Content-type': 'application/json',
    },
    body: JSON.stringify({
      customerId: customerId,
      subscriptionId: subscriptionId,
      newPriceId: newPriceId,
    }),
  })
    .then(response => {
      return response.json();
    })
    .then(invoice => {
      return invoice;
    });
}

Legen Sie im Backend den Endpunkt fest, den Ihr Frontend aufrufen soll. Erstellen Sie eine Rechnungsvorschau und übergeben Sie die Änderungen, die Sie in der Vorschau anzeigen möchten. In diesem Beispiel müssen Sie den Abonnementartikel für die alte Preis-ID entfernen, die Nutzung löschen und anschließend die neue Preis-ID hinzufügen. Diese Änderungen werden nicht tatsächlich angewendet, sondern legen lediglich fest, wie die Vorschau aussieht.

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

post '/create-preview-invoice' do
  content_type 'application/json'
  data = JSON.parse request.body.read

  subscription = Stripe::Subscription.retrieve(data['subscriptionId'])

  invoice =
    Stripe::Invoice.create_preview(
      customer: data['customerId'],
      subscription: data['subscriptionId'],
      subscription_details: {
        items: [
          { id: subscription.items.data[0].id, deleted: true, clear_usage: true },
          { price: ENV[data['newPriceId']], deleted: false }
        ]
      }
    )

  invoice.to_json
end

Abrechnungsschwellenwerte ermöglichen es, eine Rechnung auszustellen und (optional) den Abrechnungszyklusanker eines Abos zurückzusetzen, wenn die im Abrechnungszeitraum eines Abo-Dienstes angefallene Nutzung einer Kundin/eines Kunden einen festgelegten monetären oder nutzungsbasierten Schwellenwert erreicht. Erwägen Sie die Verwendung von Abrechnungsschwellenwerten, wenn Sie Vorsichtsmaßnahmen einbauen möchten, um den geschuldeten Betrag oder die konsumierten Produkte zwischen Rechnungen oder Zahlungen zu begrenzen.

Einem Abonnement einen monetären Schwellenwert hinzufügen

In der Regel sollten Sie den Schwellenwert auf ein Vielfaches der Kosten für eine Einheit des verkauften Produkts festlegen.

Bei niedrigeren Schwellenwerten erhalten Ihre Kundinnen und Kunden für jede Nutzungseinheit eine Rechnung, was zu Unklarheiten führen kann.

Der Wert ist eine positive ganze Zahl in der kleinsten Währungseinheit (z. B. 100 Cent, um 1 USD in Rechnung zu stellen, oder 100, um 100 JPY (eine Nicht-Dezimalwährung) in Rechnung zu stellen). Der Wert muss mindestens 50 Währungseinheiten umfassen.

Sie können monetäre Schwellenwerte auch im Dashboard festlegen, wenn Sie ein Abonnement erstellen oder ändern.

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "billing_thresholds[amount_gte]"=10000 \
  -d "billing_thresholds[reset_billing_cycle_anchor]"="false"

Abonnement-Posten einen nutzungsbasierten Schwellenwert hinzufügen

Wie die monetären sollten auch die nutzungsbasierten Schwellenwerte idealerweise größer als eine Nutzungseinheit sein, um eine zu häufige Rechnungsstellung zu vermeiden. Die Festlegung von nutzungsbasierten Schwellenwerten über das Dashboard wird von Stripe derzeit nicht unterstützt.

curl https://api.stripe.com/v1/subscription_items/si_CFhSgkWb0MyTWg \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "billing_thresholds[usage_gte]"=2000

Schwellenwerte und Abrechnungszyklusanker

Wenn das Nutzungsverhalten einer Kundin/eines Kunden einen Schwellenwert erreicht, ändert sich der Abrechnungszyklusanker des Abonnements (standardmäßig) nicht. Wenn ein Schwellenwert z. B. in der Mitte eines einmonatigen Abonnements erreicht wird, wird das Abonnement genau wie ein Abonnement ohne Schwellenwerte am Ende des Monats zurückgesetzt.

Sie können dieses Verhalten so ändern, dass beim Erreichen eines Schwellenwerts der Abrechnungszyklusanker zurückgesetzt wird. Dann markiert das Monatsende den üblichen Verlängerungszeitpunkt des Abonnements.

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "billing_thresholds[reset_billing_cycle_anchor]"="true"

Beachten Sie, dass reset_billing_cycle_anchor=true nicht zulässig ist, wenn ein nutzungsbasiertes Abonnement aggregate_usage=last_ever aufweist.

Schwellenwerte und gestaffelte Preisgestaltung

Preisstufen werden auf alle schwellenwertbasierten Rechnungen angewendet. Wie bei einem Abonnement ohne Schwellenwerte werden die Preisstufen erst am Ende des Abrechnungszeitraums zurückgesetzt. Alternativ können Sie das Abonnement so konfigurieren, dass der Abrechnungszyklusanker beim Erreichen eines Schwellenwerts zurückgesetzt wird.

Angenommen, Sie betreiben eine Anzeigenplattform, die eine gestaffelte Struktur des Typs graduated für Anzeigen-Impressions aufweist:

Da die Nutzung im Nachhinein abgerechnet wird, legen Sie für neue Kundinnen/Kunden einen Schwellenwert von 100 USD fest. Gemäß der Preisstaffelung wird alle 200 Impressions eine Rechnung gestellt, bis 10.000 Impressions erreicht wurden (200 × 0,50 USD = 100 USD). Nachdem 10.000 Impressions überschritten wurden, wird alle 250 Impressions eine Rechnung gestellt (250 × 0,40 USD = 100 USD). Dies wird bis zum Ende des Abrechnungszeitraums fortgesetzt. Dann wird die bisher noch nicht abgerechnete Nutzung in Rechnung gestellt und das Abonnement und die Stufen werden zurückgesetzt.

Wenn die Stufen stattdessen beim Erreichen eines Schwellenwerts zurückgesetzt werden sollen, müssen Sie das Abonnement so konfigurieren, dass der Abrechnungszyklusanker zurückgesetzt wird, wenn die Nutzung die von Ihnen festgelegten Schwellenwerte erreicht.

Mengenstufen

Mengenstufen legen den Preis für alle Nutzungseinheiten fest, im Gegensatz zu gestaffelten Stufen, bei denen der Preis für eine bestimmte Nutzungsmenge gilt. Bei einigen Preismodellen sinken die Stückkosten mit jeder weiteren Stufe. Sie können solche Modelle verwenden, um Anreize für Kundinnen und Kunden zu schaffen, mehr von einem Produkt zu nutzen (zum Beispiel Anzeigen-Impressions oder Speicherplatz).

In Kombination mit Schwellenwerten können diese Preismodelle unter den folgenden Bedingungen zu Rechnungen mit Posten für Negativbeträge führen:

1. Eine Schwellenwert-Rechnung wurde bereits ausgestellt.
2. Die nachfolgende Nutzung wird zu niedrigeren Stückkosten abgerechnet.

Beispielsweise mit den folgenden Stufen:

Wenn eine Kundin/ein Kunde 10.000 Einheiten nutzt, beträgt der Rechnungsbetrag 5.000 USD (10.000 × 0,50 USD = 5.000 USD). Jede weitere Nutzung führt dazu, dass die gesamte Nutzung zu den niedrigeren Stückkosten von 0,40 USD abgerechnet wird. Wenn die Kundin/der Kunde also nur eine weitere Einheit nutzt, verringert sich der Rechnungsbetrag auf 4.000,40 USD (10.001 × 0,40 USD = 4.000,40 USD).

Ohne Abonnement-Schwellenwerte würde Stripe am Ende des Abrechnungszeitraums eine Rechnung über 4.000,40 USD ausstellen.

Um uns jedoch anzusehen, wie es zu einem negativen Rechnungsbetrag kommen kann, gehen wir von einem monetären Schwellenwert von 5.000 USD aus. In diesem Szenario würde das bedeuten, dass Stripe eine Rechnung erzeugt, wenn die Kundin/der Kunde 10.000 Einheiten genutzt hat.

Wenn die Kundin/der Kunde nur eine weitere Einheit nutzt, sinkt der Rechnungsbetrag auf 4.000,40 USD (10.001 × 0,40 USD = 4.000,40 USD). Werden jedoch keine weiteren Einheiten genutzt, werden der Kundin/dem Kunden 999,60 USD geschuldet (5.000 USD – 4.000,40 USD = 999,60 USD). Am Ende des Abrechnungszeitraums schreibt Stripe den Betrag dem Kundensaldo gut, der zur Begleichung zukünftiger Rechnungen verwendet wird.

Nehmen wir an, dass die Kundin/der Kunde weitere Einheiten nutzt. Die Kosten für diese Nutzung erreichen erneut 5.000 USD, wenn kundenseitig 12.500 Einheiten genutzt werden (5.000 USD ÷ 0,40 USD = 12.500 Einheiten). Die vorherige Zahlung von 5.000 USD deckt jedoch die gesamte Nutzung ab, sodass keine Rechnung gestellt wird.

Stripe stellt erst dann eine Rechnung aus, wenn entweder die Gesamtnutzung 25.000 Einheiten beträgt (bei Gesamtkosten von 10.000 USD) oder das Ende des Abrechnungszeitraums erreicht wurde – je nachdem, was zuerst eintritt. Die folgenden Tabellen enthalten die Posten, die Sie auf den zwei Rechnungen sehen werden, die bei einer Nutzung von 25.000 Einheiten erstellt werden.

Rechnung 1

Rechnung 2

Beschränkungen und Ausnahmen

• Schwellenwerte gelten nicht für Testabonnements.
• Die monetären Schwellenwerte müssen größer sein als die Summe der Pauschalpreise für nutzungsbasierte Abonnementposten.
• Das Erreichen von Abrechnungsschwellen wird in den 24 Stunden vor Ablauf eines Abonnements nicht geprüft. Damit soll vermieden werden, dass Kundinnen/Kunden mehrere Rechnungen am selben Tag erhalten.
• Bei Abonnements ist nur ein monetärer Schwellenwert zulässig.
• Bei Abonnement-Artikeln ist nur ein nutzungsbasierter Schwellenwert zulässig.
• Da die Nutzung in Echtzeit geprüft wird, werden Rechnungen möglicherweise nicht genau zu dem Zeitpunkt ausgestellt, an dem ein bestimmter Schwellenwert erreicht wird. Die in Rechnung gestellten Beträge oder die in Rechnung gestellte Nutzung kann daher geringfügig höher sein als die angegebenen Schwellenwerte.
• Bei der Ermittlung des monetären Schwellenwerts werden keine Steuern, aber Rabatte und anwendbare anteilsmäßige Verrechnungen berücksichtigt.
• Wenn für ein Abonnement der Gruppierungsmodus last_ever verwendet wird, können Sie die Option reset_billing_anchor nicht aktivieren.

Sie können das nutzungsbasierte Preismodell in Situationen anwenden, in denen die gemessene Einheit nicht strikt auf einer Summe basiert.

Typographic bietet zum Beispiel einen Werbetexter-Service an, der je nach Anzahl der geschriebenen Wörter abgerechnet wird. Typographic stellt seinen Kundinnen und Kunden am Ende des Monats die Nutzung des Werbetexter-Services zusätzlich zur monatlichen Pauschalgebühr in Rechnung. Typographic möchte die maximale Anzahl der Wörter pro Kundin/Kunde pro Monat in Rechnung stellen. Dies kann mit dem Parameter aggregate_usage konfiguriert werden:

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d nickname="Copywriting service" \
  -d product={{PRODUCT_ID}} \
  -d unit_amount=10000 \
  -d currency=usd \
  -d "recurring[interval]"=month \
  -d "recurring[usage_type]"=metered \
  -d "recurring[aggregate_usage]"=max

Angenommen, eine Kundin/ein Kunde hat am 1. Juni insgesamt 2.000 Wörter und am 15. Juni weitere 1.000 Wörter geschrieben. Am 20. Juni werden ihr/ihm 1.000 der ersten 2.000 Wörter gutgeschrieben. Der abgerechnete Betrag am Ende des Monats beträgt 2,00 USD (2.000 Wörter maximale Nutzung im Monat, Berechnung von 0,10 USD pro Wort).

Der Parameter aggregate_usage bestimmt, wie Abonnements mit Nutzungsdaten umgehen. Hier sind die Optionen für diesen Parameter:

• sum: Der Standardwert (der übergeben wird, wenn Sie keinen Parameter angeben). Der Rechnungsbetrag ergibt sich aus der Summe aller Nutzungsdaten im Abrechnungszeitraum.
• last_during_period: Die Kosten werden basierend auf den letzten Nutzungsdaten für den Abrechnungszeitraum in Rechnung gestellt. Wenn für den Abrechnungszeitraum keine Nutzung vorliegt, gilt 0 als Nutzungsmenge für die Abrechnung.
• last_ever: Die Kosten werden basierend auf den letzten Nutzungsdaten in Rechnung gestellt. Wenn im aktuellen Abrechnungszeitraum keine Nutzung vorliegt, sucht Stripe nach früheren Nutzungsdaten. Werden keine gefunden, gilt 0 als Nutzungsmenge für die Abrechnung.
• max: Die Gesamtkosten werden basierend auf den Nutzungsdaten mit der größten Nutzungsmenge im Abrechnungszeitraum in Rechnung gestellt. Wenn für den Abrechnungszeitraum keine Nutzung vorliegt, gilt 0 als Nutzungsmenge für die Abrechnung.

Welche Option Sie wählen, hängt davon ab, wie Sie die Nutzung abrechnen möchten. Sie legen außerdem den Wert des Parameters action der Usage Records API fest, um anzugeben, wie Sie die Nutzung messen.

curl https://api.stripe.com/v1/prices \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "currency"="usd" \
  -d "recurring[interval]"="month" \
  -d "recurring[usage_type]"="metered" \
  -d "product_data[name]"="Gold special" \
  -d "nickname"="Gold special price" \
  -d "unit_amount"=3000

Beim Erstellen des Abonnements müssen Sie Folgendes beachten:

• Übergeben Sie quantity nicht.
• Achten Sie darauf, die IDs der Abonnement-Artikel zu erfassen. Diesen Wert übergeben Sie an die Usage Records API, um die Nutzung zu messen.

Mit der Option transform_quantity können Sie die Nutzung vor der Multiplikation mit den Stückkosten aggregieren. Das ist hilfreich, wenn Sie eine andere Menge oder eine andere Nutzung melden möchten, bevor Sie den Gesamtpreis bilden.

Typographic erweitert sein Angebot um einen Service für individuelles Schriftartdesign. Kundenspezifische Designs können jedoch sehr aufwendig sein, daher wird eine zusätzliche Gebühr (ein weiteres Product) berechnet, die sich nach dem Arbeitsaufwand richtet. Designer/innen geben die genaue Zeit an, die sie für die Anpassung benötigt haben. Typographic möchte seinen Kundinnen/Kunden jedoch keine minutengenaue Abrechnung senden. Stattdessen berechnet Typographic die Anpassung auf stündlicher Basis – dies gilt pro angefangener Stunde.

Erstellen Sie zunächst das Produkt „Anpassung der Schriftart“:

curl https://api.stripe.com/v1/products \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d name="Font Customization Service" \
  -d unit_label=Hours

Erstellen Sie als Nächstes einen Preis für das Produkt „Anpassung der Schriftart“, indem Sie 150 USD pro Stunde berechnen und dabei angefangene Stunden auf die volle Stunde aufrunden (auch wenn nur ein Teil der Stunde benötigt wurde):

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d nickname="Customization Per Hour Rate" \
  -d unit_amount=15000 \
  -d currency=usd \
  -d "recurring[interval]"=month \
  -d "recurring[usage_type]"=metered \
  -d product={{FONT_CUSTOMIZATION_SERVICE_PRODUCT_ID}} \
  -d "transform_quantity[divide_by]"=60 \
  -d "transform_quantity[round]"=up

Wenn Designer/innen 150 Minuten für die Anpassung aufwenden, werden der Kundin/dem Kunden 450 USD für 3 Stunden in Rechnung gestellt (2 Stunden und 30 Minuten, aufgerundet auf 3 Stunden).