Problèmes fréquents

Lors de l’appel à l’URL de notification j’obtiens une erreur 500:

Il arrive parfois qu’une erreur 500 apparaisse lors de l’appel à l’URL de notification. Cette erreur est un bug applicatif et ne signifie pas que le problème vienne de notre module. Pour avoir le détail de l’erreur, vous devez activer les logs apache de votre serveur puis rechercher l’appel en question qui a posé problème.

Si vous n'avez pas accès aux logs d'erreur de votre serveur vous pouvez faire afficher l'erreur sur la page de retour en procédant de la manière suivante:

  1. Désactivez l'URL de notification à la fin du paiement dans le Back Office Marchand.

    Pour rappel la désactivation s'effectue dans Paramétrages / Règles de notifications / Clic droit sur URL de notification à la fin du paiement / Désactiver la règle.

  2. Faites afficher les erreurs en activant le mode DEV sur votre boutique PrestaShop. Pour cela remplacez dans le fichier defines.inc.php qui se trouve dans le répertoire config:

    define('_PS_MODE_DEV_', false);

    par: define('_PS_MODE_DEV_', true);

  3. Effectuez un paiement de test et cliquez sur le bouton retourner à la boutique, votre erreur devrait s'afficher à l'écran.
  4. Une fois l'erreur relevée, n'oubliez pas d'enlever le mode DEV sur votre boutique PrestaShop et de réactiver l'URL de notification à la fin du paiement.

Remettre le logo de la méthode de paiement PayZen sur PrestaShop 1.7 :

Depuis la version 1.7 de PrestaShop, le logo des méthodes de paiement n'est plus affiché. Nous nous sommes donc adapté à cette nouvelle présentation.

Si vous souhaitez remettre le logo il faudra modifier le code du module comme ceci:

  • Ouvrir le fichier AbstractPayZenPayment.php présent dans /modules/payzen/classes/payment/
  • Reportez-vous environ à la ligne 142 (public function getPaymentOption).
  • Décommentez la ligne (enlevez //) contenant setlogo et retirez le ; sur la ligne précédente.

On obtient ce rendu:

$option->setCallToActionText($this->getTitle((int)$cart->id_lang))

->setModuleName(‘payzen’)

->setLogo(‘../modules/payzen/views/img/’.$this->getLogo());

Modifier le logo de la méthode de paiement PayZen :

Si vous souhaitez changer le logo proposé par défaut lors du choix de moyen de paiement, remplacez le fichier BannerLogo1.gif, situé dans le répertoire modules/payzen/views/img/, par le vôtre en gardant le même nom.

Pour le logo du paiement en plusieurs fois, changez le fichier BannerLogo2.gif.

Lors de l’installation PrestaShop affiche que le module n’est pas vérifié :

Depuis une des dernières versions de PrestaShop, ce message s’affiche lorsque vous essayez d’installer une version qui ne provient pas de PrestaShop Addons.

PrestaShop essaye de vous orienter vers une version payante mais le module que vous avez téléchargé est bien la version officielle de PayZen et est parfaitement compatible avec PrestaShop.

Vous pouvez donc cliquer sur le bouton Continuer l’installation en toute sécurité.

PayZen n’apparait pas dans les méthodes de paiement :

Il arrive parfois que le module de paiement n’apparaisse pas dans la liste des méthodes de paiement (côté Front Office).

Ce cas peut se produire dans les conditions suivantes :

  • Vous avez paramétré un montant maximum / minimum

Vérifiez que vous n’avez pas configuré de restrictions sur le montant dans le module. Pour cela rendez-vous dans la Configuration du module puis cliquez sur l’onglet Paiement en une fois.

  • Option Désactiver les modules non développés par PrestaShop

Vérifiez que l’option Désactiver les modules non développés par PrestaShop ne soit pas sur OUI. Cette option se situe dans le menu Paramètres avancés / Performances.

  • Votre module a besoin d’être réinitialisé

Ceci intervient notamment quand de nombreuses modifications ont été effectuées depuis votre boutique PrestaShop. Réinitialiser le module va permettre de reprendre les configurations de votre boutique avec les nouveaux paramètres.

ATTENTION : Si vous avez déjà paramétré le module, n’oubliez pas de relever l’identifiant de site et la clé avant la réinitialisation.

  • Restrictions des pays

Pour tous les modules de paiements, PrestaShop n'active que le pays par défaut dans la restriction des pays. Il vous faudra donc activer les pays que vous souhaitez depuis le Back Office PrestaShop afin que le moyen de paiement apparaisse pour les autres pays.

La configuration s'effectue dans le Back Office PrestaShop dans Modules / Paiement / Restrictions des pays.

  • Code ISO de la devise

Vérifiez que le code ISO 4217 est bien respecté dans le paramétrage de la devise. Par exemple l'Euro doit être paramétré avec le code EUR.

La configuration s'effectue dans le Back Office PrestaShop dans Localisation / Devises.

Le paiement en plusieurs fois n'apparaît pas dans la liste de moyen de paiement de l'acheteur

Il arrive parfois que le module de paiement en plusieurs fois PayZen n’apparaisse pas dans la liste des méthodes de paiement (côté Front Office).

Ce cas peut se produire dans les conditions suivantes :

  • Vous avez paramétré un montant maximum / minimum

Vérifiez que vous n’avez pas configuré de restrictions sur le montant dans le module PayZen pour le paiement en plusieurs fois. Pour cela rendez-vous dans la Configuration du module puis cliquez sur l’onglet Paiement en plusieurs fois.

  • Option de paiement non crée

Vérifiez que vous avez créé au moins une option de paiement. Si ce n'est pas le cas cliquez sur le bouton Ajouter pour ajouter une option.

  • Le sous module paiement en n fois n'est pas activé

De base le paiement en plusieurs fois est désactivé, vérifiez que l'option Activé est bien sélectionné dans le paramétrage Activation du sous module.

  • Advanced EU Compliance

Seul le paiement en une fois est fonctionnel avec le module Advanced EU Compliance.

C’est une contrainte technique imposée par ce module qui ne prend en compte qu’une seule option de paiement par module. Nous avons donc naturellement choisi d’activer le paiement en une fois.

La seule possibilité pour utiliser le paiement multiple avec le module Conformité européenne améliorée est de désactiver l’option Activer la page de commande avancée dans la configuration de ce module. Toutefois l’affichage de la page de commande sur le site sera différent.

A noter que le module Advanced EU Compliance a été abandonné par PrestaShop dans les versions 1.7.x.

Lors de l’appel à l’URL de notification j’obtiens une erreur 404 :

Après une migration de PrestaShop 1.4 vers 1.5 ou 1.6, il arrive fréquemment que l’on obtienne une erreur 404. Cette erreur est liée au fait que l’URL de notification a changé depuis la version 1.3d (compatible avec PrestaShop 1.4) de notre module de paiement. Vérifiez donc que l’URL notification n’est plus : http://www.votresite.com/modules/vads/validation.php

Et qu’elle a bien été remplacée par : http://www.votresite.com/modules/payzen/validation.php

Certaines commandes remontent avec un écart de quelques centimes

Si certaines commandes remontent avec un écart de quelques centimes, ce n’est pas lié au module de paiement mais à PrestaShop qui ne calcule pas correctement l’arrondi entre le HT et le TTC.

Ce problème a été évoqué à de nombreuses reprises sur le forum PrestaShop

Erreur 22 – CUST_COUNTRY lors d’un paiement :

Si vous recevez un e-mail de PayZen avec l’erreur 22 – CUST_COUNTRY, c’est que le code pays que vous avez saisi dans PrestaShop ne respecte pas le code ISO 3166.

Pour modifier le code ISO, vous devez vous rendre sur PrestaShop dans le menu Localisation / Pays et saisir un code valide.

Pour plus d’informations sur le code ISO 3166, veuillez vous rendre sur le lien suivant :

http://www.iso.org/iso/fr/home/standards/country_codes.htm

Les remboursements et annulations ne fonctionnent pas depuis PrestaShop

Le module de paiement ne permet pas d'annuler ou de rembourser des paiements via le Back Office PrestaShop.

En revanche vous pouvez effectuer l'opération depuis le Back Office Marchand et être notifié sur PrestaShop afin de mettre à jour la commande. Il faudra pour cela paramétrer l'URL de notification sur une opération provenant du Back Office.

Cette étape est décrite au chapitre Paramétrage de l'URL de notification.

Comment configurer le module en mode multi boutiques:

Il n'y a pas de particularité avec notre module de paiement, il se configure comme tous les autres modules sur PrestaShop.

Le choix de la boutique se fait en haut à gauche dans le menu de PrestaShop, vous pouvez sélectionner:

  • Toutes les boutiques afin de modifier le paramétrage de toutes les boutiques.
  • Un groupe pour modifier toutes les boutiques d'un groupe.
  • Une boutique pour modifier le paramétrage d'une seule boutique.

La configuration se fait en général sur Toutes les boutiques puis boutique par boutique, pensez notamment à modifier le nom et l'URL de la boutique dans la partie Configuration générale > Personnalisation de la page de paiement.

Le module gère également le mode multi-boutique pour l'appel à l'URL de notification. Vous devez saisir l'URL proposée dans le module de la boutique par défaut sur le Back Office Marchand. Cette étape est décrite dans le chapitre Paramétrage de l'URL de notification.

Le champ xxx de votre adresse de facturation est invalide.

Si un acheteur voit le message: le champ “Code Postal/Pays” de votre adresse de facturation est invalide lors du choix de moyen de paiement:

  • Vérifiez dans la partie paiement en une fois que Proposer FacilyPay Oney soit sur Non.
  • Vérifiez que le sous-module Paiement FacilyPay Oney ne soit pas activé.

En effet l'activation de FacilyPay Oney, applique des restrictions sur l’adresse, le téléphone, code postal, code pays… Ces restrictions bloqueront les acheteurs situés dans des pays étrangers.