Pourboire / Tip au Checkout — Guide complet
Installer, configurer et utiliser le pourboire optionnel (pourcentage, montant fixe ou libre) au panier et au checkout pour PrestaShop 8 et 9.
Présentation
Le module Pourboire / Tip au Checkout (dftip) ajoute sur la page panier de votre boutique un bloc « Ajouter un pourboire » qui permet au client de laisser un pourboire optionnel : un pourcentage, un montant fixe ou un montant libre. Le pourboire est ensuite intégré nativement à la commande, sans surcharge du cœur de PrestaShop. Idéal pour les artisans, créateurs et la restauration.
Le pourboire est porté par une ligne de commande dédiée dont le prix est fixé pour le panier en cours via un specific_price limité au panier. Il transite donc proprement dans le total payé, la TVA, la facture et les éventuels avoirs — exactement le mécanisme utilisé par PrestaShop pour les prix personnalisés en édition de commande.
Compatibilité
- PrestaShop 8.0 à 9.x
- PHP 7.4 à 8.3
- Mono-boutique et multi-boutique
- 5 langues : FR, EN, ES, DE, IT
- Thème Classic et thèmes personnalisés
- Aucune dépendance (ni Composer ni framework)
Installation
- Dans le back-office, ouvrez Modules > Gestionnaire de modules.
- Cliquez sur Installer un module puis sélectionnez le fichier
dftip.zip. - Une fois installé, cliquez sur Configurer.
À l’installation, le module enregistre ses hooks, crée un produit virtuel masqué « Pourboire » (hors catalogue et hors recherche, sans port) destiné à porter le montant du pourboire, et applique ses réglages par défaut : pourboire en pourcentage 5, 10, 15 %, montant libre autorisé, sans TVA.
Configuration
Tous les réglages se trouvent sur la page de configuration du module.
- Activer le module : affiche ou masque le bloc de pourboire.
- Titre et sous-titre : textes du bloc, personnalisables et traduisibles dans chaque langue.
- Type de pourboire : Pourcentage, Montant fixe ou Les deux.
- Pourcentages proposés : liste séparée par des virgules, par exemple
5,10,15. - Montants fixes proposés : liste séparée par des virgules dans la devise par défaut, par exemple
1,2,5. - Base de calcul du pourcentage : total produits TTC ou HT.
- Autoriser un montant libre : ajoute un champ de saisie libre.
- Montant libre minimum / maximum : bornes appliquées au montant libre.
- Taxe appliquée au pourboire : Aucune taxe par défaut ; vous pouvez sélectionner un groupe de taxe si votre cas l’exige.
- Afficher le bloc sur la page panier : active l’affichage du sélecteur sur la page panier.
Le titre et le sous-titre sont des champs multilingues : sélectionnez chaque langue dans le sélecteur du champ pour adapter le texte. Des valeurs par défaut sont fournies dans les cinq langues dès l’installation.
Fonctionnement
Comment le pourboire est ajouté
Quand le client choisit un pourboire, le module mémorise son choix (type et valeur) pour le panier en cours, ajoute la ligne « Pourboire » au panier et fixe son prix exact à l’aide d’un specific_price limité à ce panier. L’opération se fait en AJAX, sans rechargement, et le total se met à jour immédiatement.
Pourcentage recalculé automatiquement
Pour un pourboire en pourcentage, le montant suit le contenu du panier : si le client ajoute ou retire un produit, le module recalcule le montant et resynchronise la ligne avant le paiement. La base de calcul (total produits TTC ou HT) est définie dans la configuration et exclut toujours la ligne de pourboire elle-même ainsi que les frais de port.
Intégration native à la commande
Parce que le pourboire est une véritable ligne de panier, il est inclus dans le total réellement payé et capturé dans la commande au moment de la validation. Il apparaît proprement dans la facture, la comptabilité et les éventuels avoirs, sans aucun override du cœur.
TVA du pourboire
Un pourboire volontaire étant généralement hors champ TVA, la ligne est livrée sans taxe par défaut. Si vous associez un groupe de taxe au pourboire, le montant saisi ou calculé est traité comme une base hors taxe.
Le produit « Pourboire » créé par le module ne doit pas être supprimé ni rendu visible dans le catalogue : il sert uniquement à porter le montant du pourboire. Il est masqué de la recherche et des listes, et reste sans port.
Retrait du pourboire
Le client peut retirer son pourboire à tout moment via l’option « Pas de pourboire ». S’il supprime manuellement la ligne « Pourboire » depuis le panier, le module efface aussi le choix mémorisé pour ne pas la réajouter.
FAQ et dépannage
Le bloc de pourboire n’apparaît pas sur la page panier
Vérifiez que le module est activé et que l’option « Afficher le bloc sur la page panier » est cochée. Videz ensuite le cache de PrestaShop (Paramètres avancés > Performances) et, pendant vos tests, désactivez la combinaison/compression (CCC). Le bloc s’affiche lorsque le panier contient au moins un article.
Le pourboire en pourcentage ne se met pas à jour quand je change le panier
Le recalcul a lieu lors de l’enregistrement du panier et au chargement de la page panier ou du checkout. Si vous modifiez le panier via une action AJAX du thème, rechargez la page : le montant sera resynchronisé avant le paiement.
Le pourboire apparaît-il sur la facture ?
Oui. Le pourboire est une ligne de commande à part entière : il figure dans le détail de la commande et sur la facture, et il est pris en compte dans les avoirs.
Puis-je appliquer une TVA au pourboire ?
Oui, en sélectionnant un groupe de taxe dans la configuration. Par défaut, le pourboire est sans taxe, conformément à la nature d’un pourboire volontaire.
Est-ce compatible PrestaShop 9 et multi-boutique ?
Oui. Le module est compatible PrestaShop 8 et 9, en mono-boutique comme en multi-boutique, et multilingue, sans dépendance Composer ni framework.