Promotions
Rabais sur les abonnements en pourcentage, en montant ou à prix fixe, automatiques ou par code, pour toujours ou pour un nombre de périodes, gardés par les abonnés après la fin de la promotion.
Une promotion baisse le prix des abonnements qu'elle vise : un prix de lancement, un rabais pour les premiers clients, un code promo pour un partenaire. Elle se gère dans l'écran « Promotions » de la section Abonnements de l'admin, à côté des Offres, et n'existe qu'avec les abonnements activés.
Le principe
L'offre garde son prix régulier. Un abonnement le copie à la souscription, comme toujours. La promotion n'y touche pas : elle ajoute, sur chaque facture d'une période, une ligne négative à son libellé, sous la ligne de l'offre.
| Ligne | Montant |
|---|---|
| Abonnement Développeur, du 1er novembre 2026 au 31 octobre 2027 | 249,00 $ |
| Prix fondateur, prix réduit à 199,00 $ | −50,00 $ |
Les taxes se calculent sur ce qui reste. Le client voit le prix régulier et ce qu'il économise, sur la facture comme sur le PDF.
Un abonnement garde sa promotion. Il en prend une copie à la souscription : le rabais et le nombre de périodes. Ce qui arrive ensuite à la promotion ne l'atteint pas :
- une date de fin passée : les nouvelles souscriptions paient le prix régulier, l'abonné garde son rabais ;
- la promotion désactivée ou modifiée : même chose.
C'est ce qui fait un prix fondateur : il se termine pour les nouveaux clients, jamais pour les premiers.
Une seule promotion par abonnement. Elles ne se cumulent pas.
Créer une promotion
| Champ | Rôle |
|---|---|
| Nom | Pour l'administration seulement. |
| Libellé | Ce que voit le client : la ligne de la facture, les pages de souscription et de gestion. « Prix fondateur », par exemple. |
| Code promo | Facultatif. Vide, la promotion s'applique d'office à chaque souscription qu'elle vise. Avec un code, seulement à qui le saisit. Lettres, chiffres, tirets et soulignés, sans égard à la casse. |
| Type | percent (un pourcentage, de 1 à 100), amount_off (un montant retiré à chaque période) ou fixed_price (un prix réduit, fixé pour chaque offre visée). |
| Offres visées | Une ou plusieurs. Avec un prix fixe, le prix réduit de chacune, sous son prix régulier, 0 $ compris. |
| Durée | forever (à chaque renouvellement), once (la première période) ou repeating (un nombre de périodes, de 2 à 120). |
| Début, fin | Les jours où l'on peut souscrire avec la promotion, bornes comprises. Vides : dès maintenant, sans fin. |
| Utilisations au plus | Le nombre d'abonnements qui peuvent la recevoir. Vide : sans limite. |
| Active | Désactivée, elle n'est plus offerte. |
Un rabais ne dépasse jamais le prix de la période. Le formulaire accepte 100 %, un montant égal au prix de l'offre la moins chère et un prix fixe à 0 $, et refuse un montant plus élevé que le prix d'une des offres visées.
Les périodes gratuites
Une promotion à 100 %, à 0 $ ou d'un montant égal au prix rend la période gratuite. L'abonnement n'attend alors aucun paiement :
- la période a quand même sa facture, numérotée, à 0 $, avec la ligne de l'offre et la ligne du rabais. Elle est payée dès son émission, sans transaction, et son paiement fait avancer l'abonnement comme n'importe quel autre : activation, renouvellement, changement d'offre, décompte des périodes de la promotion ;
- aucun courriel de facture ne part pour une facture à 0 $ : il n'y a rien à payer. La première période envoie « Abonnement actif », un renouvellement gratuit passe sans message ;
- la page de souscription affiche « Gratuit » au lieu du prix net.
Une promotion gratuite forever donne un abonnement gratuit tant qu'il dure, sans carte, quel que soit le mode de paiement de l'offre.
Une promotion gratuite qui se termine (once ou repeating) sur une offre en prélèvement automatique envoie le client, après la souscription, vers la page Stripe d'enregistrement de carte : la carte est enregistrée sans être débitée, et le premier renouvellement au prix régulier est prélevé comme d'habitude. Si le client quitte cette page, l'abonnement reste actif, et ce renouvellement se paie par son lien. En paiement par lien, aucune carte n'est demandée.
Avec un essai, la facture de la première période émise à la fin de l'essai est gratuite elle aussi : elle rend l'abonnement actif sans le courriel « Fin de l'essai ».
Une promotion qui a déjà servi ne se supprime pas (409, promotion_in_use) : ses abonnements et leurs factures la nomment encore. Elle se désactive à la place.
Quelle promotion à la souscription
- Sans code, l'abonnement reçoit la promotion automatique qui fait le plus gros rabais sur la première période, parmi celles qui visent l'offre, sont actives, dans leurs dates, et ont encore des utilisations. Sans promotion, le prix régulier.
- Avec un code, la promotion du code, si elle vise l'offre et peut encore servir. Sinon, la souscription est refusée (
invalid_promotion_code). - Un code qui ne fait pas mieux que la promotion automatique est refusé (
promotion_not_better) plutôt qu'ignoré : le client ne croit pas à tort l'avoir obtenu.
La page de souscription du module montre le prix régulier, le prix net et le libellé, et propose un champ « Code promo » vérifié avant la souscription. Un site qui a sa propre page de commande lit le même devis par quotePlan() de ./server, et vérifie un code par POST /za/api/billing/promotions/check. Voir API.
Les périodes
Une période se compte quand la facture qui porte le rabais est payée, jamais à son émission :
- une promotion
oncedonne le rabais sur la première facture ; payée, le renouvellement suivant est au prix régulier ; - une facture annulée puis émise de nouveau, un renouvellement repris après une annulation, ne consomment rien ;
forevern'a rien à compter.
La facture retient la promotion qu'elle porte (fraza_billing_invoice.promotion_id) : c'est elle que son paiement décompte.
Le changement d'offre
Le client garde son rabais si la promotion vise aussi l'offre d'arrivée, aux conditions de la promotion pour cette offre : le prix fixe de l'offre d'arrivée, pour un prix fixe. Sinon, le rabais s'arrête avec le changement.
- Une montée, immédiate, facture la nouvelle offre avec son rabais. Le crédit de la période non utilisée se calcule sur ce que la période a coûté, rabais compris, pas sur le prix régulier. Une montée vers une offre que la promotion rend gratuite donne une facture à 0 $, payée aussitôt, qui fait le changement. Le crédit est alors limité au prix restant de la nouvelle offre : ce qui dépasse n'est pas reporté.
- Une descente, programmée pour le renouvellement : la facture de renouvellement applique déjà la règle à l'offre d'arrivée, et son paiement fait le changement.
- Pendant un essai, la règle s'applique au changement, sans facture.
Un code sur une montée. Le client peut saisir un code sur la révision du changement. Le code doit viser l'offre d'arrivée et faire mieux que le rabais que l'abonnement garde sur cette offre (promotion_not_better sinon, invalid_promotion_code pour un code inconnu ou expiré). La facture de changement porte alors le rabais du code, et son paiement remplace la promotion de l'abonnement par celle du code, avec sa durée. Une descente ou un essai n'ont pas de facture du jour : un code y est refusé (promotion_code_not_applicable).
Pour Fraza Pro
compte.fraza.ca vend Développeur à 249 $ et Agence à 749 $ par an. Une promotion automatique « Prix fondateur », à prix fixe (199 $ et 599 $), pour toujours, sans date de fin, fait le prix de lancement. Le jour où il se termine, il suffit de lui donner une date de fin : les nouveaux clients paient le prix régulier, les clients fondateurs gardent le leur.