NOUVEAU Migration gratuite en 24h sur tous les packs d'hébergement
E-commerce

Configurer le paiement et le cache de PrestaShop sans casser le panier

Brancher un module de paiement tunisien sur PrestaShop, choisir les bons réglages de cache, savoir ce que la boutique vérifie quand l’argent revient, et retrouver la cause d’un panier vide ou d’une commande payée restée en « Erreur de paiement ».

Guide NovaHosterÀ jour au 30 octobre 2026 (PrestaShop 9.2 et 8.2)

Trois mécanismes qui se touchent, trois responsables

Sur une boutique PrestaShop, le moment fragile dure quelques secondes : le client quitte votre site pour la page de paiement du prestataire, puis revient. Entre ces deux instants, trois mécanismes doivent s’accorder. Le module de paiement crée la commande et lui donne son état. Les caches, ceux de PrestaShop comme ceux du serveur, décident de ce qui est recalculé et de ce qui est resservi tel quel. Le cookie du visiteur, enfin, rattache le panier à la bonne personne. Un réglage maladroit sur l’un des trois suffit à vider un panier ou à laisser une commande payée sans trace dans le back-office.

Une boutique a besoin d’un hébergement PrestaShop cohérent avec ce qu’elle encaisse : un certificat valide, une adresse de notification joignable depuis Internet, des journaux que vous pouvez lire. Le reste se règle dans PrestaShop, et c’est l’objet de ce guide.

  • NovaHoster tient le serveur : PHP et son cache OPcache, Apache et nginx, les journaux d’accès et d’erreurs. Nous ne paramétrons pas votre module de paiement et nous n’intervenons pas dans la relation avec votre banque ; nous pouvons en revanche montrer, journaux du serveur en main, si l’appel de votre prestataire est bien arrivé.
  • Vous tenez la boutique : la version de PrestaShop, les modules, le thème et leurs réglages. Nos conditions générales laissent au client l’administration et la « maintenance applicative » de son contenu, sauf infogérance souscrite (article 7.3).
  • Le prestataire de paiement tient la transaction : c’est lui qui sait si la carte a été débitée, et son tableau de bord fait foi en cas de doute.

Les menus cités sont ceux de PrestaShop 9.2, sortie le 30 septembre 2026 [1], en français. La branche 8.2, qui reçoit encore des correctifs de sécurité (version 8.2.8 en août 2026) [2], présente les mêmes menus à quelques libellés près ; deux fonctions décrites plus bas n’y existent pas, et nous le signalons à chaque fois.

Avant de toucher à un réglage : relever, sauvegarder, copier

Dix minutes de relevé épargnent des heures de recherche quand un comportement change. Notez dans un fichier daté :

  1. Les versions. Paramètres avancés > Informations donne la version de PrestaShop et celle de PHP. Dans Modules > Gestionnaire de modules, relevez celle du module de paiement et de tout module qui intervient dans le panier ou la commande : transporteurs, réductions, tunnel de commande. Celle du thème figure dans Apparence > Thème et logo.
  2. Les réglages que vous allez modifier. Une capture de la page Paramètres avancés > Performances et de l’écran de configuration du module de paiement, avant la première modification. C’est votre point de retour.
  3. Une sauvegarde complète. PrestaShop rappelle qu’une sauvegarde utile comprend les fichiers et la base de données, et qu’elle ne doit rester ni à la racine de la boutique ni dans un dossier accessible depuis le Web [3]. Dans Plesk, Sites Web & Domaines > Gestionnaire de sauvegardes > Sauvegarder copie l’abonnement, fichiers et bases compris [4] ; téléchargez l’archive pour en garder un exemplaire hors du serveur.

Nos sauvegardes ne remplacent pas la vôtre. Les copies que NovaHoster fait de ses serveurs servent à remettre le service en marche après un incident chez nous ; vous n’y avez pas accès et elles ne ramènent pas une boutique à l’état d’avant un réglage. Votre propre sauvegarde se fait depuis Plesk. En option, la « Sauvegarde externalisée quotidienne » conserve trente jours de copies sur un site distant, restaurables depuis votre espace client, dès 90 DT par an selon la capacité. Une restauration réalisée par notre équipe à votre demande est établie sur devis, et gratuite quand la perte vient de notre côté.

Une copie de test, et le piège de son adresse

Nos packs e-commerce comprennent au moins deux bases de données. La seconde permet de monter une copie de la boutique sur un sous-domaine, pour y essayer un module ou un réglage avant de le reproduire sur la vraie. Après la copie des fichiers et de la base, faites pointer le fichier app/config/parameters.php de la copie vers la seconde base, puis videz son dossier var/cache/prod, comme PrestaShop le demande après toute modification de ce fichier [5].

Un détail fait perdre beaucoup de temps : PrestaShop renvoie toute adresse qu’il ne connaît pas vers le domaine enregistré dans sa base [6]. Tant que ce domaine n’a pas été changé dans la base de la copie, ouvrir le sous-domaine vous ramène sur la boutique en ligne, et c’est là que vous testez sans le savoir. Le back-office de la copie, lui, reste accessible à sa propre adresse [6] : corrigez « Domaine de la boutique » et « Domaine SSL » dans Paramètres de la boutique > Trafic et SEO, section « URL de la boutique », puis vérifiez la barre d’adresse avant chaque essai.

Pour tester le paiement de bout en bout, la copie doit rester joignable par le prestataire : ni mot de passe devant le site, ni mode maintenance, et uniquement les identifiants de test du prestataire, jamais ceux de production.

Cette copie contient vos vrais clients et leurs adresses e-mail. Dans Paramètres avancés > E-mail, choisissez « Ne jamais envoyer d’e-mails (utile en phase de test) » : sans cela, un changement d’état de commande sur la copie écrirait à un vrai client. Rétablissez l’envoi seulement le temps de l’essai d’e-mail, avec un compte client à votre propre adresse. Remplacez aussi le fichier robots.txt de la copie, recopié de la boutique, par les deux lignes User-agent: * et Disallow: /, pour que les moteurs de recherche ne l’explorent pas. C’est une consigne pour les robots, pas un verrou : le prestataire peut toujours appeler la copie [7].

Les caches d’une boutique PrestaShop, et ce que chacun peut casser

« Vider le cache » ne veut rien dire tant qu’on ne sait pas lequel. Une boutique hébergée chez nous en traverse plusieurs, et un seul menace réellement le panier : celui qui conserve des pages entières.

Dans PrestaShop : la page Performances

Elle se trouve dans Paramètres avancés > Performances. Aucun de ses réglages ne garde une page entière : ils conservent des gabarits compilés, des feuilles de style et des scripts regroupés, ou des résultats de requêtes.

  • Smarty, « Compilation des templates ». Trois choix : « Ne jamais recompiler les fichiers de templates », « Recompiler les fichiers de templates s’ils ont été mis à jour » et « Forcer la compilation à chaque appel ». Pour une boutique en ligne, PrestaShop recommande le deuxième, avec « Cache » sur Oui ; forcer la compilation ralentit chaque page et ne sert qu’à celui qui modifie le thème [5]. Avec le premier, une retouche du thème reste invisible tant que personne n’a cliqué sur « Vider le cache », en haut de la page [8].
  • CCC, pour concaténation, compression et mise en cache. Les options « Smart cache » regroupent et compressent les feuilles de style d’une part, le code JavaScript d’autre part. Les premières se combinent sans difficulté ; pour les scripts, PrestaShop prévient que le regroupement pose parfois problème et demande de tout tester avant de le laisser actif [8]. Le bouton d’ajout au panier, le choix du transporteur et l’étape de paiement reposent sur JavaScript : ce sont les trois premières choses à vérifier après l’activation. « Optimisation Apache » ajoute de son côté des règles de cache et de compression au fichier .htaccess [9].
  • La section « Cache ». « Utiliser le cache » et « Système de cache » (Memcached ou APC) gardent en mémoire des résultats de requêtes. Ces systèmes exigent une extension PHP présente sur le serveur [8], et PrestaShop déconseille d’activer la section quand MySQL, avant sa version 8, ou MariaDB tourne sur la même machine [10]. Sur un hébergement mutualisé, laissez-la sur Non, sauf avis contraire de notre support.
  • Les fichiers du cache vivent dans var/cache/prod/, ou var/cache/dev/ quand le mode debug est actif [11]. Quand la boutique ne reflète pas une modification, la documentation de PrestaShop indique de vider les dossiers smarty/compile et smarty/cache ; le fichier class_index.php peut être supprimé sans risque en cas de problème de cache [12]. Le bouton « Vider le cache » fait tout cela depuis le back-office, sans gestionnaire de fichiers [8].

Sur le serveur : OPcache, cache nginx, CDN

  • OPcache garde en mémoire le code PHP déjà compilé. PrestaShop le recommande [10], il est activé sur nos packs e-commerce, et il ne conserve aucune page : il n’est jamais en cause dans un panier qui se vide.
  • La mise en cache nginx de Plesk, si votre abonnement donne accès à Sites Web & Domaines > Paramètres d’Apache et Nginx. Plesk la juge inutile, voire néfaste, pour un site qui affiche du contenu personnalisé, et cite justement le contenu des paniers [13]. Par défaut, nginx ne garde pas une requête qui porte un cookie. Ne placez donc jamais le cookie de PrestaShop, dont le nom commence par PrestaShop- [14], dans le champ « Mettre en cache les requêtes avec des cookies ». Le bouton « Vider le cache » de la même section purge ce cache sans toucher à ses réglages [13].
  • Un module de cache de pages ou un CDN sert des pages déjà fabriquées. C’est là que naissent les paniers qui se vident et les pages qui affichent le prénom d’un autre client. Un tel outil doit laisser passer sans cache le panier, la commande, le compte client, les adresses du module de paiement, et tout visiteur qui a déjà un panier ou une session. Essayez-le connecté avec un compte client, pas seulement en invité.

Installer le module de paiement, en mode test d’abord

Les solutions tunisiennes ne se branchent pas toutes de la même manière. Flouci propose ses modules, celui de PrestaShop compris, dans son tableau de bord professionnel, rubrique « Accepter en ligne > Plugins » [15]. GPG fournit des kits pour PrestaShop et envoie au marchand une notification de serveur à serveur sur l’état de chaque transaction [16]. Pour ClicToPay, les modules disponibles sont l’œuvre de tiers. La Poste fournit son propre kit marchand pour l’e-Dinar, avec ses manuels d’intégration. Notre comparatif des solutions tunisiennes de paiement en ligne détaille contrats, délais et frais ; ce guide s’occupe du branchement.

  1. Récupérez le module à la source : le tableau de bord du prestataire, le site de son éditeur ou la place de marché officielle PrestaShop Addons, et lisez les versions de PrestaShop qu’il prend en charge. N’installez pas un module annoncé pour une autre branche majeure sans confirmation de compatibilité. Un module écrit pour la 8 n’est pas forcément prêt pour la 9. Une archive récupérée sur un forum n’a pas sa place sur une boutique qui encaisse.
  2. Installez-le depuis Modules > Gestionnaire de modules, bouton « Installer un module », en déposant l’archive ZIP. Évitez les jours de promotion. Pour les mises à jour de modules, le back-office conseille de passer la boutique en maintenance afin d’éviter les problèmes de cache ; or la maintenance bloque aussi les notifications de paiement (voir plus bas) : rouvrez la boutique avant les essais.
  3. Réglez-le en mode test. Saisissez les identifiants de test du prestataire. Si le module affiche une adresse de notification, appelée aussi webhook ou URL de retour serveur, recopiez-la telle quelle dans l’espace du prestataire : en https, sur le domaine exact de la boutique, celle qui répond sans redirection. Si le prestataire fournit une clé de signature des notifications, saisissez-la dans le module : sans elle, n’importe qui pourrait appeler cette adresse. Les clés secrètes restent dans la configuration du module ; elles n’ont rien à faire dans un e-mail, un ticket ou une capture d’écran.
  4. Vérifiez l’unité des montants. Le dinar compte trois décimales, les millimes [17], et certains prestataires attendent le montant directement en millimes : Flouci demande 40300 pour 40,300 DT [18]. Dans International > Localisation > Devises, le dinar doit afficher 3 dans le champ « Décimales ». Un module qui se trompe d’unité encaisse mille fois trop, ou mille fois trop peu.
  5. Ouvrez-lui l’étape de paiement. Paiement > Moyens de paiement liste les modules installés ; Paiement > Préférences décide où chacun apparaît, par devise, par pays, par groupe de clients et par transporteur [19]. Cochez le dinar, la Tunisie, les groupes « Visiteur », « Invité » et « Client », et les transporteurs concernés. Quand un moyen de paiement manque à l’appel, commencez par cet écran.

Ce que PrestaShop vérifie quand le paiement revient

Une fois le client passé à la caisse, le prestataire prévient la boutique de deux façons : il renvoie le navigateur du client vers une page de retour et, selon la solution, il appelle directement une adresse de votre serveur, la notification. Un module bien conçu ne valide pas la commande sur la seule foi de la page de retour, que n’importe qui peut ouvrir sans avoir payé : il interroge le prestataire, ou attend sa notification et en vérifie l’authenticité, par la signature ou le secret que fournit le prestataire [20]. Il appelle ensuite la fonction de PrestaShop qui transforme le panier en commande, et trois contrôles ont lieu à ce moment-là [21].

  • Un panier ne donne qu’une commande. Si la page de retour et la notification tentent toutes les deux de créer la commande, le second appel est refusé. Sur une boutique en français, les journaux portent alors « Le panier ne peut être chargé ou une commande a déjà été réalisée avec ce panier » (« Cart cannot be loaded… » sur une boutique en anglais), avec la gravité 4. C’est le comportement attendu, pas une panne, même si cette ligne déclenche l’alerte par e-mail réglée par défaut.
  • Le panier doit être le bon. Quand le module transmet la clé propre au panier, elle doit correspondre ; sinon, la commande n’est pas créée et les journaux notent « PaymentModule::validateOrder - Secure key does not match ». Ce message, comme le suivant, reste en anglais quelle que soit la langue de la boutique.
  • Le montant doit correspondre. PrestaShop compare la somme déclarée payée au total du panier, avec le nombre de décimales de la devise [22], donc au millime près pour le dinar. Si l’état demandé compte la commande comme validée et que les deux montants diffèrent, la commande est créée quand même, mais à l’état « Erreur de paiement », avec dans les journaux « PaymentModule::validateOrder - Total paid amount does not match cart total ».

Les états se gèrent dans Paramètres de la boutique > Commandes > États de commandes. Pour chacun, trois réglages comptent ici : « Considérer la commande associée comme validée », « Marquer la commande associée comme payée », et l’envoi d’un e-mail au client quand sa commande y passe. « Paiement accepté » est validé et payé ; « Erreur de paiement » ne l’est pas ; « En attente de paiement à la livraison », l’état du module de paiement à la livraison fourni avec PrestaShop, ne l’est pas non plus, puisque rien n’a encore été encaissé [23]. Si un état ne vous convient pas, créez-en un nouveau plutôt que de renommer celui qu’utilise votre module.

La notification doit pouvoir entrer

Une notification est une requête comme une autre : si un obstacle l’arrête avant PrestaShop, la commande ne bouge pas alors que la carte a été débitée. Quatre portes se ferment souvent sans qu’on y pense.

  • La maintenance. Boutique fermée depuis Paramètres de la boutique > Paramètres généraux > Maintenance, PrestaShop répond par sa page de maintenance et un code 503 à toute adresse IP absente du champ « IP de maintenance », y compris quand la requête vise un module [24]. L’option « Activer l’accès à la boutique pour les employés connectés » vous laisse voir la boutique, pas le serveur du prestataire. Testez le paiement boutique ouverte, ou ajoutez à ce champ les adresses IP que votre prestataire publie.
  • Un mot de passe devant le site, sur une copie de test par exemple : le prestataire ne le connaît pas.
  • Une adresse qui a changé : passage au https, ajout ou retrait du www, nouveau nom de domaine. L’adresse enregistrée chez le prestataire doit suivre.
  • Le pare-feu. Le pare-feu applicatif de nos packs (Imunify360) peut refuser un appel qu’il juge suspect : la requête apparaît alors en erreur dans les journaux, typiquement en 403 [25], ou pas du tout si l’adresse IP est bloquée en amont. Écrivez-nous avec l’heure du paiement et l’adresse IP du prestataire.

Pour savoir si l’appel est arrivé, ouvrez Sites Web & Domaines > Logs dans Plesk (le guide pour retrouver les réglages d’un site dans Plesk montre où se trouve ce menu). Les journaux d’accès en HTTPS, « Accès ssl Apache » et « Accès ssl Nginx », enregistrent chaque requête reçue [26] : cherchez le chemin de la notification à l’heure du paiement. Un code 200 signifie que la boutique a répondu ; 503, qu’elle était en maintenance ; 404, que l’adresse ne mène à rien, module désactivé ou chemin erroné ; 403, que la requête a été refusée, souvent par le pare-feu ; 301 ou 302, que l’adresse enregistrée redirige : remplacez-la chez le prestataire par l’adresse finale. Aucune ligne : la requête n’a jamais atteint le serveur, et c’est le moment d’écrire au support.

Le jeu de tests avant d’ouvrir le paiement

Menez ces essais en mode test, boutique ouverte, avec un produit à prix rond, des frais de port et un code de réduction : un écart de montant se repère tout de suite. Pour chacun, notez l’heure, la référence de la commande ou le numéro du panier, et ce qu’affiche le tableau de bord du prestataire.

  1. Paiement accepté, client connecté : la commande apparaît à l’état « Paiement accepté », au même montant que chez le prestataire, et le client reçoit son e-mail.
  2. Le même parcours en invité, puis depuis un téléphone.
  3. Paiement refusé, avec la carte de test prévue pour cela : aucune commande validée, et le client peut retenter sans refaire son panier.
  4. Abandon sur la page de paiement, onglet fermé : aucune commande, et le panier figure dans Commandes > Paniers avec la mention « Non commandé ».
  5. Paiement accepté, puis navigateur fermé avant le retour vers la boutique : la commande doit apparaître malgré tout. C’est le seul essai qui prouve que la notification fonctionne.
  6. Page de retour rechargée ou ouverte deux fois : une seule commande.
  7. Remboursement depuis l’outil prévu par le module ou par le prestataire : regardez ce qui change côté boutique, et ce qui ne change pas.

Contrôlez aussi l’envoi des e-mails : Paramètres avancés > E-mail [19], bouton « Envoyer un e-mail test ». Un client qui vient de payer attend une confirmation écrite.

Ces essais passés, saisissez les identifiants de production, désactivez le mode test, puis faites un véritable achat d’un petit montant, que vous rembourserez. Ne modifiez pas les réglages de cache le même jour : si quelque chose casse, vous saurez quoi accuser.

PrestaShop 9.2 et la commande en une page

La 9.2 livre un module de commande en une page, ps_onepagecheckout, installé mais inactif : c’est vous qui choisissez entre ce tunnel et le tunnel classique en quatre étapes [1] [27]. Les modules de paiement qui passent par un simple formulaire y fonctionnent sans adaptation. Ceux qui pilotent eux-mêmes la suite, redirection, bouton intégré ou fenêtre de paiement, doivent appeler une fonction prévue pour que l’adresse et le transporteur soient enregistrés avant le paiement [27]. Demandez à l’éditeur de votre module s’il l’a fait, et rejouez toute la liste ci-dessus après avoir changé de tunnel. La 8.2 n’a pas ce module.

Symptômes, causes probables et remèdes

Ce que vous voyezCause probableQue faire
Le panier se vide d’une page à l’autre, ou affiche le contenu d’un autre visiteurUne page entière servie depuis un cache : module de cache de pages, CDN, ou mise en cache nginx réglée pour garder les requêtes avec cookie [13].Coupez ce cache, videz-le, puis testez en navigation privée et connecté. Ne le rallumez qu’avec les exclusions décrites plus haut.
Les paniers se vident depuis l’installation d’un moduleLe cookie de PrestaShop, chiffré et unique, ne doit pas dépasser 4 096 octets, limite au-delà de laquelle les navigateurs l’ignorent [28]. PrestaShop 8.2 et 9.2 refusent alors de l’écrire (« Error during setting a cookie… ») [14] [29], et les nouvelles données du panier ne sont pas enregistrées.Cherchez cette erreur dans les journaux, désactivez le dernier module installé et prévenez son éditeur.
Tous les clients ont perdu panier et connexion au même momentUne mise à jour de PrestaShop : le nom du cookie contient le numéro de version, il change avec lui [14].Rien à réparer. Les paniers restent dans Commandes > Paniers, et un client qui se reconnecte retrouve le sien si « Réafficher le panier après identification » est actif dans Paramètres de la boutique > Clients [19]. Planifiez les mises à jour aux heures creuses.
Le client revient du paiement déconnecté, ou avec un panier vide, alors que le reste du site fonctionneLe prestataire renvoie le client par un formulaire POST, et le cookie de PrestaShop, réglé en SameSite=Lax à l’installation [30], n’accompagne pas ce retour venu d’un autre site [31].Vérifiez auprès du prestataire ou de l’éditeur du module comment se fait le retour. La valeur None, réservée au HTTPS (« L’attribut SameSite=None n’est disponible qu’en mode sécurisé »), se règle dans Paramètres avancés > Administration, option « Cookie SameSite ».
« Ajouter au panier » ne fait rien pour un client connecté, alors que tout marche en navigation privéeUne page gardée en cache pour un autre visiteur lui sert un jeton de sécurité qui n’est pas le sien. Quand « Améliore la sécurité du front-office » est actif, PrestaShop refuse alors de modifier le panier [32].Retirez du cache de pages les visiteurs qui ont une session ou un panier, puis videz ce cache.
Le client a payé, sa commande est en « Erreur de paiement »Le montant transmis par le module diffère du total du panier : confusion entre dinars et millimes, frais de port ou réduction oubliés, ou panier modifié dans un autre onglet pendant le paiement [21].Comparez le montant chez le prestataire et dans la commande, et lisez Paramètres avancés > Logs. Si la somme encaissée est la bonne, passez la commande à « Paiement accepté » à la main ; sinon, réglez l’écart avec le client avant d’expédier.
Le client a payé, aucune commande n’apparaîtLa notification n’est pas arrivée (maintenance, mot de passe, adresse périmée), ou le module ne valide qu’au retour du navigateur, que le client a fermé.Cherchez l’appel dans les journaux d’accès de Plesk. Ne créez pas de commande au hasard : retrouvez le panier dans Commandes > Paniers, vérifiez le paiement chez le prestataire, puis utilisez « Créer une commande avec ce panier » ; l’état se choisit alors à la main [19].
Le moyen de paiement n’apparaît pas à l’étape de paiementRestriction de devise, de pays, de groupe ou de transporteur, ou module désactivé [19].Paiement > Préférences, puis Modules > Gestionnaire de modules. Essayez avec une adresse en Tunisie et le dinar sélectionné.
Page blanche ou erreur 500 juste après l’installation d’un moduleUne erreur PHP dans le module, ou un module incompatible avec votre version.Lisez les journaux, comme expliqué plus bas. Si le back-office répond, désactivez le module ; sinon, voyez avec le support ou affichez l’erreur par le fichier config/defines.inc.php [33].
Une retouche du thème ne s’affiche pas« Ne jamais recompiler les fichiers de templates », fichiers regroupés par CCC, ou cache nginx ou CDN pas encore expiré.« Vider le cache » dans Performances, puis celui de nginx ou du CDN ; contrôlez en navigation privée.

Lire les erreurs sans les montrer aux clients

PrestaShop enregistre ses erreurs sans les montrer aux visiteurs. Il suffit de savoir où regarder, du plus simple au plus technique.

  1. Paramètres avancés > Logs. Chaque ligne porte une gravité, de 1 (à but informatif) à 4 (problème majeur), avec le type et l’identifiant de l’objet concerné, panier ou commande [34]. Les messages de validation cités plus haut s’y trouvent. Plus bas, « Alertes par e-mail » prévient les destinataires indiqués dès qu’une erreur atteint le « Niveau de gravité minimum » [35]. À l’installation, ce niveau vaut 4, « Problème majeur (erreur critique) » : seuls les problèmes majeurs sont envoyés ; « Aucun » coupe les alertes [30]. Pendant la semaine où vous ouvrez le paiement, descendez-le à 3, « Erreur », et vérifiez le champ « Envoyer les e-mails à » : PrestaShop y inscrit à l’installation l’adresse de l’administrateur qui a installé la boutique, qui n’est pas forcément la vôtre [36].
  2. Le dossier var/logs/ de la boutique, que le gestionnaire de fichiers de Plesk ouvre sans difficulté, reçoit le journal de la partie Symfony de PrestaShop : un fichier par jour, les trente derniers conservés par défaut [37].
  3. Les journaux de Plesk, dans Sites Web & Domaines > Logs : « Erreur Apache » et « Erreur Nginx » reçoivent ce qui échoue autour de PrestaShop, et les journaux d’accès montrent qui a appelé quelle adresse [26]. Le guide pour lire les journaux d’une application en production aide à les interpréter.

Le mode debug, dans Paramètres avancés > Performances, affiche les erreurs techniques et la barre de débogage de Symfony. Il ralentit nettement la boutique [5] et, tel quel, montre ses messages à tous les visiteurs [11]. Depuis PrestaShop 9.0, deux champs changent la donne : « Nom du cookie de débogage » et « Valeur du cookie de débogage ». Renseignés, ils limitent le mode debug aux navigateurs qui portent ce cookie, que vous créez dans le vôtre depuis ses outils de développement [38]. La 8.2 n’a pas ces champs : activez le mode debug sur la copie de test, ou quelques minutes seulement, puis coupez-le.

Pour isoler un module fautif, la même page propose de désactiver d’un coup tous les modules non intégrés, c’est-à-dire tous les modules tiers, module de paiement compris ; il reste ensuite à les réactiver un par un [39]. À faire sur la copie de test, ou boutique en maintenance. L’option « Désactiver toutes les surcharges » fait de même pour le code qui modifie le fonctionnement de PrestaShop. Si le back-office lui-même ne s’ouvre plus, PrestaShop indique de passer _PS_MODE_DEV_ à true dans config/defines.inc.php pour lire l’erreur [33] ; remettez false dès qu’elle est notée.

Questions fréquentes

Faut-il couper le cache de PrestaShop pendant les essais de paiement ?
Non, à une réserve près. La page Paramètres avancés > Performances ne garde aucune page entière, mais le regroupement des scripts (option « Smart cache » pour le code JavaScript) peut casser l’ajout au panier ou l’étape de paiement : s’il est actif, vérifiez d’abord ces étapes. Ce qu’il faut couper pendant les essais, c’est un éventuel cache de pages : module dédié, CDN ou mise en cache nginx. Évitez seulement de modifier ces réglages le jour où vous branchez le paiement.
Un client a été débité mais sa commande est en « Erreur de paiement » : que faire ?
Ne remboursez pas et ne recréez pas la commande dans la précipitation. Comparez le montant reçu chez le prestataire avec le total de la commande, et lisez Paramètres avancés > Logs. Si la somme encaissée est complète, passez la commande à « Paiement accepté » ; s’il manque une partie, réglez l’écart avec le client avant d’expédier, puis corrigez le réglage du module.
Pourquoi tous mes clients ont-ils perdu leur panier juste après une mise à jour ?
Parce que le nom du cookie de PrestaShop contient le numéro de version : après la mise à jour, chaque navigateur reçoit un nouveau cookie, vide. Les paniers ne sont pas perdus pour autant. Ils restent dans Commandes > Paniers, et un client qui se reconnecte retrouve le sien si « Réafficher le panier après identification » est actif.
Puis-je laisser le mode debug activé pour que le support voie l’erreur ?
Non : il ralentit la boutique et affiche les messages techniques à tous les visiteurs. Envoyez plutôt l’heure de l’erreur et la ligne correspondante de Paramètres avancés > Logs. Sur PrestaShop 9, si le mode debug est vraiment nécessaire, limitez-le à votre navigateur avec un nom et une valeur de cookie de débogage.
NovaHoster peut-il paramétrer le module de paiement à ma place ?
Non : ce réglage et la relation avec la banque ou le prestataire restent en dehors de l’hébergement. Sur les packs e-commerce, PrestaShop s’installe en un clic depuis Plesk, et notre équipe peut s’en charger pour vous. Quand un paiement bloque, nous vérifions dans les journaux du serveur si l’appel du prestataire est arrivé : c’est souvent ce qui fait avancer l’échange avec lui.
Le dinar doit-il avoir deux ou trois décimales dans PrestaShop ?
Trois, les millimes : c’est la valeur de référence du dinar tunisien, celle que PrestaShop reprend pour la devise. PrestaShop compare le montant payé au total du panier avec ce nombre de décimales. Un module qui arrondit à deux décimales, ou qui confond dinars et millimes, crée des écarts que la boutique classe en « Erreur de paiement ».

Quand écrire au support, et quoi lui envoyer

Écrivez-nous quand le problème se situe visiblement avant PrestaShop : une notification que le prestataire dit avoir envoyée et qu’aucun journal d’accès ne montre, une notification refusée en 403, une erreur 500 ou 503 alors que la boutique n’est pas en maintenance, un certificat refusé par le prestataire, ou pour faire activer SSH sur votre pack. Le réglage du module lui-même relève du support du prestataire ou de l’éditeur du module. Chez nous, le livechat et les tickets répondent 7 jours sur 7, jours fériés compris, en français ou en tunisien ; le téléphone, du lundi au vendredi de 9 h à 17 h, sert au commercial et à l’administratif (page Contact).

Dans votre demande, indiquez le domaine, l’heure exacte en heure de Tunis, la référence de la commande ou le numéro du panier, l’identifiant de transaction donné par le prestataire (jamais de numéro de carte), l’adresse de notification, les versions de PrestaShop et du module, et le dernier changement fait sur la boutique. Ni clé secrète, ni contenu de app/config/parameters.php, qui renferme les accès à la base de données [5]. Le guide pour ouvrir une demande de support propose un modèle complet.

Guides liés

Pour aller plus loin : les documentations de référence

  1. PrestaShop — annonce de PrestaShop 9.2 (30 septembre 2026) : commande en une page, prérequis, mise à jour
  2. PrestaShop — version 8.2.8, correctifs de sécurité de la branche 8.2 (août 2026)
  3. PrestaShop DevDocs — sauvegarder une boutique : fichiers et base de données
  4. Documentation Plesk Obsidian — créer des sauvegardes (en français)
  5. PrestaShop DevDocs — fichiers de configuration, mode debug et compilation des gabarits
  6. Code de PrestaShop 9.2.0 — Shop::initialize() : une adresse inconnue est renvoyée vers le domaine de la boutique, l’administration reste accessible
  7. RFC 9309 — le protocole robots.txt : une consigne pour les robots d’exploration, pas un contrôle d’accès
  8. Guide utilisateur de PrestaShop 8 — la page Performances (Smarty, mode debug, CCC, cache)
  9. Code de PrestaShop 9.2.0 — options CCC de la page Performances et effet de « Optimisation Apache »
  10. PrestaShop DevDocs — optimiser les performances : OPcache, section Cache, mode production
  11. Code de PrestaShop 9.2.0 — config/defines.inc.php : effets du mode debug, dossier du cache
  12. PrestaShop DevDocs — les dossiers du cache et le fichier class_index.php
  13. Documentation Plesk Obsidian — paramètres d’Apache et Nginx, mise en cache Nginx (en français)
  14. Code de PrestaShop 9.2.0 — classe Cookie : nom du cookie, domaine, limite de 4 096 octets
  15. Flouci — modules de paiement pour WooCommerce, PrestaShop, Magento et Shopify
  16. GPG Checkout — kits de paiement, modules e-shop et notification de serveur à serveur
  17. Unicode CLDR — données des devises : le dinar tunisien (TND) à trois décimales
  18. Flouci — créer un paiement : montant exprimé en millimes
  19. PrestaShop DevDocs — du panier à la commande : moyens de paiement, préférences, états, e-mails, commandes créées depuis le back-office
  20. Flouci — notifications de paiement signées, et comment vérifier qu’elles viennent bien de Flouci
  21. Code de PrestaShop 9.2.0 — PaymentModule::validateOrder(), les contrôles faits à la création d’une commande
  22. Code de PrestaShop 9.2.0 — Context::getComputingPrecision(), précision de calcul tirée des décimales de la devise
  23. Code de PrestaShop 9.2.0 — états de commande installés et leurs options
  24. Code de PrestaShop 9.2.0 — FrontController : page de maintenance et code 503
  25. Documentation Plesk Obsidian — pare-feu applicatif (ModSecurity) : requêtes refusées et codes 403 dans les journaux (en français)
  26. Documentation Plesk Obsidian — fichiers de log et explorateur de logs (en français)
  27. PrestaShop DevDocs — la commande en une page de la 9.2 et la compatibilité des modules de paiement
  28. PrestaShop DevDocs — le cookie de PrestaShop, son contenu et sa limite de taille
  29. Code de PrestaShop 8.2.0 — classe Cookie : même refus au-delà de 4 096 octets
  30. Code de PrestaShop 9.2.0 — valeurs installées par défaut : niveau des alertes de journal par e-mail (4), cookie SameSite (Lax)
  31. IETF — révision de la RFC 6265 sur les cookies : un cookie SameSite=Lax n’accompagne une navigation venue d’un autre site qu’avec une méthode « sûre » comme GET, pas un formulaire POST
  32. Code de PrestaShop 9.2.0 — CartController : contrôle du jeton avant toute modification du panier
  33. PrestaShop DevDocs — liste de contrôle après une mise à jour (back-office inaccessible)
  34. Guide utilisateur de PrestaShop 8 — la page Logs et ses niveaux de gravité
  35. Code de PrestaShop 9.2.0 — PrestaShopLogger : niveaux de gravité et envoi des alertes par e-mail
  36. Code de PrestaShop 9.2.0 — installation : l’adresse de l’administrateur reçoit les alertes de journal
  37. Code de PrestaShop 9.2.0 — app/config/config.yml : emplacement et rotation des journaux, valeurs par défaut (la rotation quotidienne est déclarée dans config_prod.yml)
  38. Code de PrestaShop 9.2.0 — le mode debug limité aux navigateurs qui portent un cookie
  39. Code de PrestaShop 9.2.0 — page Performances : désactivation des modules non intégrés, vidage du cache
Un menu porte un autre nom chez vous ?

Les libellés cités sont ceux de PrestaShop 9.2 en français ; ils varient un peu selon la version et les modules installés, et certains réglages de Plesk dépendent de votre pack. Décrivez-nous ce que vous voyez, nous vous indiquons le bon chemin.

Poser la question au support
Un paiement passé sans commande ?

Donnez-nous l’heure et la référence, nous regardons ce que le serveur a reçu.

Les journaux d’accès disent en quelques minutes si la notification de votre prestataire est arrivée. Ticket ou livechat, 7j/7, en français ou en tunisien.