Remises

​

Qu’est-ce que les codes de rabais ?

• Campagnes saisonnières : Black Friday, lancements de produits ou anniversaires
• Offres d’acquisition : Incitations à la première achat ou récompenses de parrainage
• Fidélisation : Récompenses de reconquête ou de fidélité pour les clients existants
• Offres B2B : Tarification contractée ou négociée via des codes privés

​

Avantages clés

• 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
• Remises flexibles : remises en pourcentage ou d’un montant fixe
• Codes cumulables : appliquez jusqu’à 20 codes par commande, paiement ou abonnement — combinez des campagnes (par ex. WELCOME10 + BLACKFRIDAY20) sans créer de codes personnalisés
• Contrôle ciblé : restreignez l’utilisation par produit, cycles d’abonnement et éligibilité du client
• Gouvernance 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
• Checkout fluide : prise en charge du champ dans l’interface et de l’API via les sessions de checkout

​

Configuration du tableau de bord

​

Configuration dans le tableau de bord

• Nom de la remise (obligatoire) : nom interne et nom affiché dans le tableau de bord
• Code (obligatoire) : chaîne saisie par les clients lors du checkout, ou générez un code aléatoire à l’aide du bouton prévu à cet effet
• Type (obligatoire) : choisissez Pourcentage (réduction en pourcentage) ou Montant (déduction fixe)
• Montant (obligatoire) : valeur en pourcentage ou montant fixe pour une remise de type Montant
• Date de début (facultative) : planifiez l’activation ultérieure du code ; laissez ce champ vide pour l’activer immédiatement
• Date d’expiration (facultative) : date après laquelle le code devient invalide
• Limite d’utilisation (facultative) : nombre maximal total d’utilisations pour tous les clients
• Limite d’utilisation par client (facultative) : 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) : limitez 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) : valeurs par devise — consultez Options par devise
• Restriction de produit (facultative) : limitez l’applicabilité à certains produits
• Limite de cycles d’abonnement (facultative) : nombre de cycles de facturation pendant lesquels la remise s’applique
• Conserver lors d’un changement de plan (facultatif) : conservez la remise active lorsque le plan de l’abonnement change (preserve_on_plan_change)
• Métadonnées (facultatives) : ajoutez des paires clé-valeur personnalisées pour le suivi interne ou les intégrations

​

Types de remise

​

Éligibilité du client

​

Options par devise

• Montant — pour une remise de type Montant, il s’agit de la déduction elle-même ; pour une remise en Pourcentage, il plafonne le montant que le code peut déduire. Correspond à max_amount_possible via l’API.
• Sous-total minimum — le code s’applique uniquement lorsque le panier atteint ce sous-total. 0 signifie qu’il n’y a aucun minimum.
• Par défaut — une entrée peut être marquée comme valeur par défaut à partir de laquelle les autres devises non configurées sont converties.

​

Expérience de checkout

1. Les acheteurs saisissent le code dans le champ du checkout.
2. Les remises éligibles sont appliquées et les totaux sont mis à jour immédiatement.

​

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 limitées dans le temps pour de nouveaux produits
• Achats en volume ou B2B : remises contractuelles pour certains ensembles de produits
• Fidélisation : codes de reconquête dans les processus 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 remise 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 remises dans les sessions de checkout

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 remises lors d’un changement 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
• Limitez dans le temps : 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 remises à certains produits afin d’éviter une érosion des marges
• Validez en amont : vérifiez l’applicabilité du code avant de confirmer le checkout
• Suivez l’impact : mesurez l’utilisation et la conversion par campagne