# Définir des seuils Définissez des seuils d’utilisation pour déclencher des alertes ou des factures. Définissez des seuils de facturation pour limiter le montant dû ou les produits consommés entre les factures ou les paiements. ## Créer des seuils de facturation Vous pouvez créer des [seuils_de_facturation](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-billing_thresholds) pour émettre une *invoice* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) lorsque l’utilisation accumulée d’un client au cours d’une période de service atteint un seuil monétaire spécifique. Vous pouvez également réinitialiser [l’ancre_du_cycle_de facturation](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-billing_thresholds-reset_billing_cycle_anchor) d’un abonnement lorsqu’un client atteint le seuil monétaire. Il est conseillé d’utiliser des seuils de facturation si vous voulez limiter le montant dû, ou limiter les produits utilisés, entre les factures et les paiements. ### Seuils monétaires Lorsque vous ajoutez un seuil monétaire à un abonnement, définissez la valeur comme un multiple du coût unitaire du produit vendu. Si vous définissez un montant inférieur pour ce seuil, vos clients recevront une facture pour chaque unité d’utilisation. La valeur est un entier positif dans la [plus petite unité monétaire](https://docs.stripe.com/currencies.md#zero-decimal) (par exemple, 100 cents pour facturer 1 USD, ou 100 pour facturer 100 JPY, une devise décimale nulle). Définissez la valeur sur au moins 50 unités monétaires. Vous pouvez définir des seuils monétaires pour un abonnement à l’aide du [Dashboard](https://dashboard.stripe.com/test/subscriptions) ou de l’API Stripe. ```curl curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \ -u "<>:" \ -d "billing_thresholds[amount_gte]=10000" \ -d "billing_thresholds[reset_billing_cycle_anchor]=false" ``` ### Seuils d’utilisation Lorsque vous ajoutez un seuil d’utilisation à un poste d’abonnement, définissez une valeur supérieure à 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. ```curl curl https://api.stripe.com/v1/subscription_items/si_CFhSgkWb0MyTWg \ -u "<>:" \ -d "billing_thresholds[usage_gte]=2000" ``` ### Seuils et début du cycle de facturation Par défaut, la [date de début du cycle de facturation](https://docs.stripe.com/billing/subscriptions/billing-cycle.md) d’un abonnement reste inchangée une fois qu’un client a atteint le seuil d’utilisation. Si un client atteint le seuil 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 le comportement par défaut en configurant l’abonnement pour réinitialiser la date de début du cycle de facturation une fois le seuil atteint. De cette façon, Stripe traitera ce comportement comme si l’abonnement avait atteint son point de reconduction naturel à la fin du mois. ```curl curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \ -u "<>:" \ -d "billing_thresholds[reset_billing_cycle_anchor]=true" ``` ### Seuils et tarification échelonnée Stripe applique également les niveaux aux factures à seuils. Par défaut, les niveaux sont réinitialisés à la fin de chaque période de facturation. Vous pouvez modifier le comportement par défaut en configurant l’abonnement de manière à réinitialiser la date de début du cycle de facturation lorsqu’un seuil est atteint, comme pour un abonnement sans seuil. Par exemple, imaginons que vous gérez une plateforme publicitaire qui utilise la grille tarifaire progressive suivante pour ses impressions publicitaires : | Niveau | Montant (coût unitaire) | | ------------------------------- | -------------------------------- | | 1 à 10 000 (`up_to=10000`) | 0,50 USD (`unit_amount=50`) | | de 10 000 (`up_to=inf`) | 0,40 USD (`unit_amount=40`) | Dans la mesure où Stripe facture l’utilisation a posteriori, vous pouvez définir un seuil temporaire de 100 USD pour les nouveaux clients. Dans le cadre de ce forfait, vous facturez votre client toutes les 200 impressions pour les 10 000 premières impressions (200 × 0,50 USD = 100 USD). Lorsque le client dépasse 10 000 impressions, il est facturé toutes les 250 impressions (250 × 0,40 USD = 100 USD). Cette opération se poursuit jusqu’à la fin de la période de facturation, après quoi vous pouvez facturer toutes les utilisations qui ne l’ont pas été précédemment, ainsi que réinitialiser l’abonnement et les niveaux. 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. - Toute utilisation ultérieure est facturée aux clients à un coût unitaire inférieur. Prenons l’exemple de la tarification échelonnée suivante : | Niveau | Montant (coût unitaire) | | ------------------------------- | -------------------------------- | | 1 à 10 000 (`up_to=10000`) | 0,50 USD (`unit_amount=50`) | | de 10 000 (`up_to=inf`) | 0,40 USD (`unit_amount=40`) | Si un client utilise 10 000 unités, le montant total de la facture est de 5 000 USD (10 000 × 0,50 USD = 5 000 USD). Lorsque 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. Si le client utilise une unité supplémentaire, le total de la facture *baisse* à 4 000,40 USD (10,001 × 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. Pour illustrer le fonctionnement d’une facturation négative, supposons que vous définissiez un seuil monétaire de 5 000 USD. Dans ce scénario, Stripe émet une facture lorsque le client atteint 10 000 unités d’utilisation. Si le client utilise une unité supplémentaire, le total de la facture tombe à 4 000,40 USD (10 001 × 0,40 USD = 4 000,40 USD). Cependant, si le client ne consomme pas plus d’unités, la plateforme lui *doit* 999,60 USD (5 000 USD − 4 000,40 USD = 999,60 USD). À la fin de la période de facturation, Stripe crédite ce montant sur le solde du client, que nous utilisons pour payer les factures futures. Si l’utilisation par le client continue d’augmenter, le coût de cette utilisation atteint à nouveau 5 000 USD lorsque le client utilise 12 500 unités (5 000 USD / 0,40 USD = 12 500). Cependant, le paiement précédent de 5 000 USD couvre la totalité de cette utilisation. Par conséquent, 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). Les tableaux ci-dessous présentent les postes affichés pour les deux factures émises dans le cas où l’utilisation atteint 25 000 unités. Facture 1 : | Poste de facture | Quantité | Montant | | ------------------------------------- | ----------- | ----------------------- | | Utilisation (0,50 USD par unité) | 10 000 | 5 000 USD | | **Total** | | **5 000 USD** | Facture 2 : | Poste de facture | 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** |