Guide d installation & configuration du module PAYBOX pour Woocommerce Verifone France 11 A, Rue Jacques Cartier, 78 280 Guyancourt, FRANCE
HISTORIQUE DES MODIFICATIONS DATE VERSION DESCRIPTION AUTEUR 18/04/2011 1.00 Version initiale après refonte. Document dédié Paybox System Service Projets 27/05/2011 1.01 Version DRAFT Service Projets 10/06/2011 1.02 Version après prise en compte des remarques de la réunion du 10/06/2011 Service Projets 29/10/2014 1.03 BMS services - finalisation Christophe Paris 27/10/2015 2.00 Nouvelle charte J. CINTAS REFERENCES DOCUMENTATIONS La plupart des documentations référencées ci-dessous sont téléchargeables sur le site Web Paybox www.paybox.com : REF. DOCUMENT DESCRIPTION Ref 1 ManuelIntegrationPayboxDirect_V6.2_FR.pdf Manuel d intégration de la solution Paybox Direct / Direct+ Ref 2 ParametresTestPaybox_V6.1_FR.pdf Manuel décrivant les environnements et paramètres de test (pré-production). Ref 3 GUIDE_UTILISATEUR_BACK_OFFICE_COMME RCANT_PAYBOX.doc Manuel Utilisateur du Back-Office Commerçant LEGENDE Les conventions suivantes s appliquent dans la suite de ce document : Une zone d information : son contenu permet de mieux comprendre ce document. Une zone d avertissement : le contenu de cette zone doit être lu attentivement. Guide d installation & configuration du module PAYBOX pour WooCommerce 2
AVERTISSEMENT Ce document est la propriété exclusive de Paybox by Verifone. Toute reproduction intégrale ou partielle, toute utilisation par des tiers, ou toute communication à des tiers est interdite sans accord préalable de Paybox by Verifone. Si vous découvrez une erreur dans cette documentation, vous pouvez nous envoyer un email aux adresses mail ci-dessous en décrivant l erreur ou le problème aussi précisément que possible. Merci de préciser la référence du document, et le numéro de page. INFORMATION & ASSISTANCE Pour tout renseignement ou assistance à l installation et à l utilisation de nos produits, nos équipes restent à disposition des commerçants et intégrateurs : Service commercial lun-ven 9h-18h contact-paybox@verifone.com +33 (0)1 61 37 05 70 Support Client et Technique lun-ven 9h-18h support-paybox@verifone.com +33 (0)4 68 85 79 90 Pour tout contact auprès de notre Support Client et Technique, il faut impérativement se munir de ses identifiants Paybox : numéro de SITE (7 chiffres) numéro de RANG (2 chiffres) numéro d identifiant Paybox (1 à 9 chiffres) Guide d installation & configuration du module PAYBOX pour WooCommerce 3
SOMMAIRE 1. PRESENTATION... 5 2. INTEGRATION DU MODULE... 6 2.1 PREREQUIS... 6 2.2 INSTALLATION DU MODULE... 6 2.2.1 Depuis l interface d administration WordPress... 6 2.2.2 Depuis un compte FTP (File Transfert Protocol)... 7 2.3 ACTIVATION DU MODULE... 7 3. PARAMETRAGE DU MODULE... 8 3.1 OPTIONS GENERALES... 9 3.1.1 Activer/Désactiver... 9 3.1.2 Titre... 9 3.1.3 Description... 9 3.1.4 Environnement... 10 3.1.5 Numéro de site... 10 3.1.6 Rang... 10 3.1.7 Identifiant... 11 3.1.8 HMAC... 11 3.1.9 Débit... 12 3.1.10 Montant minimum... 12 3.2 3-D SECURE... 12 3.2.1 Actif/Inactif... 12 3.2.2 Montant minimum... 13 4. GENERATION DE LA CLE HMAC... 14 4.1 GENERATION... 14 4.2 VALIDATION... 16 4.3 EXPIRATION... 17 4.4 TRANSMISSION... 17 5. INFORMATIONS DE PAIEMENT... 18 Guide d installation & configuration du module PAYBOX pour WooCommerce 4
1. PRÉSENTATION Cette documentation est destinée aux e-commerçants souhaitant intégrer le module Paybox à leur site WordPress WooCommerce. La compatibilité du module a été validée avec la plateforme WooCommerce version 2.0. Grâce à ce module, vous pourrez en une seule intégration proposer de nombreux moyens de paiement, disposer d une page de paiement sécurisée personnalisée, multi-langues et multidevises et proposer du 3 fois sans frais à vos clients. Paybox vous propose : La liberté de choix de votre banque pour créditer vos ventes, en France et dans de nombreux pays européens De nombreux moyens de paiement, sans module complémentaire à installer : Visa, Mastercard, American Express, Paypal, Leetchi, Bancontact/Mistercash, Maestro, Cofinoga, etc. Des outils anti-fraude à la carte : 3-D Secure sélectif selon montant, et aussi des filtres sur nationalités de la carte ou de l IP ; La possibilité de prise de paiement par téléphone (via Back-Office Paybox) ; La fonctionnalité de paiement en 3 fois sans frais selon montant de commande pour vos clients ; Un accès Back Office Paybox avec des fonctions de reporting : suivi transactions temps réel et export de journaux d encaissement. Le module Paybox pour WordPress WooCommerce repose sur le pack Essentiel : Module Paybox pour WooCommerce Pack Essentiel (Paybox System) 100 transactions offertes chaque mois Page de paiement Web Page de paiement Mobile Acceptation contrat VAD CB, Visa, Mastercard toute banque et changement de banque gratuit Personnalisation poussée page de paiement (charte graphique, langues, devises) Back-Office Paybox Module anti-fraude : 3-D Secure, filtres sur nationalités cartes et IP Paiement en 3 fois sans frais Pack cartes & méthodes privatives (American Express, Leetchi, Bancontact Mistercash ) Option Option Guide d installation & configuration du module PAYBOX pour WooCommerce 5
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 WordPress incluant le module WooCommerce et hébergé sur un serveur disposant de l extension PHP php_openssl. L archive contenant le module à télécharger depuis le site officiel Paybox http://www1.paybox.com/espace-integrateur-documentation/modules-de-paiement/ Les identifiants Paybox : ces identifiants sont fournis par mail lors de la souscription à un contrat Paybox. Par défaut, le module utilise un compte de test général pour vous permettre de réaliser vos premiers tests gratuitement et sans engagement, avant toute souscription. 2.2 INSTALLATION DU MODULE L outil WooCommerce vous permet d installer votre module de 2 façons différentes : Depuis l interface d administration du site ; Depuis un accès FTP (File Transfert Protocol). 2.2.1 Depuis l interface d administration WordPress Vérifiez au préalable auprès de votre hébergeur que votre répertoire «/wp-content/plugins/» dispose des bons droits pour le chargement de fichiers. Cliquez sur «Extensions» (1), «Ajouter» (2) puis «Envoyer» (3). Sélectionnez votre fichier (4) et enfin cliquez sur «Installer maintenant» (5). Guide d installation & configuration du module PAYBOX pour WooCommerce 6
2.2.2 Depuis un compte FTP (File Transfert Protocol) Décompressez l archive «woocommerce-paybox.zip» dans le répertoire «wpcontent/plugins/» de votre site. 2.3 ACTIVATION DU MODULE Une fois les fichiers installés sur votre serveur, connectez-vous à la zone d administration de WordPress et cliquez sur l onglet «Extensions» (1). Dans la page qui s ouvre, allez dans la section «Extensions installées» (2). Recherchez dans la liste le module «WooCommerce Paybox Payment Plugin» (3) et cliquez sur le bouton «Activer» (4) situé juste en dessous du nom. Si le module est bien installé, vous verrez un message vert «Extension activée». Guide d installation & configuration du module PAYBOX pour WooCommerce 7
3. PARAMÉTRAGE DU MODULE Une fois votre module installé, cliquez sur le lien «WooCommerce» (1), puis sur la section «Paramètres» (2) et enfin sur l onglet «Commandes» (3). Descendre en bas de page afin de voir la liste des moyens de paiement installés dans WooCommerce. Choisir entre la version classique et le règlement en trois fois. Dans la liste des moyens de paiement apparaît alors : «Paybox payment» : le paiement standard ; «Paybox 3 times payment» : le paiement en 3 fois. Assurez-vous d avoir souscrit à l option «Paiement en 3 fois» avant de paramétrer cette option. Cliquer sur le bouton «Paramètres» d un moyen de paiement pour en éditer les options. Vous pouvez ainsi renseigner les identifiants associés à votre compte Paybox. Ces identifiants vous sont transmis par email par Paybox le jour de l ouverture de votre compte. Guide d installation & configuration du module PAYBOX pour WooCommerce 8
Par défaut, le module met à disposition des identifiants de tests qui vous permettent d explorer ses fonctionnalités. Il est impératif de personnaliser ces identifiants avant tout passage en production. La suite de ce chapitre présente chaque option disponible. Les options disponibles pour chaque moyen de paiement étant similaires, cette section présente toutes les options possibles. Toutefois certaines sont spécifiques à certains moyens de paiement. Cette limitation est indiquée le cas échéant. 3.1 OPTIONS GÉNÉRALES Les options suivantes agissent sur la manière dont vont apparaître le(s) moyen(s) de paiement sur la page de validation de la commande. 3.1.1 Activer/Désactiver Cocher cette option pour activer le moyen de paiement sur la page de validation de la commande. 3.1.2 Titre Saisir le titre du moyen de paiement visible sur la page de validation de la commande. 3.1.3 Description Saisir la description du moyen de paiement visible sur la page de validation de la commande. Guide d installation & configuration du module PAYBOX pour WooCommerce 9
3.1.4 Environnement Choisir l environnement: «Test» : les paiements sont simulés. Aucun encaissement n est réalisé. «Production» : les paiements sont effectués. L environnement de test permet de vérifier le fonctionnement de la boutique sans réellement effectuer un paiement. L environnement doit être passé à «production» lorsque le site marchand est mis en ligne. La clé HMAC étant lié à l environnement, il convient de modifier celle-ci lorsque vous changez d environnement (cf.error! Reference source not found.). A l installation ce champ est paramétré par défaut à «test» pour correspondre aux réglages du compte de test. 3.1.5 Numéro de site Saisir le numéro de site constitué de 7 chiffres et fourni par Paybox. Vous pouvez retrouver ce numéro dans le Back Office de Paybox, onglet «Informations». A l installation, ce champ est pré-rempli avec le numéro de site d un compte de test pour vous permettre d essayer le module. 3.1.6 Rang Guide d installation & configuration du module PAYBOX pour WooCommerce 10
Saisir le numéro de rang constitué de 2 chiffres et fourni par Paybox. Vous pouvez retrouver ce numéro dans le Back Office de Paybox, onglet «Informations». Si votre numéro de rang est sur 3 chiffres (exemple : «077»), vous devez retirer le «0» initial («77»). A l installation, ce champ est pré-rempli avec le numéro de rang d un compte de test pour vous permettre d essayer le module. 3.1.7 Identifiant Saisir l identifiant constitué de 9 chiffres et fourni par Paybox. Vous pouvez retrouver cet identifiant dans le Back Office de Paybox, onglet «Informations». A l installation, ce champ est pré-rempli avec l identifiant d un compte de test pour vous permettre d essayer le module. 3.1.8 HMAC Saisir la clé HMAC que vous avez préalablement généré dans le Back Office Paybox. A l installation, ce champ est pré-rempli avec la clé HMAC d un compte de test pour vous permettre de tester le module. Pour générer votre clé HMAC, rendez-vous au chapitre 4, page 14. La clé HMAC est liée à l environnement : test ou production (cf. Error! Reference source not found.). Il convient donc de modifier celle-ci lorsque vous changez d environnement. Guide d installation & configuration du module PAYBOX pour WooCommerce 11
3.1.9 Débit Ce champ n est pas disponible sur le moyen de paiement en 3 fois. Choisir le nombre de jour d attente avant la mise en banque du paiement. Vous pouvez choisir de paramétrer un débit de vos clients à la commande (immédiat) ou différé (J+1 à J+7). 3.1.10 Montant minimum Ce champ est disponible uniquement sur le moyen de paiement en 3 fois. Saisir le montant minimum de la commande pour activer le moyen de paiement. Cette zone accepte un nombre qui peut inclure des centimes (le séparateur de décimal est alors le point). L unité est celui de la boutique et ne doit pas être précisé dans le champ. Le moyen de paiement est activé si le montant total du panier (produits, frais de livraison, etc.) est supérieur ou égal au montant renseigné. Si ce champ est laissé vide, le moyen de paiement est activé pour toutes les transactions. 3.2 3-D SECURE 3-D Secure est un protocole anti-fraude mis en place par Visa et MasterCard. Il protège les commerçants de la répudiation de transactions, en permettant l authentification du porteur de la carte au moment de son achat en ligne. Vérifiez la position de votre banque sur l application de ce protocole afin d être en cohérence entre le paramétrage de votre contrat VAD et le paramétrage de votre solution Paybox. 3.2.1 Actif/Inactif Guide d installation & configuration du module PAYBOX pour WooCommerce 12
Choisir si 3-D Secure est : «Inactif» : 3-D Secure n est pas actif ; «Actif» : 3-D Secure est actif pour toutes les transactions (par défaut) ; «Sélectif» : 3-D Secure est actif uniquement pour les transactions dont le montant est supérieur ou égal au champ suivant. 3.2.2 Montant minimum Saisir le montant minimum de la commande pour activer 3-D Secure. Cette zone accepte un nombre qui peut inclure des centimes (le séparateur de décimal est alors le point). L unité est celui de la boutique et ne doit pas être précisé dans le champ. 3-D Secure est activé si le montant total du panier (produits, frais de livraison, etc.) est supérieur ou égal au montant renseigné. Si ce champ est laissé vide, 3-D Secure est activé pour toutes les transactions. Guide d installation & configuration du module PAYBOX pour WooCommerce 13
4. GÉNÉRATION DE LA CLÉ HMAC Cette clé est indispensable, elle permet d authentifier tous les messages échangés entre le site marchand et les serveurs Paybox. Le commerçant doit générer sa propre clé confidentielle. Cette clé valide l identité du commerçant et sécurise les échanges avec Paybox. Elle ne doit en aucun cas être diffusée. 4.1 GÉNÉRATION La clé HMAC est différente suivant l environnement choisit pour le module. Pour générer une clé HMAC, il faut se rendre dans le Back Office Paybox : De «test» si le module est en mode «test» : https://preprod-admin.paybox.com/; De «production» si le module est en mode «production» : https://admin.paybox.com/. Si une erreur se produit lorsque le client est redirigé vers la plateforme de paiement Paybox, vérifiez que la clé HMAC renseigné correspond bien à celle de l environnement actif. L interface de génération de la clé HMAC se trouve dans l onglet «Informations», en bas de la page. Guide d installation & configuration du module PAYBOX pour WooCommerce 14
Le champ «Phrase de passe» peut être renseigné avec une phrase, un mot de passe ou tout autre texte. Le contenu de ce champ est, par défaut, caché. Il est possible de choisir d en afficher le contenu en décochant la case «Cacher». Les champs «Complexité» et «Force» sont mis à jour automatiquement lorsque la «phrase de passe» est saisie. Ces champs permettent de définir des règles d acceptation minimales de la «phrase de passe». Les règles fixées actuellement demandent une phrase de passe d au moins 15 caractères de long et d une force de 90%. Le bouton «VALIDER» restera grisé tant que ces limitations ne sont pas respectées. La force de la «phrase de passe» est calculée selon plusieurs critères spécifiques : le nombre de majuscules, minuscules, caractères spéciaux, etc. Il conviendra donc de varier les caractères saisis, de les alterner et d éviter les répétitions qui tendent à diminuer le score final. Le bouton «Générer une clé» permet de calculer la clé HMAC à partir de la «phrase de passe» saisie. Ce calcul est une méthode standard assurant le caractère aléatoire de la clé et renforçant sa robustesse. Cette méthode de calcul étant fixe, il est possible à tout moment de retrouver sa clé en retapant la même phrase de passe et en relançant le calcul. Il est possible que le calcul de la clé prenne quelques secondes, selon le navigateur Internet utilisé et la puissance de l ordinateur. Au cours du calcul, il se peut que le navigateur Internet Explorer demande s il faut "arrêter l exécution de ce script". Il faut répondre "Non" à cette alerte et patienter jusqu à la fin du calcul. Une fois le calcul terminé, la clé sera affichée dans le champ «Clé». Il faut alors copier/coller la clé HMAC dans le champ «HMAC» de la configuration du module sur le site marchand (cf.error! Reference source not found.). 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é à saisir correspond à une génération de clé en SHA-1, soit 40 caractères hexadécimaux. Cependant, si cette méthode de saisie d une clé d authentification «externe» est utilisée, une alerte s affichera pour rappeler que Paybox ne peut pas en garantir la robustesse. Guide d installation & configuration du module PAYBOX pour WooCommerce 15
Le bouton «VALIDER» est grisé par défaut. Les 2 actions qui peuvent activer le bouton sont : Saisir une «phrase de passe» de plus de 15 caractères et dont la force est de plus de 90% Saisir une clé hexadécimale de plus de 40 caractères. Si après avoir saisi une «phrase de passe» répondant aux critères minimaux, le bouton «VALIDER» est cliqué (sans avoir au préalable cliqué sur «Générer une clé»), alors le calcul de la clé HMAC se lancera automatiquement. Après validation du formulaire, un message récapitulatif est affiché sur la page, expliquant qu un email de demande de confirmation a été envoyé à l adresse mail du commerçant. La clé qui vient d être générée n est active qu une fois la procédure décrite dans l email respectée. La clé est affichée sur ce récapitulatif. Pour des raisons de sécurité, cette clé ne sera plus transmise ni demandée par nos services. Par conséquent, si cette clé est égarée, il sera nécessaire d en générer une nouvelle. Il est important de veiller à copier la clé d authentification affichée avant de quitter la page. La clé est dépendante de la plateforme sur laquelle elle est générée. Cela signifie qu il faut générer une clé pour l environnement de test et une pour l environnement de production. 4.2 VALIDATION Une fois l enregistrement de la nouvelle clé effectué, un email de demande de confirmation est envoyé au commerçant. Dans cet email se trouvera un lien pointant sur le programme "CBDValid.cgi", par exemple : https://admin.paybox.com/cgi/cbdvalid.cgi?id=5475c869bb64b33f35d0a37df466568475 BC9601 Guide d installation & configuration du module PAYBOX pour WooCommerce 16
Le paramètre «id» n est pas la clé saisie. Il s agit d un «token» généré aléatoirement qui correspond à la clé à valider. Comme dit précédemment, la clé ne sera pas transmise dans l email. Après avoir cliqué sur ce lien, si un message annonce «Votre clé est activée», alors la clé est immédiatement en fonction. Ce qui signifie que la clé qui vient d être validée devrait aussi être en fonction sur le site Marchand. 4.3 EXPIRATION Lorsque la clé est validée, celle-ci se voit affectée une date d expiration. Cette date correspond à la date d activation plus 31 jours. Quand cette date est atteinte, la clé n est pas directement désactivée, pour permettre au site Marchand de continuer à fonctionner, mais le commerçant sera averti par email, et sur la page d accueil du Back Office Paybox, que cette clé est expirée. Il est fortement recommandé de générer une nouvelle clé HMAC dans ce cas-là. 4.4 TRANSMISSION La clé HMAC ne doit en aucun cas être transmise par e-mail. Paybox ne la demandera jamais au commerçant. Les commerçants doivent donc être particulièrement vigilants quant aux demandes suspectes de transmission de la clé d authentification, il s agit probablement d une tentative de phishing ou social engineering. En cas de perte de la clé secrète, nous ne serons donc pas en mesure de la redonner. Il faudra en générer une nouvelle via le Back Office Paybox. Guide d installation & configuration du module PAYBOX pour WooCommerce 17
5. INFORMATIONS DE PAIEMENT Lorsqu un paiement est réalisé, plusieurs informations sont stockées avec la commande. Elles permettent d avoir plus de détails sur la transaction pour, par exemple : Détecter une fraude ; Retrouver la transaction dans le Back Office Paybox ; Déboguer un problème avec le module. Ces informations apparaissent dans le Back Office, sur la page de la commande. Suivant le paramétrage du module, la zone affiche : Référence du Back Office : la référence de la commande associée au paiement. Cette information vous permet de rapidement retrouver la commande dans le Back Office Paybox. Moyen de paiement : le type de carte utilisé par le client. Pays de l IP : le pays dans lequel se trouve le client au moment du paiement. Date de traitement : la date du paiement. Premier débit : la date et le montant du premier débit (pour le paiement en 3 fois). Deuxième débit : la date et le montant du deuxième débit (pour le paiement en 3 fois). Troisième débit : la date et le montant du troisième débit (pour le paiement en 3 fois). Pays de la carte : le pays du porteur de carte. Numéros de la carte : une partie des numéros de carte. Date de validité : la date de validation de la carte Guide d installation & configuration du module PAYBOX pour WooCommerce 18