PrestaShop : paiement, cache et erreurs de commande

Objectif

Vous allez mettre en place une méthode reproductible pour configurer une boutique PrestaShop et son paiement, puis isoler les incidents liés au code, aux modules, au cache, à PHP ou au serveur. L’objectif est de préserver les données et de savoir quand arrêter les manipulations pour demander une intervention documentée.

Une boutique a besoin d’un hébergement e-commerce cohérent avec son catalogue et son trafic ; consultez aussi la méthode pour traiter les incidents sans perdre de données.

Prérequis

Préparez un accès au Back Office, un accès au compte du prestataire de paiement, le domaine en HTTPS, une sauvegarde vérifiable et les versions exactes de PrestaShop, PHP, du thème et des modules. Selon le forfait, NovaHoster peut ou non fournir sauvegardes gérées, accès fichiers, SSH, réglages PHP, cache serveur ou environnement de préproduction : vérifiez ces droits dans l’Espace client avant de planifier l’opération.

Procédure numérotée

Faire l’inventaire avant modification. Notez la version de PrestaShop et la version PHP, exportez la liste des modules et relevez les réglages de devise, pays, langues, taxes, transporteurs et pages de commande. N’installez pas un module annoncé pour une autre branche majeure sans confirmation de compatibilité.

Sécuriser l’accès. Activez HTTPS et vérifiez que le domaine, les URL de boutique et les URL de retour utilisent le même hôte et protocole. Les certificats, enregistrements DNS, règles de pare-feu et redirections peuvent être gérés différemment selon l’offre NovaHoster ; consultez l’Espace client plutôt que de modifier une configuration serveur inconnue.

Installer le module de paiement. Téléchargez-le depuis le fournisseur ou la marketplace officielle, contrôlez sa version et suivez sa documentation. Renseignez les identifiants de test dans le mode test, puis configurez les URL de notification, les signatures et les événements demandés. Les secrets doivent être conservés dans l’interface prévue et jamais dans un ticket ou un dépôt public.

Vérifier les statuts et retours. Dans le Back Office, confirmez les états de commande correspondant au paiement accepté, refusé, annulé, remboursé ou en attente. Simulez un retour interrompu et une notification reçue après fermeture du navigateur. Le statut doit être confirmé par le mécanisme serveur prévu par le module et non par la seule page affichée au client.

Régler le cache avec méthode. Dans Paramètres avancés > Performances, identifiez le cache natif et les réglages de compilation ou de minification. Un cache de page doit exclure les zones personnalisées : panier, commande, compte client et toute route de paiement. Si un cache serveur, proxy, CDN ou cache objet est actif, établissez qui le gère et où le purger ; ce service n’est pas automatiquement présent dans tous les forfaits.

Purger après un changement ciblé. Après une modification de thème, module, URL ou configuration, purgez le cache PrestaShop puis, s’il existe, le cache intermédiaire correspondant. Testez en navigation privée et avec un compte client de test. Évitez de supprimer manuellement des répertoires de cache ou des tables de base de données sans sauvegarde et sans procédure adaptée à votre version.

Valider avant publication. Testez le catalogue, la recherche, le panier, les codes promotionnels, le calcul de transport, la commande, le retour du paiement, les e-mails et le remboursement. Contrôlez les journaux du module et les logs PrestaShop. N’activez le mode debug que temporairement, sur un créneau maîtrisé et sans exposer de trace aux visiteurs.

Cas d’erreur et diagnostic

Symptôme	Diagnostic progressif	Action prudente
Panier vidé après navigation	Comparez le domaine, le protocole, les cookies et la durée de session ; purgez les caches et testez sans CDN ou cache de page.	Excluez les pages dynamiques et les cookies de panier ; demandez au support où se trouve le cache effectif.
Paiement réussi mais commande non validée	Comparez la transaction chez le prestataire, l’ID de commande et la notification serveur ; vérifiez signature, URL et code HTTP.	Ne créez pas une seconde commande avant rapprochement. Contactez le prestataire puis transmettez à NovaHoster l’horodatage et le code, sans secret.
Erreur 500 ou page blanche	Reproduisez avec le mode debug uniquement si cela peut être fait sans exposer de données ; consultez les logs PrestaShop et PHP, puis identifiez le dernier module ou changement.	Restaurez la sauvegarde ou désactivez le changement selon la procédure de votre version ; ne modifiez pas directement la base sans copie.
Mise en page incohérente après mise à jour	Purgez les caches, vérifiez la compatibilité du thème et des modules, puis contrôlez les erreurs JavaScript dans le navigateur.	Réactivez les optimisations CSS/JS une par une. Une minification incompatible peut masquer la cause.
Back Office lent mais boutique correcte	Mesurez une page précise, regardez les tâches planifiées, les requêtes lentes et les modules administratifs ; distinguez lenteur applicative et saturation serveur.	Demandez au support les métriques disponibles selon votre forfait et évitez d’augmenter une ressource sans diagnostic.

Questions fréquentes

Où trouver les journaux PrestaShop ?

Selon la version, les journaux applicatifs sont accessibles dans Paramètres avancés > Logs. Des journaux PHP ou serveur peuvent se trouver dans l’Espace client ou être accessibles seulement au support. Demandez le chemin et la durée de conservation correspondant à votre offre.

Le cache améliore-t-il toutes les pages ?

Non. Les pages publiques et identiques pour tous les visiteurs peuvent bénéficier d’un cache, tandis que panier, commande, compte et réponses de paiement doivent rester dynamiques. La configuration exacte dépend du module et de la couche de cache utilisée.

Puis-je activer le mode debug en production ?

Uniquement de manière temporaire et contrôlée, car les traces peuvent révéler des chemins, requêtes ou informations internes. Préférez les journaux non exposés et désactivez le mode debug dès la fin du test.

Pourquoi un module de paiement demande-t-il une URL de notification ?

Elle permet au prestataire de notifier le serveur même si le navigateur du client est fermé ou interrompu. Elle doit être accessible, en HTTPS et protégée par le mécanisme d’authentification prévu par le module.

NovaHoster peut-il installer PrestaShop à ma place ?

La disponibilité d’un installateur, d’un accès fichiers, d’une migration ou d’un accompagnement dépend du forfait et du périmètre de support. Vérifiez les services activés dans l’Espace client et demandez une confirmation écrite avant l’intervention.

Quand contacter l’Espace client

Contactez NovaHoster si l’erreur apparaît sur plusieurs appareils, si un code 5xx survient avant l’exécution de PrestaShop, si une notification est bloquée par le réseau, si le certificat ou le DNS ne répond pas, ou si vous avez besoin de journaux serveur. Incluez domaine, URL, heure UTC ou fuseau, méthode de reproduction, code HTTP, version PrestaShop/PHP, dernier changement et identifiant de corrélation éventuel. Expurgez les données personnelles et les secrets.