Remises

​

Qu’est-ce que les codes de rabais ?

• Rabais flexibles : Pourcentage ou montant fixe de réduction
• Contrôle ciblé : Restriction par produit et cycles d’abonnement
• Gouvernance des campagnes : Dates d’expiration et limites d’utilisation
• Paiement sans friction : Champ UI et support API via des sessions de paiement
• Réductions flexibles : réductions en pourcentage ou d’un montant fixe
• Codes cumulables : appliquez jusqu’à 20 codes par checkout, paiement ou abonnement
• Contrôle ciblé : restreignez par produit, cycles d’abonnement et éligibilité du client
• Gestion des campagnes : dates de début planifiées, dates d’expiration, limites d’utilisation globales et par client
• Tarification par devise : définissez la déduction fixe, le plafond du montant et le sous-total minimum pour chaque devise

​

Configuration du tableau de bord

​

Configuration dans le tableau de bord

• Nom de la réduction (obligatoire) : libellé interne utilisé dans le tableau de bord.
• Code (obligatoire) : chaîne saisie par les clients lors du checkout. Générez un code aléatoire ou saisissez le vôtre (3 caractères minimum, automatiquement converti en majuscules).
• Type (obligatoire) : Percentage (réduction en pourcentage) ou Amount (déduction fixe).
• Amount (obligatoire) : pour un pourcentage, le pourcentage de réduction dans le tableau de bord (par exemple, 15 pour 15 %). Via l’API, la même valeur est exprimée en points de base (1500). Pour un montant, la déduction fixe dans la devise par défaut du code.
• Date de début (facultative) : planifiez l’activation du code à une date ultérieure. Laissez ce champ vide pour l’activer immédiatement.
• Date d’expiration (facultative) : date à partir de laquelle le code ne peut plus être utilisé.
• Limite d’utilisation (facultative, sous Advanced) : nombre maximal d’utilisations pour l’ensemble des clients.
• Limite d’utilisation par client (facultative, sous Advanced) : nombre maximal d’utilisations par un même client. Cette valeur doit être inférieure ou égale à la limite d’utilisation globale lorsque les deux sont définies.
• Éligibilité du client (facultative) : restreignez les personnes autorisées à utiliser le code — tous les clients, les nouveaux clients, les clients existants ou une liste sélectionnée manuellement.
• Options de devise (facultatives) : montant de la réduction pour chaque devise dans laquelle vous vendez. Consultez Options par devise.
• Restriction de produit (facultative) : limitez le code à certains produits.
• Limite de cycle d’abonnement (facultative, sous Advanced) : nombre de cycles de facturation auxquels la réduction s’applique. Laissez ce champ vide pour une durée indéfinie.
• Conserver lors d’un changement de plan (facultative) : conservez la réduction active lorsqu’un abonnement change de plan (preserve_on_plan_change).
• Métadonnées (facultatives) : associez des paires clé-valeur personnalisées à des fins de suivi interne.
• Exiger une valeur de commande minimale (facultative, sous Advanced) : sous-total minimal du panier (par devise) requis pour appliquer le code.

​

Types de remise

​

Éligibilité des clients

​

Options par devise

• Amount — pour une réduction de type Amount, la déduction fixe dans cette devise ; pour une réduction de type Percentage, le plafond de réduction maximal. Correspond à max_amount_possible dans l’API.
• Default — désignez une devise comme devise par défaut. Les devises non configurées sont converties à partir de cette devise par défaut.

• Minimum subtotal — le code s’applique uniquement lorsque le panier atteint ce sous-total dans cette devise. 0 signifie qu’aucun minimum n’est défini.

​

Expérience de checkout

​

Cumul des codes de remise

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  discount_codes: ['WELCOME10', 'BLACKFRIDAY20'], // applied in this order
  customer: { email: 'user@example.com' },
  return_url: 'https://yoursite.com/return'
});

​

Gestion via l’API

​

Cas d’utilisation courants

• Offres de lancement : Promotions à durée limitée pour de nouveaux produits
• Ventes en volume ou B2B : Remises contractuelles pour certaines gammes de produits
• Fidélisation : Codes de reconquête dans les workflows de prévention du churn
• Campagnes saisonnières : Promotions liées aux fêtes ou à des événements

​

Exemples d’intégration

​

Créer une réduction avec des métadonnées

const discount = await client.discounts.create({
  type: 'percentage',
  amount: 1500, // 15%
  code: 'SUMMER2025',
  metadata: {
    campaign: 'summer_promo',
    source: 'email_blast'
  }
});

​

Appliquer des réductions dans les Checkout Sessions

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  discount_codes: ['BLACKFRIDAY2024', 'NEWUSER5'], // stacked in array order
  customer: { email: 'user@example.com', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

​

Appliquer des réductions lors des changements de plan

await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_codes: ['UPGRADE20']
});

​

Masquer le champ du code de réduction

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  feature_flags: {
    allow_discount_code: false
  },
  return_url: 'https://yoursite.com/return'
});

​

Bonnes pratiques

• Nommez clairement : utilisez des codes reconnaissables correspondant aux noms des campagnes.
• Définissez une durée limitée : ajoutez des dates d’expiration pour créer un sentiment d’urgence et éviter les abus.
• Définissez judicieusement le périmètre : limitez les codes à certains produits pour éviter l’érosion des marges.
• Validez rapidement : vérifiez l’applicabilité du code avant de confirmer le checkout.
• Suivez l’impact : mesurez l’utilisation et la conversion par campagne.