Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous
Aperçu
Billing

Bons de réduction et codes promotionnels flexibles

Ajoutez des remises aux abonnements et aux éléments d'abonnement à l'aide de bons de réduction et de codes promotionnels.

Copier la page

Utilisez des bons de réduction pour appliquer des ristournes sur les abonnements que vous proposez. Vous pouvez également les utiliser pour créer des codes promotionnels à partager avec vos clients. Avec ces codes, ils pourront appliquer des ristournes à leurs abonnements.

Vous pouvez utiliser des bons de réduction et des codes promotionnels pour :

  • Appliquer une ou plusieurs réductions à une facture, un abonnement ou un poste d’abonnement
  • Appliquer une ou plusieurs réductions pendant une durée donnée
  • Réduire le montant des factures en appliquant un pourcentage ou un montant fixe

Vous pouvez également définir un bon de réduction qui doit être utilisé avant une date limite par un client, ou qui est limité à un certain nombre d’utilisations par l’ensemble de vos clients.

Afin d’utiliser des réductions pour des paiements ponctuels, veuillez consulter la page Ajouter des réductions pour les paiements ponctuels.

Bons de réduction

Pour appliquer des ristournes à un client ou au paiement d’un client, utilisez les bons de réduction. Découvrez comment créer et gérer les bons de réduction dans les sections suivantes.

Créer un bon de réduction

Créez des bons de réduction dans le Dashboard ou via l’API :

Command Line
curl https://api.stripe.com/v1/coupons \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d duration=once \
  -d id=free-period \
  -d percent_off=100

Le tableau suivant présente les paramètres des bons de réduction.

ParamètreDescription
idL’identifiant unique du bon de réduction.
percent_off ou amount_offLe montant qui est déduit du sous-total pour la durée du bon de réduction.
currency (si amount_off est défini)Le code ISO à trois lettres de la devise du montant à prélever.
currency_options (si amount_off est défini) optionalSi vous commercialisez en plusieurs devises, montants à déduire du sous-total pour les différentes devises. Les bons de réduction multi-devises observent les mêmes règles que les tarifs multi-devises.
durationIndique la durée de validité du bon de réduction. Les valeurs comprennent ponctuel, permanent ou récurrent.
max_redemptions optionalNombre maximal d’utilisations d’un bon de réduction par l’ensemble des clients
redeem_by optionalLa date limite à laquelle vous pouvez encore appliquer ce bon de réduction aux clients.
applies_to optionalLimite les postes d’une facture auxquels s’applique le bon de réduction.

Vous pouvez uniquement modifier le nom du bon de réduction après sa création.

Définir des produits éligibles

Pour définir les produits pouvant bénéficier de ristournes, ajoutez les ID des produits de votre choix au hash applies_to du bon de réduction. Cette liste de produits éligibles s’applique également aux codes promotionnels associés au bon de réduction.

Si vous configurez un bon de réduction de sorte qu’il s’applique à des produits spécifiques et que vous l’attribuez à un abonnement qui ne contient aucun de ces produits, aucune ristourne ne sera accordée.

Lorsque vous modifiez un abonnement, toutes les réductions existantes sont appliquées au stade du calcul du prorata. Vous ne pouvez pas appliquer de réduction supplémentaire aux postes de prorata sur la facture qui est générée.

Appliquer des bons de réduction aux abonnements

Après avoir créé un bon de réduction, appliquez-le à un abonnement pour créer une réduction. Vous pouvez appliquer le bon de réduction lors de la création de l’abonnement ou en modifiant l’abonnement existant d’un client.

Command Line
curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d "items[0][price]"=
{{PRICE_ID}}
 \
  -d "discounts[0][coupon]"=free-period

Même si un client ne dispose pas d’un moyen de paiement enregistré, vous pouvez créer un abonnement dès lors qu’aucun paiement immédiat n’est requis après l’application d’un bon de réduction.

Appliquer des bons de réduction à Checkout

Appliquez des bons de réduction aux abonnements au cours d’une session Checkout en définissant le paramètre discounts dans l’API. Pour créer une session avec une réduction appliquée, transmettez l’ID du bon de réduction dans le paramètre coupon du tableau discounts.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[]"=card \
  -d "line_items[][price]"=
{{PRICE_ID}}
 \
  -d "line_items[][quantity]"=1 \
  -d mode=subscription \
  -d "discounts[][coupon]"="{{COUPON_ID}}" \
  -d success_url="https://example.com/success" \
  -d cancel_url="https://example.com/cancel"

Supprimer des bons de réduction

Vous pouvez supprimer des bons de réduction à l’aide du Dashboard ou de l’API.

En supprimant un bon de réduction, vous empêchez que celui-ci soit appliqué à de futurs abonnements ou factures. Toutefois, cette opération ne supprime pas les réductions qui ont déjà été appliquées.

Command Line
curl -X DELETE https://api.stripe.com/v1/coupons/free-period \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Durée du bon de réduction

La durée d’un bon de réduction indique sa période de validité. Par exemple, un bon de réduction de -50 % d’une durée de 4 mois s’applique à toutes les factures sur la période de 4 mois suivant la première application du bon de réduction. Si un client l’applique à un abonnement annuel pendant cette période, la réduction de -50 % s’applique à l’intégralité de l’abonnement annuel. Dans le cas d’un abonnement mensuel, le bon s’applique aux 4 premiers mois seulement. Dans le cas d’un abonnement hebdomadaire, il s’applique à chaque facture durant les 4 premiers mois.

Lorsque vous configurez la durée de validité d’un bon de réduction dans l’API, si vous utilisez la valeur repeating vous devez spécifier la duration_in_months, soit le nombre de mois durant lesquels le bon de réduction sera valable. Si vous utilisez la valeur once, le bon de réduction ne sera valable que pour la première facture. Si vous utilisez la valeur forever, le bon de réduction sera valable indéfiniment et pour toutes les factures.

Limites d’utilisations

Les limites d’utilisations s’appliquent de la même manière à tous les clients. Par exemple, si vous limitez le nombre d’utilisations du bon à 50, vous pouvez l’appliquer à vos clients seulement 50 fois. Autrement dit, il peut être appliqué à 50 clients différents, à un seul client (50 fois), ou encore à plusieurs clients (plusieurs fois chacun) jusqu’à atteindre le seuil maximal de 50.

Si vous définissez un bon de réduction de sorte qu’il dure indéfiniment lorsqu’il est utilisé par un client mais qu’il possède une date d’expiration, tout client qui reçoit ce bon de réduction pourra bénéficier d’une ristourne pour toujours. Toutefois, aucun client ne pourra appliquer le bon de réduction une fois la date d’expiration passée.

Codes promotionnels

Les codes promotionnels sont des codes destinés aux clients que vous créez en guise de bons de réduction. Par exemple, FALLPROMO et SPRINGPROMO peuvent tous deux renvoyer vers un même bon de réduction de 25 %. Vous pouvez partager directement des codes promotionnels avec les clients afin qu’ils les utilisent lors du paiement.

Si vous avez déployé le portail client et activé les codes promotionnels, vos clients peuvent appliquer une réduction lorsqu’ils passent à un abonnement supérieur ou inférieur dans le portail.

Définissez les contrôles et les limites applicables à vos codes promotionnels : clients éligibles, première commande uniquement, valeur de commande minimale, date d’expiration ou encore nombre maximal d’utilisations.

Restrictions

Les codes promotionnels sont soumis à certaines restrictions.

Créer des codes promotionnels

Le code est insensible à la casse et unique à l’échelle de tous les codes promotionnels actifs pour tous les clients. Par exemple :

  • Vous pouvez créer plusieurs codes promotionnels à l’usage de clients spécifiques avec le même code, mais vous ne pouvez pas réutiliser ce code pour créer un code promotionnel à l’usage de tous les clients.
  • Si vous créez un code promotionnel que n’importe quel client peut utiliser, vous ne pouvez pas créer un autre code promotionnel actif avec le même code.
  • Vous pouvez créer un code promotionnel avec code: NEWUSER, le désactiver en transmettant active: false, puis créer un nouveau code promotionnel avec code: NEWUSER.

Pour créer un code promotionnel, spécifiez un coupon existant et indiquez toute restriction applicable (par exemple, limitation à un customer particulier). Si vous avez un code spécifique que vous souhaitez communiquer à votre client (par exemple FALL25OFF), définissez le champ code. Si vous laissez ce champ vide, Stripe génèrera un code aléatoire pour votre client.

Command Line
curl https://api.stripe.com/v1/promotion_codes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d coupon=ZQO00CcH \
  -d code=ALICE20 \
  -d customer=
{{CUSTOMER_ID}}

Lorsque vous créez un code promotionnel, celui-ci hérite de la configuration du bon de réduction auquel il est rattaché.

Configuration des codes promotionnels

En configurant les paramètres du code promotionnel, vous pouvez définir les éléments suivants :

  • Les clients pouvant bénéficier du code promotionnel
  • Le nombre de fois que le client peut utiliser le code promotionnel
  • La date à laquelle un code promotionnel expire
  • Définir le montant à partir duquel le code promotionnel peut s’appliquer

Limiter à un client donné

Pour limiter un code promotionnel à un client en particulier, précisez un customer lorsque de sa création. Si aucun client n’est précisé, le code peut être utilisé par n’importe quel client.

Limiter à la première commande

Restreignez l’utilisation du code promotionnel aux clients passant leur première commande, au moyen du paramètre first_time_transaction de l’attribut restrictions. Si customer n’est pas défini, ou si un customer sans aucun paiement précédent ou aucune facture non nulle est défini, la commande est considérée comme une première transaction.

Définir un montant minimum

Avec les codes promotionnels, vous pouvez fixer pour la ristourne un montant de transaction minimal comme condition d’éligibilité en configurant les propriétés minimum_amount et minimum_amount_currency. Étant donné que les restrictions applicables aux codes promotionnels sont vérifiées au moment de l’utilisation du bon de réduction, le montant de transaction minimal ne s’applique qu’au paiement initial pour un abonnement. Si vous commercialisez en plusieurs devises, définissez le montant de transaction minimum pour chaque devise au moyen de la propriété currency_options.

Personnaliser les dates d’expiration

Définissez une date d’expiration pour le code promotionnel avec expires_at. Si redeem_by est déjà défini pour le bon de réduction sous-jacent, alors vous ne pouvez pas définir une date d’expiration ultérieure pour le code promotionnel. Si promotion_code[expires_at] n’est pas spécifié, expires_at prend automatiquement la valeur redeem_by du bon de réduction.

  • Par exemple, vous prévoyez de proposer un bon de réduction pendant un an, mais vous souhaitez qu’il ne puisse être utilisé que durant la semaine suivant sa réception par le client. Vous définissez alors coupon[redeem_by] sur un an à partir de la date du jour, et chaque valeur promotion_code[expires_at] sur une semaine après sa création.

Limiter le nombre d’utilisations

Limitez le nombre d’utilisations avec max_redemptions, qui fonctionne de la même manière que les bons de réduction. Si le bon de réduction sous-jacent comporte déjà une max_redemptions définie, alors la valeur max_redemptions du code promotionnel ne peut pas être supérieure à celle du bon de réduction.

Désactiver les codes promotionnels

Déterminez au moyen du paramètre active si un code promotionnel est actuellement utilisable. Toutefois, si le bon de réduction sous-jacent pour un code promotionnel devient non valable, tous les codes promotionnels associés seront définitivement désactivés. De la même manière, si un code promotionnel atteint les seuils définis par max_redemptions ou expires_at, il devient définitivement inactif. Ces codes promotionnels ne peuvent pas être réactivés.

Appliquer des codes promotionnels aux abonnements

Après avoir créé un code promotionnel, vous pouvez bénéficier d’une réduction en appliquant le code promotionnel à un abonnement. Vous pouvez appliquer les codes promotionnels de deux manières :

  1. Dressez la liste des codes promotionnels et utilisez le code de votre objet Customer comme filtre pour récupérer l’ID du code promotionnel.
  2. Pour appliquer le code promotionnel, utilisez l’ID du code promotionnel dans l’appel à l’API suivant :
Command Line
curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d "items[0][price]"=
{{PRICE_ID}}
 \
  -d "discounts[0][promotion_code]"=
{{PROMOTION_CODE_ID}}

Ajouter des codes promotionnels à Checkout

Activez des codes promotionnels via l’API en définissant le paramètre allow_promotion_codes dans les sessions Checkout. Lorsque allow_promotion_codes est activé dans une session Checkout, un champ de code promotionnel est proposé à vos clients.

Champ destiné au code promotionnel au moment du paiement

Champ destiné au code promotionnel au moment du paiement

Bons de réduction et codes promotionnels cumulables

Vous pouvez ajouter plusieurs bons de réduction, codes promotionnels ou réductions utilisés à la liste des paiements d’un client. Vous pouvez le faire lors de la création d’un abonnement ou en mettant à jour l’abonnement existant d’un client.

Nous prenons en charge les bons de réduction multiples sur les abonnements et les éléments d’abonnement.

When you create a subscription with stackable discounts, each discount applies to all items on the subscription. The order of the discounts is important if you use both amount_off and percent_off. For example, the following stacked discounts apply differently:

  • 20 % de réduction, puis 5 $ de remise
  • 5 $ de remise, puis 20 % de réduction
Command Line
curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d "items[0][price]"=
{{PRICE_ID}}
 \
  -d "items[0][discounts][0][coupon]"=item-coupon \
  -d "items[0][discounts][1][promotion_code]"=item-promo \
  -d "discounts[0][coupon]"=sub-coupon \
  -d "discounts[1][promotion_code]"=sub-promo

Restrictions

L’utilisation de bons de réduction multiples est soumise à certaines restrictions.

  • Vous pouvez définir jusqu’à 20 entrées dans le paramètre discounts.
  • Chaque entrée dans discounts doit être unique.
  • Vous ne pouvez pas transmettre un bon de réduction et un code promotionnel créé à partir du même bon de réduction.
  • Vous ne pouvez pas transmettre un bon de réduction et une remise générée par le même bon de réduction.
  • Les bons de réduction utilisés doivent déjà être associés au client ou à l’abonnement que vous mettez à jour.

Mettre un abonnement à jour

Il n’est pas nécessaire de définir le paramètre discounts si vous n’avez pas l’intention de modifier des remises existantes.

Lorsque vous mettez à jour le paramètre discounts, vous devez transmettre les bons de réduction (coupon), codes promotionnels (promotion_code) ou remises (discount) précédemment définis que vous souhaitez conserver dans l’abonnement.

Transmettez discounts = "" pour supprimer toutes les remises de l’abonnement. Lorsqu’un abonnement ne comporte aucune remise, la remise associée au client (le cas échéant) s’applique aux factures.

Si vous avez déjà défini plus d’une remise sur un abonnement avec le nouveau paramètre discounts, vous ne pouvez pas mettre à jour l’abonnement avec le paramètre obsolète coupon ou promotion_code. De même, vous ne pouvez pas mettre à jour les phases d’un calendrier avec le paramètre obsolète coupon ou promotion_code si vous avez défini plus d’une remise sur une phase antérieure.

La mise à jour du paramètre discounts n’entraîne pas de calcul au prorata et ne génère pas de facture. Les nouvelles remises sont appliquées à la prochaine facture d’abonnement.

Autres moyens pour appliquer des ristournes

Bien que les bons de réduction représentent la façon la plus courante d’appliquer une ristourne à un abonnement, il existe d’autres moyens de le faire. Par exemple :

Parmi ces possibilités, les postes de facture négatifs fournissent le plus d’informations concernant la ristourne (par exemple sa nature, la date et la raison de sa création).

Voir aussi

Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc