Page 1
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 Guide d’installation & configuration Module Paybox by Verifone pour PrestaShop Compatible V 1.4 / 1.6 Verifone France 11 A, Rue Jacques Cartier, 78 280 Guyancourt, FRANCE...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 HISTORIQUE DES MODIFICATIONS DATE VERSION DESCRIPTION AUTEUR 01/12/2015 2.2.2 Adaptations PrestaShop 1.6.1.* / Intégration Pack Plus / Mise à jour de la gestion des...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 AVERTISSEMENT Ce document est la propriété exclusive de Verifone. Toute reproduction intégrale ou partielle, toute utilisation par des tiers, ou toute communication à des tiers est interdite sans accord préalable de Verifone.
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 SOMMAIRE HISTORIQUE DES MODIFICATIONS ............. 2 REFERENCES DOCUMENTATIONS ............. 2 LEGENDE ....................2 AVERTISSEMENT .................. 3 INFORMATION & ASSISTANCE ............3 SOMMAIRE ..................... 4 PRÉSENTATION ..............
Page 5
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 3.2.10 Paiement en 3 fois ....................... 22 3.2.11 Montant minimum d’une commande payable en 3 fois ............22 3.2.12 Statut après échéances 1 et 2 ..................... 22 3.2.13 Statut après la dernière échéance..................
Page 6
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 JOURNALISATION DES ERREURS ............44 Guide d’installation & configuration du module Paybox by Verifone pour PrestaShop...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 1. PRÉSENTATION Cette documentation est destinée aux e-commerçants souhaitant intégrer le module Paybox by Verifone à leur site PrestaShop. La compatibilité du module a été validée sur les versions 1.4.x à...
Page 8
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 Le module Paybox by Verifone pour PrestaShop repose sur le pack Essentiel ou le pack Flexible : Pack Flexible Module Paybox by Verifone...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 2. INTÉGRATION DU MODULE 2.1 PRÉREQUIS Avant toute installation, l’intégrateur du module devra se munir des éléments suivants : • Un site PrestaShop hébergé sur un serveur disposant des extensions PHP « php_curl »...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 Sur la page qui s’ouvre, en haut à droite, cliquez sur « Ajouter un nouveau module » Le formulaire d’ajout d’un module apparaît : Cliquez sur le bouton «...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 2.3 ACTIVATION DU MODULE Une fois les fichiers du module déposés sur votre serveur, connectez-vous au Back Office PrestaShop et naviguez dans le menu « Modules > Modules » ou « Modules et Services >...
Page 12
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 Si l’installation du module s’est effectuée correctement, vous verrez un message vert « Module(s) installé(s) avec succès ». et vous accéderez directement à l’interface de configuration du module : Une fois le module Paybox installé, 3 nouveaux statuts de commande...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 3. PARAMÉTRAGE DU MODULE Une fois votre module installé, toujours dans la liste des modules (cf. 2.3), cliquez sur le bouton « Configurer » situé sur la droite : La configuration du module Paybox by Verifone est découpée en 3 parties : Paramètres,...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 3.1 PARAMÈTRES La section « Paramètres » permet de renseigner les identifiants associés à votre compte Paybox. Ces identifiants vous sont transmis par e-mail par Paybox le jour de l’ouverture de votre compte.
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 3.1.1 Numéro de site Saisir le numéro de site constitué de 7 chiffres fourni par Paybox by Verifone. Vous pouvez retrouver ce numéro dans le Back Office de Paybox by Verifone, onglet « Informations ».
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 (Vue du Back Office Paybox by Verifone / Onglet informations) 3.1.3 Identifiant Saisir l’identifiant constitué de 9 chiffres fourni par Paybox by Verifone. Vous pouvez retrouver cet identifiant dans le Back Office de Paybox by Verifone, onglet «...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 3.1.4 HMAC Saisir la clé HMAC que vous avez préalablement générée dans le Back Office Paybox by Verifone. A l’installation, ce champ est pré-rempli avec la clé HMAC d’un compte de test.
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 3.2 CONFIGURATION La section « Configuration » permet de sélectionner la solution Pack Essentiel (Paybox System), Pack Flexible (Paybox System + Direct) ou Pack Plus (Paybox System + Direct plus) puis de paramétrer les fonctionnalités.
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 3.2.1 Environnement Choisir l’environnement : • Test : les paiements sont simulés, aucun encaissement n’est réalisé • Production : les paiements sont réels L’environnement de test permet de vérifier le fonctionnement de la boutique et de valider la...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 3.2.3 Mot de passe du Back Office Paybox Cette option n’est visible que si vous avez choisi la solution « Pack Flexible (Paybox System + Direct) » ou « Pack Plus (Paybox System + Direct plus) ».
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 3.2.6 Statut après paiement Choisir le statut appliqué à la commande PrestaShop une fois le paiement accepté par Paybox. La valeur par défaut s’adapte au type de débit préalablement sélectionné.
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 3.2.10 Paiement en 3 fois Le paiement en 3 fois n’est possible qu’avec les cartes CB, MasterCard, Visa et American Express. Quel que soit le type de débit paramétré, les paiements en 3 fois sont considérés en débit...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 3.3 MOYENS DE PAIEMENT Cette section permet de configurer les moyens de paiement proposés aux clients. Chaque bloc représente un moyen de paiement avec son statut (« Activer » ou non) ainsi que les types de débit compatibles.
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 3.3.1 Modifier un moyen de paiement Pour chaque moyen de paiement, vous pouvez : • Modifier le libellé affiché dans le tunnel de commande, sur la page de choix du moyen de paiement par le client •...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 3.3.2 Ajout d’un moyen de paiement Contactez le support Paybox by Verifone lorsque vous souhaitez ajouter un moyen de paiement supplémentaire, notamment pour obtenir les informations nécessaires à...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 4. PARAMÉTRAGE DE PRESTASHOP 4.1 GESTION DES DEVISES Si vous proposez plusieurs devises à vos clients, il faut associer le module à chaque devise pour laquelle vous souhaitez proposer Paybox by Verifone.
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 4.2 GESTION DES GROUPES DE CLIENT Si vous êtes amené à gérer des groupes spécifiques de clients, le module Paybox by Verifone peut être activé ou désactivé pour certains groupes de clients. La configuration s’effectue dans un encart «...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 4.3 GESTION DES PAYS Le module Paybox by Verifone peut être activé ou désactivé pour des pays spécifiques. La configuration s’effectue dans un encart « Restriction des pays » accessible via le menu «...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 4.4 TRADUCTION ET PERSONNALISATION Paybox by Verifone fournit le module pour PrestaShop en langue française uniquement. Les libellés des moyens de paiement sont modifiables depuis la zone « Moyens de paiement »...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 5. GÉNÉRATION DE LA CLÉ HMAC La clé HMAC est indispensable au bon fonctionnement du module, car elle permet d’authentifier tous les messages échangés entre le site e-commerce et les serveurs Paybox.
Page 31
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 L’interface de génération de la clé HMAC se trouve dans l’onglet « Informations », en bas de la page. Le champ « Phrase de passe » peut être renseigné avec une phrase, un mot de passe ou tout autre texte.
Page 32
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 Il est également possible de saisir dans le champ « Clé » sa propre clé d’authentification (au format hexadécimal) qui aurait été calculée grâce à un autre moyen que cette interface. La taille minimale de la clé...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 VALIDATION Une fois l’enregistrement de la nouvelle clé effectué, un e-mail de demande de confirmation est envoyé au commerçant. Dans cet e-mail se trouvera un lien pointant sur le programme «...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 6. INFORMATIONS DE PAIEMENT Lorsqu’un paiement est réalisé en utilisant le module Paybox by Verifone, plusieurs informations sont stockées avec la commande. Elles permettent d’avoir plus de détails sur la transaction comme par exemple : •...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 Sur la page de détail de commande, un bloc intitulé « Détails du paiement » et précédé du logo « Paybox by Verifone » présente les informations de paiement ainsi que des actions possibles en fonction de la configuration des paiements du module et de l’état de la...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 7. PILOTER VOS TRANSACTIONS DU BACK OFFICE PRESTASHOP Fonctionnalités disponibles uniquement pour les solutions « Pack Flexible (Paybox System + Direct) » et « Pack Plus (Paybox System + Direct plus) ».
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 7.1.1 Débit à l’expédition au changement de statut de commande Un débit automatique de la transaction peut être déclenché au changement de statut de la commande.
Page 38
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 Les fonctionnalités de débit manuel (total ou partiel) ne sont pas disponibles dans le cas d’un paiement en 3 fois. Le statut de la commande après un débit partiel sera indiqué comme « Encaissé...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 7.2 REMBOURSER UNE TRANSACTION 7.2.1 Remboursement d'un paiement en une fois Dans le cas d’une commande payée en une fois et débitée, les actions présentées ci-après sont proposées.
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 7.2.2 Remboursement d'un paiement en 3 fois Dans le cas d’une commande payée en 3 fois et débitée, vous pouvez rembourser la première échéance depuis votre Back Office PrestaShop et annuler les échéances à venir.
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 7.3 REMBOURSER PARTIELLEMENT UNE TRANSACTION 7.3.1 Modification d’un montant ou d’une quantité de produit Dans le cas d’une commande payée et débitée, la modification du prix unitaire d’un produit (uniquement si le prix est minoré) ou de la quantité...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 7.3.2 Remboursement standard PrestaShop Pour que cette fonctionnalité soit disponible, il faut que les retours produit soient activés dans votre boutique PrestaShop (menu «...
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 7.4 ERREUR DE PAIEMENT Lorsqu’une transaction est en échec, Paybox vous informe dans le Back Office PrestaShop de son statut « Erreur de paiement ». Vous trouverez le détail du code erreur et sa signification dans le Back Office Paybox by Verifone.
Guide d’installation et de configuration du module Paybox by Verifone pour PrestaShop | Version 2.2.2 | 01/12/2015 8. POUR LES DÉVELOPPEURS 8.1 JOURNALISATION DES ERREURS Le module crée un fichier de journalisation par jour permettant de suivre le fonctionnement de celui-ci. Il contient à la fois des éléments d’évènements et des remontées d’erreur. Les fichiers sont situés dans le dossier «...