Ajouter des réductions

Vous pouvez utiliser des réductions pour réduire le montant facturé à un client. Les bons de réduction et les codes promotionnels vous permettent d’effectuer ce qui suit :

• Appliquer une réduction à l’ensemble du sous-total de l’achat
• Appliquer une réduction à des produits spécifiques
• Déduire un pourcentage ou un montant fixe du total facturé
• Créer des codes promotionnels destinés aux clients en plus de bons de réduction à partager directement avec les clients

Créer un bon de réduction

Les bons de réduction offrent une remise d’un montant fixe. Vous pouvez créer des codes de promotion destinés à vos clients associés à un même bon de réduction sous-jacent. Ainsi, les codes FALLPROMO et SPRINGPROMO peuvent tous les deux pointer vers un bon de réduction de 25 %. Vous pouvez créer des bons de réduction dans le Dashboard ou avec l’API :

curl https://api.stripe.com/v1/coupons \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d percent_off=20 \
  -d duration=once

Utiliser un bon de réduction

Pour créer une session avec une remise appliquée, transmettez l’ID du bon de réduction dans le paramètre coupon du tableau discounts. Les sessions Checkout prennent en charge jusqu’à un code de réduction ou de promotion.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d "discounts[0][coupon]"=
{{COUPON_ID}} \
  -d mode=payment \
  -d ui_mode=custom \
  --data-urlencode return_url="https://example.com/checkout/return"

Configurer un bon de réduction

Vous pouvez utiliser les paramètres de bons de réduction suivants :

• currency
• percent_off ou amount_off
• max_redemptions
• redeem_by : indique la date limite de validité du bon de réduction
• applies_to : limite les produits auxquels s’applique le bon de réduction

Limiter l’utilisation

Les valeurs des paramètres max_redemptions et redeem_by s’appliquent au bon de réduction, quelle que soit l’application. Par exemple, vous pouvez limiter un bon de réduction aux 50 premières utilisations ou vous pouvez faire en sorte qu’il expire à une certaine date.

Limiter les produits admissibles

Vous pouvez limiter les produits pouvant bénéficier de réductions avec un bon de réduction en ajoutant les ID des produits au hash applies_to dans l’objet Coupon. Tout code promotionnel associé à ce bon de réduction peut uniquement être appliqué à cette liste de produits admissibles.

Supprimer un bon de réduction

Vous pouvez supprimer des bons de réduction depuis le Dashboard ou l’API. La suppression d’un bon de réduction empêche son application future à d’autres transactions ou clients.

Créer un code promotionnel

Les codes promotionnels sont des codes destinés aux clients, créés en plus des bons de réduction. Vous pouvez également préciser des restrictions supplémentaires qui contrôlent le moment où un client peut appliquer la promotion. Ces codes peuvent être partagés avec les clients afin qu’ils les saisissent au moment du paiement pour appliquer une réduction.

Pour créer un code promotionnel, précisez un coupon existant et indiquez toute restriction (par exemple, limité à 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, nous génèrerons un code aléatoire pour vous.

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

• Vous pouvez créer plusieurs codes promotionnels à l’usage de certains clients 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.

Les codes promotionnels peuvent être créés dans la section des bons de réduction du Dashboard ou avec l’API :

curl https://api.stripe.com/v1/promotion_codes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d coupon={{COUPON_ID}} \
  -d code=VIPCODE

Utiliser un code promotionnel

Sur votre serveur, activez les codes promotionnels utilisables par le client à l’aide du paramètre allow_promotion_codes lors d’une session Checkout.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d ui_mode=custom \
  -d allow_promotion_codes=true \
  --data-urlencode return_url="https://example.com/checkout/return"

Côté client, utilisez applyPromotionCode pour appliquer un code promotionnel saisi par votre client. Utilisez removePromotionCode pour supprimer tous les codes promotionnels précédemment appliqués.

<input type="text" id="promotion-code" />
<button id="apply-promotion-code">Apply</button>
<button id="remove-promotion-codes">Remove</button>
<div id="promotion-code-error"></div>

stripe.initCheckout({fetchClientSecret}).then((checkout) => {
  const input = document.getElementById('promotion-code');
  document.getElementById('apply-promotion-code').addEventListener('click', () => {
    checkout.applyPromotionCode(input.value).then((result) => {
      if (result.error) {
        // Display an error message
        document.getElementById('promotion-code-error').textContent = result.error.message;
      } else {
        // Clear the input if the promotion code was successfully applied
        input.value = '';
      }
    });
  });
  document.getElementById('remove-promotion-codes').addEventListener('click', () => {
    checkout.removePromotionCode();
  });
});

Configurer un code promotionnel

Pour chaque code promotionnel, vous pouvez personnaliser les critères d’admissibilité des clients, le nombre d’utilisations d’une promotion, ainsi que d’autres limites.

Limite par client

Pour limiter une promotion à un client donné, précisez un client lors de la création du code promotionnel. Si aucun client n’est précisé, le code promotionnel pourra être utilisé par l’ensemble des clients.

Limite pour une première commande

Vous pouvez également restreindre l’utilisation du code promotionnel aux nouveaux clients avec restrictions.first_time_transaction. Si le customer n’est pas défini, ou si un customer défini n’a pas de paiements antérieurs ou de factures non annulées, il s’agit alors d’une première transaction

Définir un montant minimum

Avec les codes promotionnels, vous pouvez fixer un montant de transaction minimum pour la réduction admissible en configurant 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 minimum ne s’applique qu’au paiement initial pour un abonnement.

Personnaliser les dates d’expiration

Vous pouvez définir une date d’expiration pour le code promotionnel à l’aide de expires_at. Si le paramètre redeem_by est déjà défini pour le bon de réduction sous-jacent, alors la date d’expiration du code promotionnel ne peut pas être ultérieure à celle du bon de réduction. Si la valeur promotion_code[expires_at] n’est pas précisée, le paramètre redeem_by du bon de réduction renseigne automatiquement le paramètre expires_at.

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 dans la semaine suivant sa réception par le client. Vous pouvez alors définir 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

Vous pouvez limiter le nombre d’utilisations avec le paramètre max_redemptions, qui fonctionne de la même manière que le paramètre de bon de réduction. Si le paramètre max_redemptions est déjà défini pour le bon de réduction sous-jacent, alors la valeur max_redemptions du code promotionnel ne peut pas être supérieure à celle du bon de réduction.

Par exemple, vous pouvez décider de proposer un bon de réduction à utiliser par les 50 premiers clients lors des soldes saisonniers, mais ne permettre que 20 utilisations dans le cadre de la promotion d’hiver. Dans ce scénario, vous pouvez définir le paramétrage coupon[max_redemptions]: 50 et promotion_code[max_redemptions]: 20.

Promotions inactives

Vous pouvez définir si un code promotionnel est actuellement utilisable à l’aide du paramètre active. Toutefois, si le bon de réduction sous-jacent à un code promotionnel n’est plus valide, tous les codes promotionnels associés seront définitivement désactivés. De même, si un code promotionnel atteint son nombre de max_redemptions ou sa date expires_at, il devient définitivement inactif. Vous ne pouvez pas réactiver ces codes promotionnels.

Supprimer des promotions

Vous pouvez supprimer des promotions à partir du Dashboard ou de l’API. La suppression d’une promotion empêche son application future à d’autres transactions ou clients.