Alertes et seuilsBêta
Recevez des alertes lorsqu'un client dépasse un seuil d'utilisation ou déclenchez une facture lorsqu'il atteint un seuil de facturation.
Alertes d’utilisation
Vous pouvez mettre en place des alertes sur l’utilisation des dispositifs de mesure de façon à ce qu’elles déclenchent un webhook lorsque les clients atteignent des niveaux de consommation spécifiques. Les alertes peuvent s’appliquer à des clients spécifiques ou à tous les clients. Types d’alertes d’utilisation :
- Alerte d’utilisation unique par client : l’alerte se déclenche lorsqu’un client dépasse pour la première fois un niveau d’utilisation spécifique. Par exemple, vous créez une alerte unique pour les clients 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. Cette alerte ne se déclenche qu’une seule fois par client, quelle que soit l’utilisation future.
Vous pouvez utiliser les alertes d’utilisation dans les workflows de votre entreprise, par exemple dans les cas suivants :
- Envoyer un e-mail aux utilisateurs : permet aux utilisateurs de configurer des limites d’utilisation et de recevoir un e-mail lorsqu’ils atteignent leur seuil.
- Retirez l’accès : donnez aux utilisateurs un nombre libre d’unités d’utilisation de votre service et retirez-leur l’accès à ce service lorsqu’ils dépassent un certain seuil.
- Avertissez votre équipe commerciale des opportunités de vente incitative : avertissez votre équipe commerciale d’une opportunité de vente lorsqu’un utilisateur en libre-service dépasse un seuil d’utilisation.
Vous pouvez créer des alertes à l’aide du Dashboard ou de l’API.
Une fois que vous avez configuré une alerte et commencé à envoyer l’utilisation pour ce dispositif de mesure, vous devez écouter les webhooks.
Limites
- Les alertes ne sont pas évaluées à leur création et ne sont évaluées que sur les données d’utilisation comptabilisées après la création de l’alerte.
- Le nombre d’alertes est limité à 25 pour chaque champ d’application (c’est-à-dire une combinaison de filtres de dispositifs de mesure et de clients). Par exemple, vous ne pouvez pas créer plus de 25 alertes pour un dispositif et un client spécifiques. Cependant, vous pouvez créer une alerte pour un dispositif spécifique pour chacun de vos clients.
- Les alertes ne fonctionnent pas avec les horloges de simulation à l’heure actuelle.
Alertes de dépenses et de crédit
Vous pouvez définir des alertes lorsque les clients dépassent un certain montant de dépenses ou que leur solde créditeur est faible. Lorsque les clients atteignent ces seuils, l’alerte déclenche un webhook. Cliquez ici si vous souhaitez participer à la version bêta.
Seuils de facturation
Vous pouvez définir des seuils de facturation pour émettre une facture et, si vous le souhaitez, réinitialiser le cycle de facturation d’un abonnement lorsque l’utilisation cumulée d’un client au cours d’un cycle d’abonnement atteint un seuil monétaire spécifique. Vous pouvez définir des seuils de facturation pour limiter le montant dû cumulé ou la consommation de votre produit entre chaque facture ou paiement.
Ajouter un seuil monétaire à un abonnement
En règle générale, la valeur d’un seuil doit correspondre à un multiple du coût unitaire du produit vendu.
Si vous définissez un montant plus faible, vos clients recevront une facture pour chaque unité d’utilisation, ce qui peut être source de confusion.
La valeur est un entier positif exprimé dans l’unité monétaire la plus faible (par exemple, 100 centimes pour facturer 1 USD, ou 100 pour facturer 100 JPY, le JPY étant une devise sans décimale). Elle ne peut pas être inférieure à 50 unités monétaires.
Vous pouvez aussi définir des seuils monétaires dans le Dashboard lorsque vous créez ou modifiez un abonnement.
Ajouter un seuil d’utilisation à un poste d’abonnement
Définissez des seuils monétaires supérieurs à une unité d’utilisation afin d’éviter une facturation trop fréquente. Stripe ne prend pas en charge la définition de seuils d’utilisation dans le Dashboard.
Seuils et début du cycle de facturation
Par défaut, la date de début du cycle de facturation d’un abonnement reste inchangée lorsque l’utilisation d’un client atteint un seuil. Par exemple, si un seuil est atteint au milieu d’un abonnement d’un mois, l’abonnement sera réinitialisé à la fin du mois, comme pour un abonnement sans seuil.
Vous pouvez modifier ce comportement de façon à ce que la date de début du cycle de facturation soit réinitialisée quand un seuil est atteint. De cette façon, le déclenchement du seuil sera traité comme si l’abonnement avait atteint son point de reconduction naturel à la fin du mois.
Seuils et tarification échelonnée
Stripe applique également les niveaux aux factures à seuils. Comme pour les abonnements sans seuil, les niveaux sont réinitialisés à la fin de la période de facturation par défaut, ou si vous configurez l’abonnement de manière à réinitialiser la date de début du cycle de facturation lorsqu’un seuil est atteint.
Par exemple, imaginons que vous gérez une plateforme publicitaire qui utilise la grille tarifaire progressive (graduated
) suivante pour ses impressions publicitaires :
Niveau | Montant (coût unitaire) |
---|---|
1 à 10 000 (up_ ) | 0,50 USD (unit_ ) |
up_ ) | 0,40 USD (unit_ ) |
Étant donné que Stripe facture l’utilisation après coup, vous pouvez définir un seuil de 100 USD comme mesure temporaire pour les nouveaux clients. Dans cet exemple, votre client est facturé toutes les 200 impressions pour les 10 000 premières impressions (200 x 0,50 USD = 100 USD). Lorsque le client dépasse les 10 000 impressions, il est facturé toutes les 250 impressions (250 x 0,40 USD = 100 USD). Cela continue jusqu’à la fin de la période de facturation, stade auquel toute utilisation non facturée fait l’objet d’une nouvelle facturation. L’abonnement et les niveaux sont également réinitialisés.
Pour activer la réinitialisation des niveaux après avoir atteint un seuil, vous devez configurer l’abonnement de façon à réinitialiser la date de début du cycle de facturation lorsque l’utilisation atteint le seuil défini.
Tarification échelonnée au volume
La tarification échelonnée au volume assigne un même tarif à toutes les unités utilisées, contrairement à la tarification progressive qui assigne un tarif supplémentaire à chaque niveau de quantité franchi. Certains modèles tarifaires utilisent une tarification au volume afin de diminuer le tarif à l’unité au fur et à mesure que le nombre d’unités vendues augmente. Vous pouvez utiliser ces modèles pour encourager les clients à consommer vos produits (impressions publicitaires, Go de stockage, etc.) en plus grande quantité.
Associés à des seuils, ces modèles de tarification peuvent se traduire par des factures comportant des postes au montant négatif, dans les conditions suivantes :
- Une facture à seuils a déjà été émise.
- Les unités suivantes sont facturées à un coût unitaire plus faible.
Prenons l’exemple de la tarification échelonnée suivante :
Niveau | Montant (coût unitaire) |
---|---|
1 à 10 000 (up_ ) | 0,50 USD (unit_ ) |
up_ ) | 0,40 USD (unit_ ) |
Si un client utilise 10 000 unités, le total de la facture sera de 5 000 USD (10 000 x 0,50 USD = 5 000 USD). Quand l’utilisation dépasse 10 000 unités, toutes les unités utilisées sont alors facturées à un coût unitaire plus faible de 0,40 USD. Donc, si le client utilise une unité supplémentaire, le montant facturé diminue, pour atteindre seulement 4 000,40 USD (10 001 x 0,40 USD = 4 000,40 USD).
Si aucun seuil n’avait été défini, Stripe émettrait une facture d’un montant de 4 000,40 USD à la fin de la période de facturation.
Cependant, pour vous montrer comment cela peut aboutir à une facture négative, imaginons que nous ayons défini un seuil monétaire de 5 000 USD. Dans ce scénario, Stripe émet une facture dès le client atteint 10 000 unités utilisées.
Si le client utilise une unité supplémentaire, le total de la facture passe à 4 000,40 USD (10 001 x 0,40 USD = 4 000,40 USD). Toutefois, si le client ne consomme pas d’autres unités, il doit recevoir 999,60 USD (5 000 USD - 4 000,40 USD = 999,60 USD). En fin de période de facturation, Stripe crédite ce montant sur le solde du client, qui est utilisé pour le règlement des prochaines factures.
Imaginons que le client continue de cumuler de l’utilisation. Le coût de cette utilisation atteint 5 000 USD à nouveau lorsque le client a utilisé 12 500 unités (5 000 USD/0,40 USD = 12 500). Cependant, puisque le paiement précédent de 5 000 USD couvre déjà toutes ces utilisations, nous n’émettons pas de facture.
Stripe n’émettra pas de facture tant que l’utilisation totale n’aura pas atteint 25 000 unités (pour un coût total de 10 000 USD), ou tant que la période de facturation ne sera pas arrivée à son terme (selon la première de ces éventualités à survenir). Les tableaux ci-dessous montrent les postes affichés pour les deux factures émises dans le cas où l’utilisation atteindrait 25 000 unités.
Facture 1 :
Poste | Quantité | Montant |
---|---|---|
Utilisation (0,50 USD par unité) | 10 000 | 5 000 USD |
Total | 5 000 USD |
Facture 2 :
Poste | Quantité | Montant |
---|---|---|
Utilisation (0,40 USD par unité) | 25 000 | 10 000 USD |
Montant facturé précédemment (à 0,50 USD par unité) | - 5 000 USD | |
Total | 5 000 USD |
Limites
- Les seuils ne s’appliquent pas aux abonnements avec période d’essai.
- Les seuils monétaires doivent être supérieurs à la somme de tous les frais fixes sur les abonnements facturés à la consommation.
- Les seuils de facturation ne sont pas évalués durant les 24 heures précédant la fin d’un abonnement. Cela permet d’éviter toute confusion chez un client qui reçoit plusieurs factures à la même date.
- Vous ne pouvez définir qu’un seuil monétaire par abonnement.
- Vous ne pouvez définir qu’un seuil d’utilisation par poste d’abonnement.
- L’utilisation étant communiquée en temps réel, les factures peuvent ne pas être émises au moment exact où le seuil est atteint. L’utilisation ou les montants facturés peuvent être légèrement supérieurs aux seuils spécifiés.
- La valeur utilisée pour déterminer si un seuil monétaire a été atteint inclut les réductions, mais ne tient pas compte des taxes.
- La tarification forfaitaire et échelonnée n’est pas prise en charge actuellement
Écouter les webhooks
Pour finaliser votre intégration, vous devez traiter les webhooks envoyés par Stripe. Ces événements sont déclenchés à chaque fois qu’un changement d’état se produit dans Stripe, comme la création de nouveaux abonnements et de nouvelles factures. Dans votre application, configurez un gestionnaire HTTP de façon à ce qu’il accepte les requêtes POST contenant l’événement de webhook, et vérifiez la signature de l’événement :
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 le mode production, définissez une URL d’endpoint de webhook dans le Dashboard, ou utilisez l’API Webhook Endpoints.