Configurer des alertes basées sur l’utilisationVersion bêta publique

Configurez des alertes pour vous avertir lorsque les clients dépassent les seuils d’utilisation des dispositifs de mesure, ou pour déclencher une facture lorsque les clients atteignent un seuil de facturation spécifique. Vous pouvez créer des alertes qui s’appliquent à des clients spécifiques ou à tous les clients.

Avant de commencer

Vous devez créer un dispositif de mesure avant de créer une alerte.

Créer des alertes d’utilisation

Vous pouvez configurer les alertes à l’aide du Dashboard ou de l’API Stripe.

Par exemple, vous pouvez créer une alerte ponctuelle pour les clients qui se déclenche lorsqu’ils atteignent 100 appels à l’API. Lorsqu’un client atteint 100 appels à l’API, vous recevez un webhook vous informant que le client a dépassé le seuil.

Stripe fournit un type d’alerte d’utilisation appelé One-time per-customer usage alert. Cette alerte se déclenche lorsqu’un client dépasse le niveau d’utilisation indiqué pour la première fois, et ne se déclenche qu’une seule fois par client, quelle que soit l’utilisation future.

Écouter les webhooks

Une fois que vous avez configuré une alerte et commencé à envoyer les données d’utilisation pour ce dispositif de mesure, vous pouvez écouter les webhooks. Ces événements se déclenchent en cas de changement d’état dans Stripe, comme la création d’un abonnement ou d’une facture.

Dans votre application, configurez un gestionnaire HTTP afin qu’il accepte une requête POST contenant l’événement de webhook, puis vérifiez la signature de l’événement.

# 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?

Pendant le développement, utilisez l’interface de ligne de commande de Stripe pour suivre les webhooks et les transférer vers votre application. Exécutez la commande suivante dans un nouveau terminal pendant que votre application de développement est en cours d’exécution :

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

Pour la production, configurez une URL d’endpoint de webhook dans le Dashboard ou utilisez des endpoints de webhook.

Limitations

Tenez compte des limitations suivantes pour les alertes d’utilisation :

• Les alertes ne sont évaluées que sur la base des données d’utilisation signalées après leur création.
• Vous ne pouvez pas créer plus de 25 alertes pour chaque combinaison d’un dispositif de mesure et d’un client spécifiques. Cependant, vous pouvez créer une alerte pour un dispositif de mesure spécifique pour chacun de vos clients.
• Actuellement, les alertes ne fonctionnent pas avec les horloges de simulation.