Warnungen und SchwellenwerteBeta
Benachrichtigung, wenn ein Kunde/eine Kundin eine Nutzungsschwelle überschreitet oder eine Rechnung auslösen, wenn ein Kunde/eine Kundin eine Abrechnungsschwelle erreicht.
Nutzungswarnungen
Sie können Nutzungswarnungen für die Zählernutzung einrichten. Warnungen können so konfiguriert werden, dass ein Webhook ausgelöst wird, wenn Kundinnen/Kunden bestimmte Nutzungsstufen erreichen. Warnungen gelten für bestimmte Kundinnen/Kunden oder alle. Arten von Nutzungswarnungen:
- Einmalige Nutzungswarnung pro Kunde/Kundin: Wird ausgelöst, wenn ein Kunde/eine Kundin zum ersten Mal ein bestimmtes Nutzung überschreitet. Als Beispiel erstellen Sie eine einmalige Benachrichtigung für Kunden/Kundinnen, wenn sie 100 API-Aufrufe erreichen. Tritt dies ein, erhalten Sie einen Webhook, der Sie darüber informiert, dass der Kunde/die Kundin den Schwellenwert überschritten hat. Diese Warnung wird nur einmal pro Kunde/Kundin ausgelöst, unabhängig von der zukünftigen Nutzung.
Sie können Nutzungswarnungen in Ihren Geschäftsabläufen verwenden, zum Beispiel:
- E-Mail an Nutzer/innen senden: Erlauben Sie Nutzerinnen und Nutzern, Nutzungslimits zu konfigurieren und eine E-Mail zu senden, wenn sie ihr Limit erreicht haben.
- Deaktivierung des Zugriffs: Geben Sie Nutzerinnen und Nutzern eine kostenlose Anzahl von Nutzungseinheiten für Ihren Dienst und entfernen Sie den Zugriff, wenn sie ein Limit überschreiten.
- Benachrichtigen des Vertriebsteams über ein Upsell: Benachrichtigen Sie Ihr Vertriebsteam über eine Geschäftsmöglichkeit, wenn ein/e Self-Service-Nutzer/in eine Nutzungsschwelleüberschreitet.
Warnungen können über das Dashboard oder die API erstellt werden.
Nachdem Sie eine Warnung konfiguriert und mit dem Senden der Nutzung für diesen Zähler begonnen haben, müssen Sie Webhooks überwachen.
Einschränkungen
- Warnungen werden bei ihrer Erstellung nicht ausgewertet, sondern nur anhand von Nutzungsdaten, die nach der Erstellung von Warnungen gemeldet wurden.
- Für jeden Bereich (d. h. eine Kombination aus Zähler und Kundenfilter) gilt ein Limit von 25 Warnungen. Sie können beispielsweise nicht mehr als 25 Warnungen für einen bestimmten Zähler und einen bestimmten Kunden/eine bestimmte Kundin erstellen. Sie können jedoch für jeden Ihrer Kundenk/jede Ihrer Kundinnen eine Warnung für einen bestimmten Zähler erstellen.
- Warnungen funktionieren derzeit nicht mit Test-Uhren.
Warnungen für Ausgaben und Guthaben
Sie können Warnungen angeben, wenn Kunden/Kundinnen einen bestimmten Ausgabenbetrag überschreiten oder ihr verfügbares Guthaben niedrig wird. Wenn Kunden/Kundinnen diese Schwellenwerte erreichen, löst die Warnung einen Webhook aus. Klicken Sie auf here, wenn Sie an der Beta teilnehmen möchten.
Abrechnungsschwellen
Sie können Abrechnungsschwellen erstellen, um eine Rechnung auszustellen und (optional) den Abrechnungszyklusanker eines Abonnements zurückzusetzen, wenn die kundenseitige Nutzung in einem Abonnementzyklus eine bestimmte monetäre Schwelle erreicht hat. Ziehen Sie die Verwendung von Abrechnungsschwellen in Betracht, um Vorkehrungen zur Begrenzung des geschuldeten Betrags oder der verbrauchten Produkte zwischen Rechnungen oder Abbuchungen zu treffen.
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 könnte.
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). Legen Sie den Wert auf mindestens 50 Währungseinheiten fest.
Sie können monetäre Schwellenwerte auch im Dashboard festlegen, wenn Sie ein Abonnement erstellen oder ändern.
Abonnement-Posten einen nutzungsbasierten Schwellenwert hinzufügen
Legen Sie Nutzungsschwellenwerte so fest, dass sie eine Nutzung überschreiten, um eine häufige Rechnungsstellung zu vermeiden. Die Einstellung von Nutzungsschwellenwerten im Dashboard wird von Stripe nicht unterstützt.
Schwellenwerte und Abrechnungszyklusanker
Standardmäßig bleibt der Abrechnungszyklusanker des Abonnements unverändert, wenn die Nutzung eines Kunden/einer Kundin den Schwellenwert erreicht hat. 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 ändern, indem Sie das Abonnement so konfigurieren, dass der Abrechnungszyklusanker nach Erreichen eines Schwellenwerts zurückgesetzt wird. Stripe behandelt das Erreichen eines Schwellenwerts so, als wäre das Abonnement am Monatsende natürlich an seinem Rollover-Punkt angekommen.
Schwellenwerte und gestaffelte Preisgestaltung
Stripe wendet Preisstufen auf alle schwellenwertbasierten Rechnungen an. Wenn Sie das Abonnement so konfigurieren, dass der Abrechnungszyklusanker nach Erreichen eines Schwellenwerts zurückgesetzt wird, ähnelt dies einem Abonnement ohne Schwellenwerte.
Angenommen, Sie betreiben eine Anzeigenplattform, die die folgende gestaffelte Struktur des Typs graduated
für Anzeigen-Impressions aufweist:
Stufe | Betrag (Stückkosten) |
---|---|
1–10.000 (up_ ) | 0,50 USD (unit_ ) |
Mehr als 10.000 (up_ ) | 0,40 USD (unit_ ) |
Da Stripe die Nutzung im Nachhinein abrechnet, legen Sie für neue Kundinnen/Kunden einen temporären Wert 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 nach 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 diese 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:
- Eine Schwellenwert-Rechnung wurde bereits ausgestellt.
- Die nachfolgende Nutzung wird zu niedrigeren Stückkosten abgerechnet.
Sehen Sie sich zum Beispiel die folgende gestaffelte Preisstruktur an:
Stufe | Betrag (Stückkosten) |
---|---|
1–10.000 (up_ ) | 0,50 USD (unit_ ) |
Mehr als 10.000 (up_ ) | 0,40 USD (unit_ ) |
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 eine weitere Einheit nutzt, verringert sich der Rechnungsbetrag auf 4.000,40 USD (10.001 × 0,40 USD = 4.000,40 USD).
Ohne 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 eine weitere Einheit nutzt, sinkt der Rechnungsbetrag auf 4.000,40 USD (10.001 x 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:
Posten | Menge | Betrag |
---|---|---|
Nutzung (0,50 USD pro Einheit) | 10.000 | 5.000 USD |
Summe | 5.000 USD |
Rechnung 2:
Posten | Menge | Betrag |
---|---|---|
Nutzung (0,40 USD pro Einheit) | 25.000 | 10.000 USD |
Bereits in Rechnung gestellter Betrag (zu 0,50 USD pro Einheit) | -5.000 USD | |
Summe | 5.000 USD |
Einschränkungen
- Schwellenwerte gelten nicht für Testabonnements.
- Die monetären Schwellenwerte müssen höher sein als die Summe der Pauschalgebühren für nutzungsbasierte Abonnement-Artikel.
- 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, stellen wir möglicherweise keine Rechnungen genau zu dem Zeitpunkt aus, an dem ein bestimmter Schwellenwert erreicht wird. Die in Rechnung gestellten Beträge oder Nutzung kann geringfügig höher sein als die angegebenen Schwellenwerte.
- Bei der Ermittlung des monetären Schwellenwerts werden keine Steuern, aber Rabatte berücksichtigt.
- Preise pro Paket und Stufe werden zurzeit nicht unterstützt.
Webhooks überwachen
Um Ihre Integration abzuschließen, müssen Sie von Stripe gesendete Webhooks verarbeiten. Dies sind Ereignisse, die ausgelöst werden, wenn sich ein Status innerhalb von Stripe ändert, z. B. beim Erstellen neuer Abonnements und Rechnungen. Richten Sie in Ihrer Anwendung einen HTTP-Handler ein, um eine POST-Anfrage mit dem Webhook-Ereignis zu akzeptieren und verifizieren Sie die Signatur des Ereignisses.
Verwenden Sie während der Entwicklung die Stripe-CLI, um Webhooks zu überwachen und an Ihre Anwendung weiterzuleiten. Führen Sie Folgendes in einem neuen Datenterminal aus, während Ihre Entwicklungs-App ausgeführt wird:
stripe listen --forward-to localhost:4242/webhook
Für die Produktionsphase können Sie eine Webhook-Endpoint-URL über das Dashboard oder mit der Webhook Endpoints API einrichten.