Coupons

Créez des codes de réduction que les clients peuvent appliquer à la caisse. Pourcentage ou montant fixe, limité dans le temps ou plafonné, ponctuel ou récurrent.

Les coupons sont gérés dans Admin > Commerce > Products de ton app, sous Coupons, et dans l’onglet Cupones du panneau d’administration de ton app publiée.

Anatomie d’un coupon

Champ	Notes
code	Le code promo que les clients saisissent à la caisse (ex. LAUNCH20)
percent_off ou amount_off	Mutuellement exclusifs. Le pourcentage est compris entre 1 et 100. Le montant est exprimé dans la plus petite unité monétaire (centimes).
currency	Obligatoire pour les remises amount_off (code ISO à trois lettres). Accepté à la création et transmis à Stripe, mais non stocké ni renvoyé par l’API par la suite.
duration	once (premier paiement uniquement), repeating (pour duration_in_months), ou forever
duration_in_months	Obligatoire lorsque duration vaut repeating
max_redemptions	Plafond total toutes utilisations confondues
redeem_by	Date d’expiration après laquelle le coupon cesse de fonctionner
name	Nom d’affichage montré aux clients
active	Bascule pour activer/désactiver sans supprimer

Créer un coupon

Depuis le sous-onglet Coupons, clique sur Add coupon et remplis les champs. Quelques configurations courantes :

Objectif	Paramètres
20 % de réduction pour toujours	percent_off: 20, duration forever
10 $ de réduction, usage unique, expire dans 30 jours	amount_off: 1000, currency USD, duration once, max redemptions 1, redeem-by dans 30 jours
50 % de réduction sur les 3 premiers mois d’un abonnement	percent_off: 50, duration repeating, duration in months 3

Ou demande simplement à l’IA : "Create a LAUNCH20 coupon for 20% off forever."

Appliquer un coupon à la caisse

Les clients peuvent utiliser un code de deux manières :

• Sur la page de paiement Stripe — le champ de code promo s’affiche automatiquement, le client peut donc y saisir son code sans aucune action de ta part.
• Dans ton propre panier — ajoute un champ de code promo à ton panier et transmets ce que le client a saisi dans l’appel de checkout via couponCode. Le serveur valide le code et calcule la remise à partir de tes données commerce (jamais à partir d’un montant fourni par le navigateur), l’enregistre sur la commande et associe le coupon Stripe correspondant pour que la facturation soit correcte.

Demande à l’IA : "Add a promo code field to the cart and apply it at checkout."

Lister, modifier, désactiver

Le sous-onglet Coupons liste tous les coupons avec le nombre de fois où chacun a été utilisé par rapport à son plafond, afin que tu puisses suivre les performances de tes campagnes en un coup d’œil. La modification est volontairement limitée — voir ci-dessous — mais tu peux basculer n’importe quel coupon en inactif sans le supprimer, ce qui l’empêche immédiatement de fonctionner à la caisse.

Remarques et limites

• Les codes et les montants de remise sont immuables. Tu peux modifier le name d’affichage et basculer active, mais pas percent_off, amount_off, ni code lui-même. Crée un nouveau coupon si tu as besoin de conditions différentes.
• times_redeemed s’incrémente automatiquement et est en lecture seule — utile pour suivre les performances des campagnes.
• Les coupons s’appliquent par client, et non par commande — si un coupon est forever et qu’un client s’abonne, chaque renouvellement bénéficie de la remise.