2Checkout Prestashop : 20 problèmes et solutions pour corriger
Résolution des Problèmes Courants entre 2Checkout et PrestaShop
Sommaire
- Erreur de configuration API entre 2Checkout et PrestaShop
- Redirection vers une erreur sur la page de paiement 2Checkout dans PrestaShop
- Paiement échoué avec le statut "Authorization Failed" dans 2Checkout sur PrestaShop
- Double facturation des commandes dans 2Checkout pour PrestaShop
- Notifications IPN non reçues entre 2Checkout et PrestaShop
- Paiement réussi dans 2Checkout, mais commande non validée dans PrestaShop
- Module de paiement 2Checkout non visible à la caisse de PrestaShop
- Devise non supportée par 2Checkout sur PrestaShop
- Erreur "Signature mismatch" avec les IPN de 2Checkout dans PrestaShop
- Lenteur ou délai d'attente lors de la redirection vers 2Checkout dans PrestaShop
- Erreur "Hash mismatch" entre 2Checkout et PrestaShop
- Paiement sandbox de 2Checkout fonctionne, mais production échoue sur PrestaShop
- Mauvais statut de commande dans PrestaShop après paiement réussi sur 2Checkout
- Erreur d’incompatibilité entre le module 2Checkout et PrestaShop
- Taxes incorrectes entre PrestaShop et 2Checkout
- Clients bloqués sur la page de paiement 2Checkout avec PrestaShop
- Traductions incorrectes du module 2Checkout pour PrestaShop
- Commandes en double créées dans PrestaShop après paiement via 2Checkout
- Restrictions géographiques des paiements avec 2Checkout dans PrestaShop
- Boutons de paiement 2Checkout non responsive dans PrestaShop
1. Erreur de configuration API entre 2Checkout et PrestaShop
Une erreur de configuration des clés API dans 2Checkout est une cause fréquente d'échec de communication avec PrestaShop. Ce problème apparaît lorsque le Merchant Code ou la clé secrète sont mal renseignés ou ne correspondent pas aux informations du compte 2Checkout. Ces données sont essentielles pour connecter PrestaShop à 2Checkout et autoriser les transactions sécurisées. Toute divergence entraîne des erreurs empêchant le traitement des paiements.
Pour résoudre cela, vérifiez attentivement les clés API et assurez-vous qu’elles correspondent exactement à celles générées dans votre tableau de bord 2Checkout. Assurez-vous également d’utiliser les paramètres corrects selon l’environnement (sandbox ou production). Activez le mode debug dans PrestaShop pour afficher les éventuelles erreurs supplémentaires. Enfin, effectuez des tests en mode sandbox pour confirmer que les paiements fonctionnent avant de passer en production.
2. Redirection vers une erreur sur la page de paiement 2Checkout dans PrestaShop
Une redirection vers une page d’erreur lors d’un paiement via 2Checkout peut être due à une mauvaise configuration de l’URL de retour. Cette URL est essentielle pour assurer que les clients soient renvoyés à votre boutique après avoir terminé leur paiement. Si elle est mal configurée ou manquante, 2Checkout ne peut pas compléter le processus de paiement correctement, provoquant une erreur pour l’utilisateur.
Pour corriger cela, configurez l’URL de retour dans le tableau de bord 2Checkout en utilisant l’URL fournie par PrestaShop. Activez également l’option "Return after sale" dans les paramètres 2Checkout pour garantir un retour automatique après la transaction. Vérifiez que le module PrestaShop est bien à jour et compatible avec votre version actuelle de la boutique. Enfin, réalisez plusieurs tests en mode sandbox pour garantir une configuration correcte.
3. Paiement échoué avec le statut "Authorization Failed" dans 2Checkout sur PrestaShop
L’erreur "Authorization Failed" se produit lorsque les informations transmises depuis PrestaShop à 2Checkout, telles que la devise ou les montants, ne respectent pas les formats ou les devises acceptées par 2Checkout. Ce problème peut également survenir si le compte 2Checkout n’est pas entièrement activé pour accepter des transactions.
Pour résoudre ce problème, assurez-vous que les devises configurées dans PrestaShop sont prises en charge par 2Checkout (comme USD, EUR ou GBP). Vérifiez aussi les montants transmis, notamment les taxes et frais additionnels, pour qu’ils correspondent aux exigences de 2Checkout. Si nécessaire, contactez leur support pour vérifier que votre compte est activé pour traiter des transactions en production.
4. Double facturation des commandes dans 2Checkout pour PrestaShop
La double facturation est un problème critique qui survient généralement lorsque des notifications IPN sont envoyées plusieurs fois ou lorsque la redirection automatique est mal configurée. Ce problème peut entraîner une perte de confiance des clients et un traitement manuel fastidieux pour corriger les erreurs de paiement.
Pour corriger cela, désactivez temporairement la redirection automatique après paiement dans les paramètres 2Checkout pour éviter que des notifications soient envoyées deux fois. Vérifiez également dans les journaux de PrestaShop si plusieurs notifications IPN sont enregistrées pour une même transaction. Testez le système en sandbox pour confirmer que le problème est résolu avant d’appliquer les modifications en production.
5. Notifications IPN non reçues entre 2Checkout et PrestaShop
Les notifications IPN (Instant Payment Notifications) permettent à PrestaShop de recevoir des confirmations de paiement en provenance de 2Checkout. Si elles ne sont pas correctement configurées ou bloquées par votre serveur, vos commandes ne seront pas validées automatiquement, ce qui perturbe votre gestion des ventes.
Pour résoudre ce problème, configurez correctement l’URL IPN dans le tableau de bord 2Checkout en la pointant vers l’URL fournie par votre module PrestaShop. Assurez-vous que votre serveur accepte les requêtes provenant des adresses IP de 2Checkout. Si le problème persiste, contactez votre hébergeur pour vérifier que le pare-feu ne bloque pas les notifications.
6. Paiement réussi dans 2Checkout, mais commande non validée dans PrestaShop
Un problème courant est que les paiements sont validés dans 2Checkout, mais les commandes restent non validées ou en attente dans PrestaShop. Cela est souvent dû à une mauvaise configuration des notifications IPN ou à des erreurs de traitement des statuts dans le module 2Checkout de PrestaShop. Cela peut provoquer des confusions entre vous et vos clients.
Pour résoudre ce problème, vérifiez que les IPN sont bien activées et configurées dans votre compte 2Checkout. Dans le module PrestaShop, assurez-vous que les statuts de commande par défaut sont correctement paramétrés (par exemple, "Paiement accepté" pour les transactions réussies). Testez également la connexion en mode sandbox pour confirmer que tout fonctionne correctement avant d’utiliser le module en production.
7. Module de paiement 2Checkout non visible à la caisse de PrestaShop
Lorsque le module 2Checkout n'apparaît pas sur la page de caisse, cela peut être causé par des restrictions liées aux devises, aux zones géographiques ou aux groupes de clients. PrestaShop permet de limiter les options de paiement en fonction de ces paramètres, ce qui pourrait expliquer l’absence du module.
Pour résoudre ce problème, vérifiez dans les paramètres du module 2Checkout que toutes les devises compatibles sont activées. Configurez également le module pour être disponible dans toutes les zones géographiques nécessaires et pour tous les groupes de clients. Testez la caisse avec des produits standards et différents profils d’utilisateurs pour confirmer que le module est bien visible.
8. Devise non supportée par 2Checkout sur PrestaShop
2Checkout ne prend en charge qu’un certain nombre de devises internationales, telles que l’USD, l’EUR ou le GBP. Si votre boutique utilise une devise locale non acceptée, comme le CFA ou le Peso argentin, les paiements échoueront, car 2Checkout ne pourra pas traiter ces transactions.
Pour résoudre ce problème, limitez les options de devises disponibles dans votre boutique PrestaShop à celles prises en charge par 2Checkout. Vous pouvez également activer la conversion automatique des devises dans les paramètres de votre boutique pour permettre aux clients de payer dans une devise acceptée. Cela garantit une expérience fluide pour tous les utilisateurs.
9. Erreur "Signature mismatch" avec les IPN de 2Checkout dans PrestaShop
L’erreur "Signature mismatch" se produit lorsque la clé secrète utilisée pour valider les IPN dans PrestaShop ne correspond pas à celle configurée dans 2Checkout. Cette incohérence empêche PrestaShop de traiter correctement les notifications de paiement, ce qui entraîne des erreurs dans la validation des commandes.
Pour corriger cela, assurez-vous que la clé secrète dans le module PrestaShop est identique à celle de votre compte 2Checkout. Vérifiez également les paramètres d’environnement (sandbox ou production). Une fois la configuration mise à jour, testez l’envoi des notifications IPN depuis 2Checkout pour vous assurer qu’elles sont bien reconnues par votre boutique.
10. Lenteur ou délai d'attente lors de la redirection vers 2Checkout dans PrestaShop
Une redirection lente vers la page de paiement 2Checkout peut frustrer vos clients et les dissuader de finaliser leurs achats. Ce problème est souvent causé par un serveur surchargé, des conflits avec d’autres modules ou des scripts mal optimisés dans PrestaShop.
Pour améliorer cela, optimisez les performances de votre serveur en augmentant la mémoire PHP ou en activant la mise en cache dans PrestaShop. Désactivez temporairement les autres modules, surtout ceux liés au paiement, pour détecter d’éventuels conflits. Enfin, testez la redirection sur différents navigateurs pour vous assurer qu’elle fonctionne rapidement et sans erreur.
11. Erreur "Hash mismatch" entre 2Checkout et PrestaShop
L’erreur "Hash mismatch" indique une incohérence entre les données transmises par PrestaShop et celles attendues par 2Checkout. Cela concerne généralement les montants, les taxes, ou la devise utilisée. Cette erreur empêche 2Checkout de valider correctement le paiement.
Pour résoudre cela, vérifiez que les montants totaux envoyés à 2Checkout incluent correctement les taxes et qu’ils respectent les formats acceptés. Assurez-vous également que la devise utilisée dans la commande est conforme à celle configurée dans 2Checkout. Faites des tests en mode sandbox pour identifier les éventuelles anomalies et ajustez votre configuration.
12. Paiement sandbox de 2Checkout fonctionne, mais production échoue sur PrestaShop
Il arrive que les paiements fonctionnent parfaitement en sandbox, mais échouent lors du passage en production. Cela est souvent dû à une utilisation incorrecte des clés API ou à une activation incomplète du compte 2Checkout. En production, l’environnement exige des clés spécifiques qui ne doivent pas être confondues avec celles de sandbox.
Pour résoudre cela, assurez-vous que les clés API production sont bien configurées dans le module PrestaShop. Vérifiez également que votre compte 2Checkout a été entièrement activé et approuvé pour traiter des paiements réels. Si le problème persiste, contactez le support de 2Checkout pour confirmer l’état de votre compte et obtenir de l’aide.
13. Mauvais statut de commande dans PrestaShop après paiement réussi sur 2Checkout
Un mauvais statut de commande dans PrestaShop, même après un paiement réussi sur 2Checkout, est un problème courant. Cela est souvent lié à une configuration incorrecte des statuts par défaut dans le module ou à un problème avec les notifications IPN. Cela peut entraîner des confusions dans la gestion de vos commandes.
Pour résoudre ce problème, configurez les statuts par défaut dans le module 2Checkout pour que les paiements validés soient marqués comme "Paiement accepté". Assurez-vous également que les notifications IPN sont bien activées et correctement transmises. Testez en mode sandbox pour vérifier que les statuts se mettent à jour automatiquement après chaque transaction.
14. Erreur d’incompatibilité entre le module 2Checkout et PrestaShop
Une incompatibilité entre le module 2Checkout et PrestaShop peut survenir si vous utilisez une version obsolète du module ou si votre version de PrestaShop n’est pas compatible. Ce problème peut empêcher la validation des paiements ou entraîner des erreurs sur la page de caisse.
Pour résoudre cela, téléchargez la dernière version du module 2Checkout depuis le site officiel ou le marketplace PrestaShop. Assurez-vous que votre version de PrestaShop est compatible avec le module. En cas de problème persistant, contactez le support de 2Checkout ou de PrestaShop pour obtenir des informations sur les versions compatibles.
15. Taxes incorrectes entre PrestaShop et 2Checkout
Un problème fréquent est que les taxes configurées dans PrestaShop ne sont pas transmises correctement à 2Checkout, ce qui peut entraîner des écarts dans les montants facturés. Cela se produit généralement lorsque les règles de taxes ou les formats des données ne correspondent pas entre les deux systèmes.
Pour corriger cela, vérifiez que les règles de taxes dans PrestaShop sont correctement définies et activées pour tous les produits. Assurez-vous également que les montants totaux, incluant les taxes, sont correctement transmis à 2Checkout. Testez vos paramètres en sandbox et comparez les montants entre PrestaShop et 2Checkout pour vous assurer qu’ils correspondent parfaitement.
16. Clients bloqués sur la page de paiement 2Checkout avec PrestaShop
Les clients peuvent rester bloqués sur la page de paiement de 2Checkout s’il y a un conflit entre les scripts JavaScript de PrestaShop ou si la redirection n’est pas configurée correctement. Cela nuit à l’expérience utilisateur et peut réduire les taux de conversion.
Pour résoudre ce problème, vérifiez dans le module 2Checkout que la redirection après paiement est activée et correctement configurée. Testez également la page de paiement sur différents navigateurs pour détecter d’éventuels conflits JavaScript. Si le problème persiste, désactivez temporairement les modules tiers pour identifier celui qui pourrait causer des interférences.
17. Traductions incorrectes du module 2Checkout pour PrestaShop
Les traductions incorrectes ou incomplètes du module 2Checkout peuvent donner une impression peu professionnelle à vos clients, surtout dans les boutiques multi-langues. Cela peut être dû à un fichier de traduction obsolète ou mal configuré dans PrestaShop.
Pour corriger cela, accédez à la section International > Traductions dans le back-office de PrestaShop et personnalisez les textes associés au module 2Checkout. Si des traductions manquent, éditez directement les fichiers de traduction situés dans le dossier du module. Vous pouvez également exporter et réimporter des fichiers .json de traduction pour garantir leur complétude.
18. Commandes en double créées dans PrestaShop après paiement via 2Checkout
Les commandes en double peuvent être générées si les notifications IPN sont envoyées plusieurs fois ou si le traitement des commandes est mal synchronisé entre 2Checkout et PrestaShop. Cela peut causer des confusions et entraîner des erreurs dans la gestion des commandes.
Pour résoudre ce problème, vérifiez les journaux IPN pour détecter les notifications envoyées en double depuis 2Checkout. Ajustez les paramètres IPN dans 2Checkout pour éviter les doublons et testez le processus en mode sandbox. Assurez-vous que votre serveur ne traite pas plusieurs fois les mêmes notifications en raison d’un temps de réponse prolongé.
19. Restrictions géographiques des paiements avec 2Checkout dans PrestaShop
Si vos clients de certaines régions ne peuvent pas utiliser 2Checkout, cela peut être dû à des restrictions géographiques dans les paramètres de votre module ou dans votre compte 2Checkout. Ces restrictions limitent les zones où le paiement est disponible.
Pour corriger cela, vérifiez dans PrestaShop que 2Checkout est activé pour toutes les zones géographiques pertinentes. Dans le tableau de bord de 2Checkout, assurez-vous que votre compte autorise les paiements dans les pays ciblés. Si nécessaire, contactez le support 2Checkout pour vérifier les limitations appliquées à votre compte.
20. Boutons de paiement 2Checkout non responsive dans PrestaShop
Si les boutons de paiement 2Checkout ne s’adaptent pas correctement aux appareils mobiles, cela peut nuire à l’expérience utilisateur et limiter les conversions. Ce problème est souvent causé par un manque de compatibilité entre le thème PrestaShop et le module.
Pour corriger cela, ajoutez des styles CSS personnalisés pour rendre les boutons adaptatifs. Testez la boutique sur différents appareils et résolutions pour vérifier que le design du bouton est responsive. Si le problème persiste, contactez le support 2Checkout ou votre développeur pour ajuster le thème et garantir une meilleure compatibilité mobile.