Pour installer le module, suivez la documentation fournie avec celui-ci. Si une erreur non-documentée s’affiche, contactez le Support Technique dédié aux modules via ce formulaire : ici

Après l’installation du module, pour qu’il soit visible au sein du menu de votre back-office plateforme ainsi que sur la page de check-out, vous devez veillez à l’activer pour qu’il soit fonctionnel. Si cela ne suffit pas, videz le cache de la plateforme. Vous pouvez également vous déconnecter puis reconnecter et vérifier si cela corrige le problème.

Le numéro de site et le numéro de rang sont définis par votre banque / acquéreur au sein de votre contrat monétique de vente à distance. Ils sont nécessaires au paramétrage de votre compte Paybox. Dans le cadre de l’ouverture de votre compte, vous avez reçu un email intitulé « Paramètres de compte » qui rassemble ces identifiants. Pour le paramétrage du module, seuls les deux derniers chiffres du numéro de rang vous seront demandés.

Le mot de passe Paybox vous permet d’accéder à votre back-office Paybox pour, entre autre, consulter vos transactions. Le nom d’utilisateur et le mot de passe requis vous sont fournis lors de l’ouverture de votre compte. En cas de perte de ces identifiants, contactez le Support Technique pour en obtenir de nouveaux. Ce mot de passe est également utilisé dans le cadre des appels pour les remboursements ou capture dans votre back-office PrestaShop ou Magento.

C’est une clé secrète qui permet de garantir une sécurité optimale par une phase d’authentification lors de l’échange des données entre le site marchand et Paybox.

Une empreinte HMAC, calculée à partir de la clé HMAC, est générée à chaque transaction afin de la sécuriser.

Vous devez générer votre propre clé HMAC via votre back-office Paybox. Pour connaître la procédure de génération de cette clé d’authentification, cliquez ici.

La clé HMAC est dépendante de la plateforme sur laquelle elle est générée. Elle peut être identique sur les deux environnements. Toutefois, pour des raisons de sécurité, il est recommandé de générer une clé dédiée à l’environnement de pré-production et une à l’environnement de production.

Une fois générée, la clé HMAC doit impérativement être activée en cliquant sur le lien que vous recevrez dans un mail dédié. Ce lien est une url à usage unique vers votre back-office. Vous devrez vous authentifier afin de voir apparaître le message «la clé HMAC a bien été activée » en vert.

3-D Secure est un protocole anti-fraude mis en place par Visa et MasterCard. Il vous protège de la répudiation de transactions, en permettant l’authentification du porteur de la carte par sa banque au moment de son achat en ligne. Le protocole 3-D Secure est disponible dans nos solutions, seule une demande d’activation est nécessaire. Votre contrat monétique de vente à distance doit être de type VADS. Paybox est certifié 3-D Secure auprès de toutes les banques.

3-D Secure peut être activé en mode “automatique” pour l’ensemble des paiements ou en mode “sélectif” en fonction de votre paramétrage. Dans ce cas vous devez spécifier ce montant au sein du back-office de votre plateforme.

Le paiement en 3 fois permet au client d‘étaler son paiement en 3 mensualités. Si le client choisit le mode de paiement en 3 fois, le module calcule le montant des échéances et l’envoie à Paybox. Cette échéancier sera alors présenté sur la page de paiement. Au moment du paiement, le client saisit ses données de carte bancaire. Paybox va stocker une empreinte. A chaque échéance, Paybox fera une demande d’autorisation auprès du serveur bancaire et enverra au commerçant une IPN (notification de paiement instantanée). En cas d’échec, le paiement en 3 fois sera résilié.   A ce jour, au sein des modules, seul le paiement en 3 fois est intégré.

Pour que le paiement en 3 fois fonctionne, il doit être activé au sein de votre solution Paybox. Le paiement en 3 fois est intégré au sein du Pack Flexible mais est en option au sein du Pack Essentiel. Si vous souhaitez souscrire à cette option, merci de contacter notre Service Commercial.

Il est possible de n’afficher qu’un bouton de paiement sur la page de checkout qui permettra l’utilisation des cartes les plus courantes : CB, Visa, Mastercard et e Carte bleue. Pour cela, il faut activer uniquement le moyen de paiement CB, et tous ces moyens de paiement seront acceptés. Il conviendra alors d’adapter le pictogramme utilisé pour représenter le moyen de paiement, avec une image qui regroupe ces moyens de paiement.

Si les boutons des moyens de paiement n’apparaissent pas dans la page de finalisation de commande, vérifiez :

• Que le module de paiement est bien installé ET activé.
• Que les moyens de paiement souhaités sont bien activés.
• Que le montant de la commande est bien supérieur au montant minimum spécifié pour ce moyen de paiement.
• Qu’un autre module de paiement similaire n’est pas activé (Version antérieure du module de paiement Paybox par exemple).
• Que le cache est bien vidé ou régénéré.

Dans des cas particuliers, il se peut que les boutons de paiement ne soient pas correctement représentés. Ce problème vient généralement de l’utilisation d’un thème graphique pour votre boutique et est lié au versionning de celui-ci. Dans tous les cas, un correctif peut être mis en place, via l’ajout de règles de style.

Lorsqu’un client clique sur le moyen de paiement de son choix, le module appelle la page de paiement en redirection. Celle-ci traite la création du formulaire de paiement et le choix de la plateforme utilisée pour soumettre ce formulaire. S’il ne se passe rien lorsque le client clique sur un moyen de paiement, alors une erreur est survenue. Dans la plupart des cas, il s’agit d’une librairie manquante. Reportez-vous à la documentation fournie avec le module.

Il peut y avoir plusieurs sources d’erreurs, reportez-vous à la documentation fournie avec le module. Si l’erreur n’est pas documentée, contactez le Support Technique via le formulaire dédié en indiquant le contenu du message d’erreur rencontré.

Le message d’erreur « Paybox3 » apparaît si aucun paramètre n’est envoyé à Paybox. Reportez-vous à la documentation fournie avec la module, et vérifiez le journal d’erreur du module. Vous pouvez également contacter le Support Technique via le formulaire dédié en indiquant le contenu message d’erreur rencontré.

Le message d’erreur « Incohérence des paramètres » s’affiche lorsqu’il y a une incohérence dans les paramètres renseignés au sein du module de paiement. Vérifiez les paramètres d’identifiant que vous avez saisis :

• Numéro de rang
• Numéro de site (composé uniquement des deux derniers chiffres exemple 001 saisir 01)

Vérifiez également que le montant de la commande est cohérent avec le montant minimum et maximum spécifiés sur votre contrat d’adhésion Paybox by Verifone. Vérifiez enfin que votre solution Paybox by Verifone est bien paramétrée pour le service utilisé (paiement en 3 fois, moyens de paiement complémentaires, devises, etc). Pour toute question sur ce point, contactez notre Service Commercial.

Une IPN – Instant Payment Notification ou Notification instantanée de paiement – est un appel du serveur Paybox vers l’url générée par le module sur le serveur commerçant, pour notifier de l’issue d’une transaction de paiement. L’appel est instantané mais il peut y avoir un délai d’une à quelques secondes, dû au trafic par exemple. En cas d’échec de réception de l’appel, un mail d’alerte (Warning) est envoyé sur l’adresse email spécifiée au sein du contrat d’adhésion Paybox by Verifone. A la fin de cet email, il est spécifié l’erreur http rencontrée.

Vérifiez que la réécriture des urls est bien configurée sur votre plateforme ou sur votre site. Le module génère les urls de retour lors de la création du formulaire de redirection. Un problème de configuration peut amener à une génération erronée des urls. Consultez le journal d’erreur du module.

Lorsque le client choisit de retourner sur le site marchand suite à son paiement, le module vérifie que la commande a été validée, suite à la réception d’une IPN. Si ce n’est pas le cas, le module attend environ 1 seconde avant de revérifier. Après 10 tentatives, le module considère que le paiement est en échec. Consultez le journal d’erreur du module Celui-ci contiendra des informations sur l’erreur rencontrée lors de la réception de l’IPN.

Consultez le journal d’erreur du module. Celui-ci contiendra des informations sur l’erreur rencontrée lors de la réception de l’IPN.

Consultez le support technique dédié via ce formulaire.

Le code 500 correspond à une erreur interne rencontrée sur le serveur commerçant. Le traitement de l’IPN (voir définition) a généré une erreur sur le serveur commerçant. Cette erreur est généralement dûe à une problématique d’adresse IP derrière un reverse proxy ou firewall. Veillez à laisser passer les appels provenant des IP des plateformes Paybox (195.101.99.76, 194.2.122.158, 195.25.7.166). Consultez le journal d’erreur du module. Vérifiez si une mise à jour du module est disponible.

Le code 503 correspond à un service indisponible. Cela peut apparaître si votre site est en maintenance par exemple, ou protégé par un mécanisme d’authentification sur votre site pour gérer les urls. Consultez le journal d’erreur du module ainsi que celui de la plateforme. Vérifiez si une mise à jour du module est disponible.

Le code 404 correspond à une page introuvable. Vérifiez que les urls générées par le module sont correctement formées, en cliquant sur le bouton « annuler » sur la page de paiement. Consultez le journal d’erreur du module ainsi que celui de la plateforme. Vérifiez si une mise à jour du module est disponible.

Vérifiez que vous avez bien reçu l’IPN (pas de mail de warning). Vérifiez également que la commande a bien été réglée via le module de paiement Paybox by Verifone. Consultez le journal d’erreur du module ainsi que celui de la plateforme.

Consultez le journal d’erreur du module ainsi que celui de la plateforme. Il est possible qu’une erreur soit survenue en fin de traitement, après la validation de la commande. Vérifiez si une mise à jour du module est disponible.

Pour que vous puissiez faire des opérations – captures, remboursements – directement au sein de votre back-office plateforme (sans passer par le back-office Paybox), vous devez avoir souscrit au Pack Flexible Paybox by Verifone et avoir paramétré votre module de paiement en choisissant « Pack Flexible ».

Pour que vous puissiez faire des opérations – captures, remboursements – directement au sein de votre back-office plateforme (sans passer par le back-office Paybox), vous devez avoir souscrit au Pack Flexible Paybox by Verifone et avoir paramétré votre module de paiement en choisissant « Pack Flexible ». Vérifiez que le mot de passe back-office que vous avez renseigné dans le paramétrage de votre module de paiement est bien identique à votre mot de passe back-office Paybox by Verifone.

Après l’installation du module, vous devez veiller à l’activer. Reportez-vous à la documentation dédiée. Si cela ne suffit pas, videz le cache de la plateforme. Vous pouvez également vous déconnecter et vérifier si cela corrige le problème. Vérifiez également que la commande a bien été réglée via le module de paiement Paybox by Verifone Consultez le journal d’erreur du module ainsi que celui de la plateforme. Vérifiez si une mise à jour du module est disponible.

Si le montant payé est supérieur à celui de la commande, il peut s’agir d’un écart dans les calculs suite à un remboursement partiel ou une capture partielle. Vérifiez si une mise à jour du module est disponible.

Vérifiez s’il y a eu des opérations effectuées suite au paiement : remboursement partiel ? Annulation produit ? Vérifiez si une mise à jour du module est disponible.

Il faut pour cela ajouter les informations nécessaires dans le formulaire à votre disposition dans le paramétrage du module, celui-ci apparaît lors d’un clic sur le bouton ajouter, en vert sur la partie droite haute de la zone des moyens de paiement.

PBX_TYPEPAIEMENT et PBX_TYPECARTE doivent avoir les bonnes valeur.

Nota : on spécifie également le logo de la carte à utiliser. Prendre soin de correctement renseigner les options possibles (type de débit, 3-d secure, etc..)

Pour ajouter un moyen de paiement il faut l’ajouter au fichier xml de configuration, en éditant :

Racine du site/app/code/community/Paybox/Epayment/etc/config.xml

Selon le type du moyen de paiement, il faut l’ajouter à la section correspondante. EXEMPLE: le moyen de paiement illicado est considéré comme une carte prépayée , on l’ajoutera donc dans la section « pbxep_prepaid » ~ Ligne 357 après la definition de Paysafecard, ajouter:

Illicadoimages/pbxep/ILLICADO.45.pngPREPAYEEILLICADO

 

NOTA : l’image spécifiée devra être placée manuellement sur le serveur, et localisée ici :

Racine du site/skin/frontend/base/default/images/pbxep

Après ces modifications, il convient bien sûr de vider le cache Magento. Vous pourrez ensuite paramétrer ce nouveau moyen de paiement, comme les autres déjà présents.

Le module logue les informations relatives aux évènements gérés et reçus par le module dans un fichier de log à la date du jour, dans le répertoire : racine du site/modules/epayment/log/.

Le module logue les informations relatives aux évènements gérés et reçus par le module dans un fichier de log portant le nom « paybox-epayment.log », dans le répertoire : racine du site/var/log/

Le module dispose d’un ‘mode debug’, accessible au pied des paramétrages du module. On peut alors activer le mode qui permet de visualiser le formulaire avant son envoi à la plateforme Paybox. Pour avoir un log des erreurs php, il faut activer le mode debug de WordPress, afin de logger dans un fichier les erreurs : Via FTP ouvrir pour modifier le fichier : racine du site/wp-config.php Localiser la section « For developers: WordPress debugging mode. » Puis mettre ‘true’ à wp_DEBUG et wp_DEBUG_LOG : define(‘wp_DEBUG’, true); define(‘wp_DEBUG_LOG’, true); define(‘wp_DEBUG_DISPLAY’, false); //ceci est pour visualiser à l’écran les erreurs (pas utile le plus souvent) un fichier apparaîtra alors : racine du site/wp-content/ debug.log

Le module dispose d’un ‘mode debug’, et de la possibilité de logger les informations de debug. Si le mode est activé, les paramètres liés au module sont affichés dans le navigateur, et loggés dans un fichier. Si le debug est loggé, il est accessible depuis la configuration de Virtuemart, dans la section Outils, option ‘logs Virtuemart’, une liste des fichiers disponibles devrait apparaître, dont des fichiers du type paybox.X.log.php, (ou X est un numéro de série) est alors accessible en cliquant dessus. Ces fichiers sont aussi accessibles par ftp : racine du site /logs/