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 de :

• Appliquer une remise à l’ensemble du sous-total d’un achat
• Appliquer une remise à 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 pour vos clients des codes promotionnels qui se rapportent à un seul 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. Checkout prend actuellement en charge jusqu’à un bon de réduction ou code promotionnel.

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 \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

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 éligibles

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é à la liste des produits éligibles.

Supprimer un bon de réduction

Vous pouvez supprimer des bons de réduction à partir du Dashboard ou de 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 et qui reposent sur des bons de réduction. Vous pouvez également préciser des restrictions supplémentaires concernant le moment où un client peut appliquer la promotion. Vous pouvez partager ces codes avec les clients, qui peuvent les saisir lors du paiement pour appliquer une réduction.

Pour créer un code promotionnel, spécifiez un coupon existant et les éventuelles restrictions souhaitées (par exemple, une 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, nous vous génèrerons un code aléatoire.

Le code est insensible à la casse et doit être différent de tous les codes promotionnels actifs, quels que soient les clients concernés. Par exemple :

• Vous pouvez créer plusieurs codes promotionnels réservés à certains clients avec un même code, mais vous ne pouvez pas réutiliser ce code pour créer un code promotionnel destinés à 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 le paramétrage 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

Activez les codes promotionnels utilisables par le client à l’aide du paramètre allow_promotion_codes lors d’une session Checkout. Un champ est ainsi activé dans Checkout qui permet aux clients de saisir leurs codes promotionnels.

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 allow_promotion_codes=true \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

Configurer un code promotionnel

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

Limiter à un client donné

Pour réserver une promotion à un client en particulier, précisez un client lors de la création du code promotionnel. Si aucun client n’est spécifié, n’importe quel client peut utiliser le code.

Limiter à la première commande

Vous pouvez également réserver l’utilisation du code promotionnel aux nouveaux clients avec l’attribut restrictions.first_time_transaction. Si le customer n’est pas défini, ou si un customer défini n’a aucun paiement ou facture non nulle antérieurs, il s’agit d’une première transaction.

Définir un montant minimum

Avec les codes promotionnels, vous pouvez fixer un montant de transaction minimum pour la remise admissible en configurant les paramètres 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 d’un abonnement.

Personnaliser les dates d’expiration

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

Imaginons que vous prévoyez de proposer un bon de réduction pendant un an, mais souhaitez qu’il ne puisse être utilisé que dans la semaine suivant sa réception par le client. Vous pouvez définir une date coupon[redeem_by] fixée un an après la date du jour, et paramétrer chaque promotion_code[expires_at] à une semaine après sa création.

Limiter le nombre d’utilisations

Vous pouvez limiter le nombre d’utilisations d’un bon de réduction à l’aide de l’attribut 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 du paramètre max_redemptions du code promotionnel ne peut être supérieure à celle du bon de réduction.

Par exemple, vous pouvez décider de proposer un bon de réduction utilisable par les 50 premiers clients lors de vos soldes d’hiver, mais ne permettre que 20 utilisations dans le cadre de votre opération promotionnelle d’été. 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 utilisable en utilisant le 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.