Programme de parrainage – manuel d’utilisation

1. Ce que fait le module

Programme de parrainage transforme vos clients en ambassadeurs de votre boutique PrestaShop. Chaque client reçoit dans Mon compte un lien de parrainage personnel. Un ami qui ouvre ce lien et crée un compte, ou commande en tant qu’invité, devient son filleul pour de bon, et chaque commande de ce filleul rapporte des points au client : une commission que vous fixez en pourcentage de la commande. Les points deviennent disponibles quand la commande prend le statut de votre choix et que le délai de retour est écoulé, et le client les échange quand il le souhaite contre un code de réduction personnel.

Fonctionne avec PrestaShop 1.7.8, 8.x et 9.x (PHP 7.2.5 ou plus récent), avec les thèmes Classic et Hummingbird et en multiboutique.

2. Installation

1. Téléchargez ap_referral_v1.0.0.zip depuis Mon compte → Historique des commandes sur addonspresta.com.
2. Dans votre back-office, ouvrez Modules → Gestionnaire de modules et cliquez sur Installer un module.
3. Déposez le fichier zip et attendez la confirmation.
4. Cliquez sur Configurer, vérifiez la commission, le taux, les statuts de commande et la description du programme, puis enregistrez.

Dès l’installation, le programme fonctionne avec une commission de 5 %, 10 points pour 1 unité de la devise par défaut, des points attribués au statut Livré et un délai d’attente de 30 jours.

3. Fonctionnement

Le lien. Dans Mon compte → Programme de parrainage, le client trouve un lien du type https://votreboutique.fr/?ref=K7P2QX9M avec un bouton Copier. N’importe quelle page de la boutique avec son code fonctionne. Sur la fiche produit, un bouton Copier mon lien de parrainage copie le lien de ce produit avec le code du client ; le lien lui-même n’y est pas affiché.

Le filleul. Quand un visiteur ouvre le lien, le module mémorise le code dans son propre cookie pendant le nombre de jours choisi (30 par défaut) ; un lien ouvert ensuite d’un autre client le remplace. Quand le visiteur crée ensuite un compte ou passe une commande en tant qu’invité, il devient le filleul du propriétaire du lien. Cela n’arrive qu’une fois et seulement pour les nouveaux clients : aucune commande antérieure ne doit exister avec la même adresse e-mail, et personne ne peut se parrainer lui-même, pas même avec une autre forme de sa propre adresse (nom+boutique@…, points dans une adresse Gmail). En multiboutique, le filleul doit s’inscrire dans une boutique qui partage les clients avec celle du parrain.

Les points d’une commande. Chaque commande du filleul est enregistrée pour le parrain en attente, avec total de la commande × commission × taux points, arrondis à l’unité inférieure. Le total comprend les taxes et la livraison, après réductions ; une commande dans une autre devise est convertie dans votre devise par défaut. Exemple : commission 5 %, taux 10 — une commande de 200 rapporte 10 de commission, soit 100 points, qui valent une réduction de 10.

Validation. Quand la commande prend l’un des statuts qui attribuent les points (Livré par défaut), les points sont validés et recalculés d’après la commande telle qu’elle est alors. Ils deviennent disponibles à la fin du délai d’attente, compté depuis la date de la commande. Un statut qui annule les points (Annulé, Remboursé, Erreur de paiement par défaut) les annule tant qu’ils attendent ; après le délai d’attente, les points validés sont définitifs, si bien qu’un solde ne devient jamais négatif. Aucune tâche cron n’est nécessaire : le solde est calculé à chaque affichage.

Code de réduction. Quand le client a au moins le minimum de points disponibles, il clique sur Générer mon code de réduction ; la page indique auparavant la valeur du code et sa date de fin de validité. Tous ses points disponibles sont échangés contre un code d’une valeur de points ÷ taux dans votre devise par défaut, taxes comprises, valable le nombre de jours que vous avez choisi. Le code n’est valable que pour ce client, une fois, dans votre boutique ; si la commande est inférieure au code, PrestaShop donne le reste sous forme d’un nouveau code. Le code figure sur la page du programme et est proposé dans le panier.

Le module ne se connecte ni à addonspresta.com ni à aucun autre serveur. Le parrain ne voit jamais les noms ni les commandes de ses filleuls, seulement des dates et des points.

4. Fonctionnalités et réglages

Réglages (Modules → Gestionnaire de modules → Configurer)

La page commence par l’encadré Aide : ce manuel, la page du module, le contact et la version.

Programme de parrainage

• Activer le programme de parrainage — désactivé, les clients ne voient plus le programme et les nouvelles commandes ne rapportent pas de points ; parrainages et points sont conservés.
• Description du programme — dans chaque langue, avec l’éditeur de texte ; affichée en haut de la page du programme. Un texte de départ est saisi à l’installation : décrivez-y vos propres règles.
• Mémoriser le lien de parrainage pendant — de 1 à 365 jours.

Points

• Commission — pourcentage du total de la commande, de 0,01 à 100.
• Points pour 1 unité de la devise par défaut — de 1 à 10 000. Le même taux convertit la commission en points et les points en réduction.
• Statuts qui attribuent les points — au moins un.
• Statuts qui annulent les points — un statut ne peut pas à la fois attribuer et annuler.
• Délai d’attente — de 0 à 365 jours après la date de commande (30 par défaut). Il doit couvrir votre délai de livraison et votre délai de retour (dans l’UE 14 jours après la livraison) : un avertissement s’affiche sous 30 jours.
• Compter les commandes d’un filleul pendant — mois après le parrainage, 0 sans limite.

Codes de réduction et affichage

• Minimum de points pour un code de réduction — 0 permet d’échanger tout solde positif.
• Validité d’un code de réduction — de 1 à 3650 jours après la création du code (365 par défaut) ; le client ne la choisit pas.
• Afficher les points sur la fiche produit — « Recommandez ce produit : … vous gagnez environ N points ».
• Afficher le bouton du lien de parrainage sur la fiche produit — un bouton Copier mon lien de parrainage pour les clients connectés ; le lien lui-même n’est pas affiché. Les visiteurs non connectés voient un lien vers le programme.
• Afficher les points dans le panier — combien de points rapporterait une commande comme ce panier ; le nombre suit les changements de quantité.

Page du programme de parrainage

Le client voit son lien, le nombre de filleuls, ses points disponibles et en attente avec leur valeur, le formulaire pour obtenir un code de réduction, ses codes (utilisés, expirés ou valables) et les commandes de ses filleuls avec le statut des points.

Fiche du client

Clients → Clients → Afficher montre la carte Programme de parrainage : le code du client, son parrain, les filleuls qu’il a parrainés (avec un lien vers leur fiche) et les points disponibles, en attente et échangés par boutique. Les employés la voient pour les clients des boutiques qu’ils gèrent, avec le droit Lecture sur le module (Paramètres avancés → Équipe → Permissions).

5. Multiboutique

Les réglages sont enregistrés par boutique : choisissez la boutique dans l’en-tête du back-office avant d’enregistrer. Chaque boutique peut avoir sa propre commission, ses statuts, ses textes et ses limites, ou désactiver le programme. Les points appartiennent à la boutique où le filleul a commandé, la page du programme affiche le solde de la boutique en cours, et les codes de réduction sont limités à cette boutique. Un client garde un seul code de parrainage et un seul parrain pour toutes les boutiques ; un filleul ne peut être parrainé que dans une boutique qui partage les clients avec celle du parrain. La carte de la fiche client ne montre que les clients des boutiques que vous gérez. Une licence couvre toutes les boutiques de l’installation.

6. Désinstallation

Gestionnaire de modules → Programme de parrainage → Désinstaller supprime les parrainages, les points et les réglages. Les codes de réduction déjà donnés restent valables dans Catalogue → Réductions. Pour suspendre le programme sans rien perdre, désactivez Activer le programme de parrainage ou utilisez Désactiver.

7. Questions fréquentes et dépannage

Un ami s’est inscrit avec le lien mais n’est pas filleul. Il doit ouvrir le lien avant de créer son compte, dans le même navigateur et dans le nombre de jours choisi. Une adresse qui a déjà commandé dans la boutique, ou l’adresse du parrain lui-même, n’est pas un nouveau client.

Les points restent en attente. Ils attendent l’un des statuts qui attribuent les points, puis la fin du délai d’attente. La page du programme indique la date à partir de laquelle ils seront disponibles.

La commande a été remboursée alors que les points étaient déjà disponibles. Après le délai d’attente, les points sont définitifs. Réglez le délai d’attente plus long que votre délai de livraison plus votre délai de retour. Un remboursement avec avoir avant la fin du délai d’attente réduit les points de la commande. Un remboursement uniquement sous forme de bon de réduction, sans avoir, ne les modifie pas.

Un client peut-il parrainer son propre second compte ? Les commandes livrées ou facturées à l’une des adresses du parrain, ou avec l’un de ses numéros de téléphone, ne rapportent pas de points, et une autre forme de la même adresse e-mail est refusée. Avec un autre e-mail, une autre adresse et un autre téléphone, c’est encore possible ; la fiche du client montre qui a parrainé qui, ce qui permet de le repérer.

Dois-je mentionner le cookie ? Oui : le module dépose son propre cookie après une visite par un lien de parrainage. Ajoutez-le à votre politique de cookies.

Le lien Programme de parrainage manque dans Mon compte. Vérifiez que le programme est activé pour cette boutique et que le thème affiche le hook displayCustomerAccount.

8. Mises à jour et assistance

Les mises à jour sont gratuites à vie : téléchargez les nouvelles versions depuis Mon compte → Historique des commandes sur addonspresta.com et installez-les comme un nouveau module. Vos réglages, parrainages et points sont conservés.

L’assistance est incluse pendant 12 mois à compter de votre commande : écrivez à mail@addonspresta.com ou utilisez le formulaire de contact sur addonspresta.com (du lundi au vendredi, 10 h – 16 h CET ; nous répondons en général sous 2 jours ouvrés). Indiquez votre version de PrestaShop, la version du module et les étapes qui mènent au problème.

Le code du module passe notre audit de sécurité assisté par IA.

Retour : Manuels des modules