Nutzungsbasierte Warnungen einrichtenÖffentliche Vorschau

Richten Sie Warnungen ein, um benachrichtigt zu werden, wenn Kundinnen/Kunden Nutzungsschwellenwerte für Zähler überschreiten, oder um eine Rechnung auszulösen, wenn Kundinnen/Kunden ein bestimmtes Abrechnungslimit erreichen. Sie können Warnungen erstellen, die entweder für bestimmte Kundinnen/Kunden oder für alle Kundinnen/Kunden gelten.

Bevor Sie beginnen

Sie müssen einen Zähler erstellen, bevor Sie eine Warnung erstellen.

Nutzungswarnungen erstellen

Sie können Warnungen über das Stripe-Dashboard oder die API konfigurieren.

Sie können beispielsweise eine einmalige Warnung für Kundinnen/Kunden erstellen, die ausgelöst wird, wenn sie 100 API-Aufrufe erreichen. Wenn ein Kunde/eine Kundin 100 API-Aufrufe erreicht, erhalten Sie einen Webhook, der Sie darüber informiert, dass der Kunde/die Kundin den Schwellenwert überschritten hat.

Stripe bietet eine Nutzungswarnung vom Typ One-time per-customer usage alert. Diese Warnung wird ausgelöst, wenn ein Kunde/eine Kundin das angegebene Nutzungsniveau zum ersten Mal überschreitet, und wird unabhängig von der zukünftigen Nutzung nur einmal pro Kunde/Kundin ausgelöst.

Webhooks überwachen

Nachdem Sie eine Warnung konfiguriert und mit dem Senden der Nutzung für diesen Zähler begonnen haben, können Sie Webhooks überwachen. Diese Ereignisse werden ausgelöst, wenn sich der Status in Stripe ändert, z. B. wenn ein neues Abonnement oder eine neue Rechnung erstellt wird.

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.

# 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 '/webhook' do
# You can use webhooks to receive information about asynchronous payment events.
# For more information, see https://stripe.com/docs/webhooks.
webhook_secret = ENV['STRIPE_WEBHOOK_SECRET']
payload = request.body.read
if !webhook_secret.empty?

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 Terminal aus, während Ihre Entwicklungs-App ausgeführt wird:

stripe listen --forward-to localhost:4242/webhook

Richten Sie in der Produktionsumgebung eine Webhook-Endpoint-URL im Dashboard ein oder verwenden Sie Webhook-Endpoints.

Beschränkungen

Beachten Sie die folgenden Einschränkungen für Nutzungswarnungen:

• Warnungen werden nur anhand von Nutzungsdaten ausgewertet, die nach der Erstellung von Warnungen gemeldet wurden.
• Sie können maximal 25 Warnungen für jede Kombination aus einem bestimmten Zähler und einem bestimmten Kunden/einer bestimmten Kundin erstellen. Sie können jedoch für jede/n Ihrer Kunden/Ihrer Kundinnen eine Warnung für einen bestimmten Zähler erstellen.
• Warnungen funktionieren derzeit nicht mit Test-Uhren.