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 remise (obligatoire) : Libellé interne pour le tableau de bord.
• Code (obligatoire) : La chaîne que les clients saisissent 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 (pourcentage de remise) ou Amount (déduction forfaitaire).
• Amount (obligatoire) : Pour un pourcentage, le pourcentage de remise dans le tableau de bord (par ex. 15 pour 15 %). Via l’API, la même valeur est exprimée en points de base (1500). Pour un montant, la déduction forfaitaire dans la devise par défaut du code.
• Date de début (facultatif) : Planifiez l’activation du code à une date ultérieure. Laissez ce champ vide pour l’activer immédiatement.
• Date d’expiration (facultatif) : Date après laquelle le code ne peut plus être utilisé.
• Limite d’utilisation (facultatif, sous Advanced) : Nombre maximal d’utilisations au total pour tous les clients. Un panier multi-abonnements compte comme une seule utilisation.
• Limite d’utilisation par client (facultatif, 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é des clients (facultatif) : Limitez les clients autorisés à utiliser le code — tous les clients, les nouveaux clients, les clients existants ou une liste sélectionnée manuellement.
• Options de devise (facultatif) : Le montant de la remise pour chaque devise dans laquelle vous vendez. Consultez Options par devise.
• Restriction de produit (facultatif) : Limitez le code à des produits spécifiques.
• Limite de cycles d’abonnement (facultatif, sous Advanced) : Nombre de cycles de facturation auxquels la remise s’applique. Laissez ce champ vide pour une durée indéfinie.
• Conserver lors d’un changement de plan (facultatif) : Maintenez la remise active lorsqu’un abonnement change de plan (preserve_on_plan_change).
• Métadonnées (facultatif) : Ajoutez des paires clé-valeur personnalisées pour le suivi interne.
• Exiger une valeur minimale de commande (facultatif, 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

​

Empilement 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 de l’API

​

Cas d’utilisation courants

• Offres de lancement : Promotions limitées dans le temps pour les nouveaux produits
• Vente 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 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 remises 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 remise

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 prévenir les abus.
• Définissez judicieusement le périmètre : Limitez les remises à des produits spécifiques pour éviter l’érosion des marges.
• Validez en amont : Vérifiez l’applicabilité du code avant de confirmer le checkout.
• Surveillez l’impact : Suivez l’utilisation et la conversion par campagne.