Prestashop : comment corriger Paypal fatal error ?

Prestashop : Activer le mode debug pour identifier l’erreur

Un fatal error PayPal indique une erreur critique empêchant le chargement d’une page. Active le mode debug dans Prestashop pour afficher les détails de l’erreur et localiser le fichier ou le module concerné.

Va dans /config/defines.inc.php et remplace false par true pour la constante _PS_MODE_DEV_. Recharge la page : Prestashop affichera l’origine exacte de l’erreur, souvent liée à une fonction manquante ou un conflit de module.

Prestashop : Mettre à jour le module PayPal

Une version obsolète du module PayPal peut provoquer des fatal errors, surtout après une mise à jour de Prestashop ou de PHP. Les dernières versions corrigent de nombreuses incompatibilités.

Va sur PrestaShop Addons, télécharge la dernière version stable du module, puis mets à jour via Modules > Gestion des modules. Cela permet de restaurer un fonctionnement normal et d’éviter les erreurs liées à des fichiers dépréciés.

Prestashop : Vérifier la version de PHP utilisée

Le module PayPal nécessite une version compatible de PHP. Si ton hébergement a été mis à jour vers PHP 8.x alors que le module ne supporte que PHP 7.4, cela peut déclencher une fatal error.

Va dans Paramètres > Informations système pour voir la version PHP. Reviens à PHP 7.4 temporairement si nécessaire, ou installe une version récente du module PayPal compatible avec PHP 8+.

Prestashop : Réinitialiser le module PayPal

Une erreur fatale peut venir d’une mauvaise configuration ou d’un fichier corrompu du module. Réinitialiser permet de restaurer les paramètres par défaut sans supprimer les données de commande.

Va dans Modules > Gestion des modules, clique sur "Réinitialiser" à côté de PayPal. Reconfigure ton compte ensuite. Prestashop relancera l’installation propre du module, ce qui corrige souvent les blocages critiques.

Prestashop : Vérifier les logs d’erreur PHP

Les fichiers logs PHP contiennent souvent l’explication exacte d’une fatal error. Ils se trouvent dans /var/logs/ sur Prestashop, ou dans le répertoire logs de ton hébergement.

Ouvre les fichiers paypal.log et php_error.log, cherche les messages "Fatal error", "Undefined function" ou "Cannot redeclare". Ces lignes permettent de localiser l’appel fautif ou le fichier responsable du blocage complet.

Prestashop : Corriger les conflits entre modules

Une fatal error peut apparaître lorsqu’un autre module entre en conflit avec PayPal (ex : surcharge de classe ou hook redondant). Cela empêche le module de se charger correctement.

Désactive temporairement les modules tiers (surtout ceux liés au paiement ou au tunnel de commande), puis teste à nouveau. Prestashop redeviendra stable si le conflit est levé. Réactive les modules un par un pour identifier le coupable.

Prestashop : Supprimer puis réinstaller proprement le module

Si la fatal error persiste, désinstalle totalement le module PayPal, supprime ses dossiers restants dans /modules/paypal/, puis réinstalle une version propre.

Va dans Modules > Gestion des modules, clique sur "Désinstaller", puis supprime manuellement le dossier du module via FTP. Télécharge ensuite le dernier zip officiel. Cette méthode élimine les erreurs liées à des fichiers modifiés ou partiels.

Prestashop : Vérifier les permissions des fichiers du module

Des permissions incorrectes sur les fichiers du module peuvent provoquer des erreurs fatales si Prestashop ne peut pas accéder à certains fichiers ou classes PHP.

Connecte-toi via FTP, va dans /modules/paypal/, et assure-toi que les fichiers ont les droits 644 et les dossiers 755. Ces paramètres garantissent que le module peut être lu et exécuté correctement sans bloquer le front-office ou le back-office.

Prestashop : Contrôler les surcharges dans le thème

Certains thèmes personnalisés surchargent les fichiers du module PayPal (ex : order-payment.tpl, paypal-express.tpl) avec du code obsolète ou incomplet, causant des erreurs au chargement.

Va dans /themes/ton-theme/modules/paypal/, renomme le dossier temporairement pour forcer Prestashop à utiliser les fichiers d’origine. Si l’erreur disparaît, corrige ou supprime les surcharges défectueuses du thème.

Prestashop : Contacter le support avec le message d’erreur

Si la fatal error est bloquante malgré toutes les vérifications, contacte le support officiel PrestaShop Addons ou PayPal Business. Fournis le message exact d’erreur, ta version PHP, et la version du module utilisée.

Ils pourront t’envoyer un correctif, un fichier à remplacer ou te guider dans la résolution. Ces erreurs sont souvent connues et corrigées dans les versions suivantes du module PayPal pour Prestashop.