# Bons de réduction et codes promotionnels Ajoutez des remises aux abonnements et aux éléments d'abonnement à l'aide de bons de réduction et de codes promotionnels. Si votre plateforme Connect utilise des [comptes configurés par le client](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer), consultez notre [guide](https://docs.stripe.com/connect/use-accounts-as-customers.md) pour remplacer dans votre code les références `Customer` et événements par les références équivalentes de l’API Comptes v2. 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. - [Bons de réduction](https://docs.stripe.com/billing/subscriptions/coupons.md#coupons) : Vous créez et gérez les bons de réduction pour définir des réductions, telles qu’un pourcentage ou un montant de réduction sur le prix de l’abonnement. - [Codes promotionnels](https://docs.stripe.com/billing/subscriptions/coupons.md#promotion-codes) : Vous créez des codes destinés aux clients qui correspondent à vos bons de réduction. Par exemple, les programmes PROMOAUTOMNE et PROMOPRINTEMPS peuvent tous deux être associés à un seul bon de réduction de 25 %. Vous pouvez partager les codes promotionnels directement avec vos clients, qui peuvent les saisir et les utiliser lors du paiement. 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](https://docs.stripe.com/payments/checkout/discounts.md). ## 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](https://docs.stripe.com/api/coupons/create.md) : #### Dashboard 1. Dans le Dashboard, ouvrez la page [Produits](https://dashboard.stripe.com/test/products?active=true). 1. Cliquez sur **Bons de réduction**. 1. Cliquez sur **+ Nouveau**. 1. Dans la boîte de dialogue **Créer un bon de réduction**, saisissez les paramètres du bon de réduction. 1. Cliquez sur **Créer un bon de réduction**. Voici tous les paramètres des bons de réduction. Le nom est le seul paramètre que vous pouvez modifier après avoir créé le bon de réduction. | Configuration | Désignation | | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Le nom du bon de réduction figurant sur les reçus et les factures. | | **ID** (optional) | L’identifiant unique du bon de réduction dans l’API. Si vous laissez ce champ vide, Stripe génère un ID à votre place. | | **Type** | Définit si un bon de réduction applique une ristourne sur un abonnement avec un montant fixe ou un pourcentage. | | **Pourcentage de réduction** ou **Montant de la réduction** | Indique la valeur du bon de réduction. Si vous vendez des produits ou services dans plusieurs devises, un seul bon de réduction peut définir des montants de réduction différents pour les différentes devises. Les bons de réduction multidevises observent les mêmes règles que les [bons de réduction multidevises](https://docs.stripe.com/products-prices/how-products-and-prices-work.md#multiple-currencies). | | **Appliquer à des produits spécifiques** (optional) | Limite le type de postes auxquels le bon de réduction peut s’appliquer. | | **Durée** | Indique la période pendant laquelle le bon de réduction est valide. | | **Limites d’utilisations** (optional) | Permet de définir la date limite du bon de réduction et le nombre de fois qu’un client peut l’utiliser. | | **Codes** (optional) | Permet de créer des [codes promotionnels](https://docs.stripe.com/billing/subscriptions/coupons.md#promotion-codes--promotion-codes) pour le bon de réduction. | #### API ```curl curl https://api.stripe.com/v1/coupons \ -u "<>:" \ -d duration=once \ -d id=free-period \ -d percent_off=100 ``` Le tableau suivant présente les paramètres des bons de réduction. | Configuration | Désignation | | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | L’identifiant unique du bon de réduction. | | `percent_off` ou`amount_off` | Le 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) (optional) | Si vous vendez des produits ou services dans plusieurs devises, montants à déduire du sous-total pour les différentes devises. Les bons de réduction multidevises observent les mêmes règles que les [bons de réduction multidevises](https://docs.stripe.com/products-prices/how-products-and-prices-work.md#multiple-currencies). | | `duration` | Indique la durée de validité du bon de réduction. Les valeurs comprennent **ponctuel**, **permanent** ou **récurrent**. | | `max_redemptions` (optional) | Nombre maximal d’utilisations d’un bon de réduction par l’ensemble des clients | | `redeem_by` (optional) | La date limite à laquelle vous pouvez encore appliquer ce bon de réduction aux clients. | | `applies_to` (optional) | Limite les postes d’une facture auxquels s’applique le bon de réduction. | ### Définir des produits éligibles #### Dashboard Pour définir les produits pouvant bénéficier de ristournes, ajoutez le produit de votre choix dans le champ **Appliquer à un produit spécifique**. Tout code promotionnel associé à ce bon de réduction peut uniquement être appliqué à cette liste de produits éligibles. 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. #### API 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 [apportez des modifications](https://docs.stripe.com/billing/subscriptions/change.md) à un abonnement, Stripe calcule le prorata et applique toutes les réductions existantes. Vous ne pouvez pas appliquer de réduction supplémentaire aux postes de prorata sur la facture 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](https://docs.stripe.com/api.md#update_subscription). #### Dashboard 1. Dans le Dashboard, ouvrez la page [Abonnements](https://dashboard.stripe.com/test/subscriptions?status=active). 1. Cliquez sur l’abonnement de votre choix. 1. Cliquez sur **Actions**. 1. Cliquez sur **Mettre à jour l’abonnement**. 1. Cliquez sur **Ajouter un bon de réduction**. 1. Sélectionnez un ou plusieurs bons de réduction dans les menus déroulants et cliquez sur **Envoyer**. #### API ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -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 sauvegardé, vous pouvez toujours créer un abonnement dès lors [qu’aucun paiement immédiat](https://docs.stripe.com/billing/subscriptions/deferred-payment.md) 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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-discounts). 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`. #### curl ```bash curl https://api.stripe.com/v1/checkout/sessions \ -u <>: \ -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" ``` ### Supprimer des bons de réduction Vous pouvez supprimer des bons de réduction à l’aide du Dashboard ou de l’[API](https://docs.stripe.com/api/coupons/delete.md). 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. #### Dashboard 1. Dans le Dashboard, ouvrez la page [Produits](https://dashboard.stripe.com/test/products?active=true). 1. Cliquez sur **Bons de réduction**. 1. Cliquez sur le bon de réduction de votre choix. 1. Cliquez sur le menu déroulant (⋯). 1. Cliquez sur **Supprimer le bon de réduction**. #### API ```curl curl -X DELETE https://api.stripe.com/v1/coupons/free-period \ -u "<>:" ``` ### Durée du bon de réduction La durée d’un [bon de réduction](https://docs.stripe.com/api/.md#discounts) 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. > Si vous appliquez un [bon de réduction](https://docs.stripe.com/billing/subscriptions/backdating.md) à un abonnement antidaté, la durée de validité du bon de réduction commence à courir à partir de la date de début de l’antidatation, et non à partir de la date à laquelle vous effectuez l’appel à l’API. Pour les bons de réduction `repeating`, ceci signifie que la période d’antidatation consomme une partie de la durée de validité du bon de réduction. La `duration_in_months` du bon de réduction doit être plus longue que la période d’antidatation si vous souhaitez que la réduction s’applique aux factures ultérieures à la période d’antidatation. Consultez la section [Antidatation et réductions](https://docs.stripe.com/billing/subscriptions/backdating.md#backdating-discounts) pour en savoir plus. ### 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* (The customer portal is a secure, Stripe-hosted page that lets your customers manage their subscriptions and billing details) 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. > Les abonnements appliquent le code promotionnel et les mises à jour de tarifs séparément, ce qui peut entraîner des mises à jour inattendues. Par exemple, un échec de paiement peut entraîner l’échec d’une augmentation tarifaire, mais le code promotionnel compris dans le changement tarifaire peut aboutir. > Le portail client affiche les codes promotionnels qui ont été appliqués à un abonnement. Si vous ne souhaitez pas autoriser les clients à appliquer eux-mêmes le code promotionnel ou potentiellement à le partager avec d’autres personnes, vous devez soit [définir des limites au code promotionnel](https://docs.stripe.com/billing/subscriptions/coupons.md#promo-code-config), soit [appliquer un bon de réduction](https://docs.stripe.com/billing/subscriptions/coupons.md#discount-Subscriptions) directement. 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. - Vous ne pouvez pas appliquer un code promotionnel lorsque les objets suivants ont des restrictions de montant : - [Objets Subscription Item](https://docs.stripe.com/api/subscription_items/object.md) - [Objets poste de facture](https://docs.stripe.com/api/invoiceitems/object.md) - [Objets Subscriptions](https://docs.stripe.com/api/subscriptions/object.md) lorsque vous effectuez une mise à jour - Phases à venir des [objets Subscription Schedule](https://docs.stripe.com/api/subscription_schedules/object.md) ### Créer des codes promotionnels #### Dashboard Vous pouvez créer un code promotionnel dans le Dashboard au moment de [créer un bon de réduction](https://docs.stripe.com/billing/subscriptions/coupons.md#create-coupons--create-coupons). 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 un **code**, le [désactiver](https://docs.stripe.com/billing/subscriptions/coupons.md#inactive-promotions--inactivate) et en créer un nouveau avec le même **code**. 1. Sur la page [Créer un bon de réduction](https://dashboard.stripe.com/test/coupons/create) du Dashboard, cliquez sur le bouton **Utiliser des codes de réduction à saisir par les clients**. 1. Saisissez un code. Il s’agit du code que le client saisit lors du paiement pour utiliser la ristourne. Si vous ne définissez pas de code, Stripe en génèrera un automatiquement. 1. Sélectionnez les conditions d’application de votre code promotionnel. Par exemple, vous pouvez restreindre l’utilisation du bon de réduction aux premières commandes uniquement. #### API 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](https://docs.stripe.com/api/promotion_codes.md), 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. ```curl curl https://api.stripe.com/v1/promotion_codes \ -u "<>:" \ -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é #### Dashboard Pour restreindre l’utilisation d’un code promotionnel à un utilisateur donné, suivez les étapes ci-après : 1. Sur la page [Créer un bon de réduction](https://dashboard.stripe.com/test/coupons/create), sélectionnez **Limiter à un client spécifique**. 1. Sélectionnez le client de votre choix. Si vous n’en précisez pas, le code peut être utilisé par n’importe quel client. #### API 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 Ce paramètre limite l’utilisation du bon de réduction aux clients qui n’ont jamais effectué de transaction sur votre plateforme. Il empêche les clients d’utiliser le bon de réduction s’ils : - Ont lancé une PaymentIntent, même si le paiement n’a jamais été effectué. - Ont souscrit à une période d’essai, même si celle-ci a été annulée par la suite. #### Dashboard Pour limiter un code promotionnel aux nouveaux clients, sélectionnez **Admissible à la première commande uniquement** sur la page [créer un bon de réduction](https://dashboard.stripe.com/test/coupons/create). #### API Limitez le code promotionnel aux nouveaux clients en définissant le paramètre `first_time_transaction` de l’attribut `restrictions`. ### Définir un montant minimum #### Dashboard Pour définir le montant à partir duquel un client peut bénéficier d’un code promotionnel, accédez à la page [Créer un bon de réduction](https://dashboard.stripe.com/test/coupons/create), sélectionnez **Exiger une valeur de commande minimale** et saisissez la valeur minimale. É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 le bon de réduction prend en charge plusieurs devises, le montant minimal peut être différent selon la devise. #### API 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 #### Dashboard Pour définir la date d’expiration d’un code promotionnel, accédez à la page [Créer un bon de réduction](https://dashboard.stripe.com/test/coupons/create), sélectionnez **Ajouter une date d’expiration** ainsi que la date et heure à laquelle le code expire. Si la date d’expiration du bon de réduction sous-jacent a déjà été définie, alors vous ne pouvez pas définir une date d’expiration ultérieure pour le code promotionnel. 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. Pour ce faire, définissez la date d’expiration du bon de réduction sur un an à partir de la date du jour, et la date d’expiration du code promotionnel sur une semaine après sa création. #### API 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 #### Dashboard Pour définir le nombre total d’utilisations d’un code promotionnel par vos clients, sélectionnez **Limiter le nombre d’utilisations de ce code** sur la page[Créer un bon de réduction](https://dashboard.stripe.com/test/coupons/create) et saisissez le nombre. Consultez la section [Limites de remboursement](https://docs.stripe.com/billing/subscriptions/coupons.md#redemption-limits) pour plus de détails. Si le nombre maximal d’utilisations du bon de réduction sous-jacent a déjà été défini, alors vous ne pouvez pas définir un nombre supérieur pour le code promotionnel. #### API Limitez le nombre total d’utilisations d’un code promotionnel par vos clients en utilisant `max_redemptions`, qui fonctionne de la même manière que les bons de réduction. Si le bon de réduction sous-jacent est déjà associé à `max_redemptions`, le`max_redemptions` du code promotionnel ne peut pas être supérieur à celui du bon de réduction. Consultez la section [Limites de remboursement](https://docs.stripe.com/billing/subscriptions/coupons.md#redemption-limits) pour plus de détails. ### Désactiver les codes promotionnels #### Dashboard Pour désactiver un code promotionnel, procédez comme suit : 1. Dans le Dashboard, ouvrez la page [Produits](https://dashboard.stripe.com/test/products?active=true). 1. Cliquez sur **Bons de réduction**. 1. Cliquez sur le bon de réduction dont le code promotionnel doit être désactivé. 1. Dans la ligne du code promotionnel correspondant, cliquez sur le menu déroulant (⋯). 1. Cliquez sur **Archiver le code promotionnel**. 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 sa limite d’utilisation ou sa date d’expiration, il devient définitivement inactif. Ces codes promotionnels ne peuvent pas être réactivés. #### API 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 : - Lorsque vous [créez un abonnement](https://docs.stripe.com/api.md#create_subscription) - Lorsque vous [mettez à jour l’abonnement existant d’un client](https://docs.stripe.com/api.md#update_subscription) #### Dashboard 1. Dans le Dashboard, accédez à **Facturation** > **Abonnements**. 1. Cliquez sur l’abonnement de votre choix. 1. Cliquez sur **Actions** > **Mettre à jour l’abonnement** > **Ajouter un bon de réduction**. 1. Cliquez sur un code promotionnel dans le menu déroulant, puis sur **Envoyer**. #### API 1. [Dressez la liste](https://docs.stripe.com/api/promotion_codes/list.md) des codes promotionnels et utilisez le [code](https://docs.stripe.com/api/promotion_codes/list.md#list_promotion_code-code) de votre objet Customer comme filtre pour [récupérer](https://docs.stripe.com/api/promotion_codes/retrieve.md) l’[ID du code promotionnel](https://docs.stripe.com/api/promotion_codes/object.md#promotion_code_object-id). 1. Pour appliquer le code promotionnel, utilisez l’ID du code promotionnel dans l’appel à l’API suivant : ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d customer="{{CUSTOMER_ID}}" \ -d "items[0][price]"="{{PRICE_ID}}" \ -d "discounts[0][promotion_code]"="{{PROMOTIONCODE_ID}}" ``` ### Ajouter des codes promotionnels à Checkout Activez des codes promotionnels via l’API en définissant le paramètre [allow_promotion_codes](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-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](https://b.stripecdn.com/docs-statics-srv/assets/promo_code_checkout.c07ef6d4f0b1b3f9a8a7e4bbba83d56f.png) 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](https://docs.stripe.com/api/.md#discounts) utilisés à la liste des paiements d’un client. Vous pouvez le faire lors de la [création d’un abonnement](https://docs.stripe.com/api.md#create_subscription) ou en [mettant à jour l’abonnement existant d’un client](https://docs.stripe.com/api.md#update_subscription). Nous prenons en charge les bons de réduction multiples sur les abonnements et les éléments d’abonnement. Lorsque vous créez un abonnement avec des remises cumulables, chaque réduction s’applique à tous les articles de l’abonnement. L’ordre des remises est important si vous utilisez à la fois `amount_off` et `percent_off`. Par exemple, les remises cumulées suivantes s’appliquent différemment : - 20 % de réduction, *puis* 5 USD de remise - 5 USD de réduction, *puis* 20 % de remise #### Dashboard 1. Dans le Dashboard, accédez à **Facturation** > **Abonnements**. 1. Cliquez sur l’abonnement de votre choix. 1. Cliquez sur **Actions** > **Mettre à jour l’abonnement** > **Ajouter un bon de réduction**. 1. Cliquez sur des bons de réduction à partir des menus déroulants et cliquez sur **Envoyer**. 1. Cliquez sur le produit concerné. 1. Cliquez sur **Ajouter des bons de réduction**. 1. Cliquez sur des bons de réduction à partir des menus déroulants et cliquez sur **Envoyer**. #### API ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -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 utiliser simultanément un bon de réduction et un code promotionnel créé à partir du même bon de réduction. - Vous ne pouvez pas utiliser simultanément un bon de réduction et une remise créée à partir du 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 : - Ajouter un [solde négatif au client](https://docs.stripe.com/api.md#customer_object-balance). - Ajoutez des [postes de facture](https://docs.stripe.com/billing/invoices/subscription.md#adding-draft-invoice-items) négatifs. - Ajoutez au produit un [deuxième tarif](https://docs.stripe.com/products-prices/manage-prices.md#create-price) moins élevé que le tarif habituel. 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). ## See also - [Modification des abonnements](https://docs.stripe.com/billing/subscriptions/change.md) - [Utilisation des factures](https://docs.stripe.com/billing/invoices/subscription.md) - [API Coupons](https://docs.stripe.com/api.md#coupons) - [API Promotion codes](https://docs.stripe.com/api.md#promotion_codes)