[PDF] Guide dinstallation & configuration Module Sofinco pour PrestaShop

View - Download Guide dinstallation & configuration Module Sofinco pour PrestaShop

Previous PDF

Next PDF

Sofinco pour PrestaShop | Version 1.1 | 12/11/2019

Module Sofinco pour PrestaShop

Compatible V 1.6 / 1.7

Verifone France

12 A, Rue Paul Dautier, 78 280 Guyancourt, FRANCE

Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 2

HISTORIQUE DES MODIFICATIONS

DATE VERSION DESCRIPTION AUTEUR

19/07/2019 1 Création du document Service projet

12/11/2019 1.1 Ajout des bornes minimum et maximum Service projet

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 ManuelIntegrationPayboxSystem_V8.1_FR.pdf

System

Ref 4 GUIDE_UTILISATEUR_BACK_OFFICE_COMME

RCANT_PAYBOX.doc

Manuel Utilisateur du Back-Office

Commerçant

LEGENDE

: son contenu permet de mieux comprendre ce document. : le contenu de cette zone doit être lu attentivement.

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. Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 3 Si vous découvrez une erreur dans cette documentation, vous pouvez nous envoyer un email aux adresses mail ci- que possible. Merci de préciser la référence du document, et le numéro de page.

INFORMATION & ASSISTANCE

Pour tout renseignement nos

équipes restent à disposition des commerçants et intégrateurs :

Service commercial

lun-ven 9h-18h contact-paybox@verifone.com

Support Client et Technique

lun-ven 9h-18h support-paybox@verifone.com

Support Module

lun-ven 9h-18h prestashop-paybox@verifone.com +33 (0)4 67 66 53 80
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 (3 chiffres) tifiant Paybox (1 à 9 chiffres) Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 4

SOMMAIRE

1. PRESENTATION .................................................................... 5

2. INTEGRATION DU MODULE ................................................. 6

2.1 PREREQUIS ................................................................................................... 6

2.2 INSTALLATION DU MODULE ....................................................................... 6

2.2.1 Depuis le Back Office PrestaShop ........................................................................................ 6

2.2.2 Depuis un accès FTP (File Transfert Protocol) ..................................................................... 8

2.3 ACTIVATION DU MODULE ............................................................................ 9

PARAMETRAGE DU MODULE ............................................................ 11

2.4 PARAMETRES ............................................................................................. 12

2.4.1 Numéro de site .................................................................................................................... 13

2.4.2 Rang .................................................................................................................................... 13

2.4.3 Identifiant ............................................................................................................................. 13

2.4.4 HMAC .................................................................................................................................. 14

2.5 CONFIGURATION ........................................................................................ 15

2.5.1 Environnement .................................................................................................................... 16

2.5.2 Statut après paiement ......................................................................................................... 16

2.5.3 Montants Minimum et maximum.......................................................................................... 16

2.5.4 Méthode de paiement .......................................................................................................... 17

3. PARAMETRAGE DE PRESTASHOP ................................... 18

3.1 GESTION DES DEVISES ............................................................................. 18

3.2 GESTION DES GROUPES DE CLIENT ....................................................... 19

3.3 GESTION DES PAYS ................................................................................... 20

3.4 TRADUCTION ET PERSONNALISATION ................................................... 21

4. INFORMATIONS DE PAIEMENT .......................................... 22

4.1 INFORMATIONS AFFICHEES ..................................................................... 23

4.2 ERREUR DE PAIEMENT.............................................................................. 24

5. ON HMAC .................................... 25

6. POUR LES DEVELOPPEURS .............................................. 28

6.1 JOURNALISATION DES ERREURS ........................................................... 28

Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 5

1. PRÉSENTATION

Cette documentation est destinée aux e-commerçants souhaitant intégrer le module Sofinco

à leur site PrestaShop. La compatibilité du module a été validée sur les versions 1.4 à 1.7 de

PrestaShop.

Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 6

2. INTÉGRATION DU MODULE

2.1 PRÉREQUIS

Un site PrestaShop hébergé sur un serveur disposant des extensions PHP " php_curl » et " php_openssl » r depuis le site officiel Paybox Les identifiants Paybox : ces identifiants sont fournis par e-mail lors de la souscription à un contrat Paybox

Par défaut, le module utilise un compte de test général pour permettre de réaliser les

premiers tests gratuitement et sans engagement, avant toute souscription.

2.2 INSTALLATION DU MODULE

PrestaShop staller votre module de 2 façons différentes :

Depuis le Back Office PrestaShop ;

Depuis un accès FTP (File Transfert Protocol).

2.2.1 Depuis le Back Office PrestaShop

Vérifiez au préalable auprès de votre hébergeur que votre répertoire " /modules/ » dispose des bons droits pour le chargement de fichiers. Dans le Back Office PrestaShop, naviguez dans le menu " Modules > Modules » ou " Modules et Services > Modules et Services ». Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 7

Sous prestashop 1.7 :

Ajouter un nouveau module »

Et sous prestashop 1.7 :

Le formulair :

Cliquez sur le bouton " Choisissez un fichier » du module sur votre disque dur. Enfin, cliquez sur le bouton " Charger le module »

Pour prestashop 1.7 :

Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 8

Suivez les instructions.

2.2.2 Depuis un accès FTP (File Transfert Protocol)

sur votre disque dur et déposez le dossier du module dans le répertoire " /modules/ » de votre site. Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 9

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 > Modules et Services » pour accéder à la liste des modules.

Cherchez le module " sofinco » dans la liste ou saisissez " sofinco » dans la zone de

recherche pour le faire apparaître. Cliquez alors sur le bouton " Installer » à droite de

Sous prestashop 1.7 le module apparaît en bas de la liste des modules : Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 10 Si l module est effectuée correctement, vous verrez un message vert " Module(s) installé(s) avec succès ». Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 11

PARAMETRAGE 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 Sofinco est découpée en 3 parties : Paramètres, Configuration et Moyens de paiement. fonctionnalités. Il est impératif de personnaliser ces identifiants avant tout passage en production.

Il est également impératif

" Enregistrer les paramètres » pour que les modifications soient prises en compte. Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 12

2.4 PARAMÈTRES

La section " Paramètres » permet de renseigner les identifiants associés à votre compte Sofinco. Ces identifiants vous sont transmis par e-mail par Sofinco votre compte.

Par défaut, le module met à disposition des identifiants de test qui vous permettent

. Il est impératif de personnaliser ces identifiants avant tout passage en production. Sur une plateforme multi-boutique, ces identifiants peuvent être différents sur chaque boutique. Pour cela, renseignez-les pour chaque contexte de boutique. Les paramètres à renseigner sont les suivants :

Numéro de site

Numéro de rang

Identifiant

Clé HMAC

Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 13

2.4.1 Numéro de site

Saisir le numéro de site constitué de 7 chiffres fourni par Sofinco. Vous pouvez retrouver ce numéro dans le Back Office Verifone, onglet " Informations ». lation, ce champ est pré-rempli avec le numéro de si compte de test.

2.4.2 Rang

Saisir le numéro de rang constitué de 2 chiffres fourni par Sofinco. Vous pouvez retrouver ce numéro dans le Back Office de Sofinco, onglet " Informations ». Si votre numéro de rang est sur 3 chiffres (exemple : " 002 »), vous devez retirer le premier " 0 » et ne conserver que "

02 ».

-rempli avec le num compte de test.

2.4.3 Identifiant

fiant constitué de 9 chiffres fourni par Paybox. Vous pouvez retrouver cet identifiant dans le Back Office de Paybox, onglet " Informations ». compte de test. (Vue du Back Office Paybox / Onglet informations) Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 14

2.4.4 HMAC

Saisir la clé HMAC que vous avez préalablement générée dans le Back Office Verifone. compte de test. Pour générer votre clé HMAC, rendez-vous au chapitre 5. ironnement : test ou production. Il convient donc de modifier celle-ci lorsque vous changez Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 15

2.5 CONFIGURATION

Les paramètres à renseigner sont les suivants :

Environnement (test / production)

Statut après paiement

Montant minimum

Montant maximum

Méthode de paiement (3X ou 3X sans frais)

Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 16

2.5.1 Environnement

Test : les paiements sont simulés, a

Production : les paiements sont réels

et de valider la création de commandes sans effectuer de paiements réels.

Production » lorsque le site est

mis en ligne et accessible aux visiteurs. La clé HMAC étant liée -ci lorsque vous changez p est paramétré par défaut à " Test » pour correspondre aux réglages du compte de test.

2.5.2 Statut après paiement

Choisir le statut appliqué à la commande PrestaShop une fois le paiement accepté par

Paybox. La valeur p

2.5.3 Montants Minimum et maximum

Définissez les seuils entre lesquels vous souhaitez proposer le moyen de paiement : à partir du montant minimum, et jusquau montant maximum. Les limites sont également définies dans votre contrat monétique, mais vous pouvez ici simplifier le parcours client en ne proposant le paiement quentre les bornes, et personnaliser celles-ci. La valeur est exprimée en devise sans les centimes, les valeurs par défaut sont 150 pour le montant minimum et 2000 pour le montant maximum Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 17

2.5.4 Méthode de paiement

Choissez la méthode de paiement que vous souhaitez proposer à vos clients : avec ou sans frais. Une seule méthode de paiement peut être activée, selon votre type de contrat auprès de sofinco. Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 18

3. PARAMÉTRAGE DE PRESTASHOP

3.1 GESTION DES DEVISES

Si vous proposez plusieurs devises à vos clients, il faut associer le module à chaque devise " Restriction des devises » accessible via le menu " Modules > Paiement » ou " Modules et

Services > Paiement ».

Pour que le module soit proposé pour une devise donnée, assurez-vous que la case au croisement de la ligne de la devise et de la colonne du module soit cochée.

Une fois votre configuration effectuée, cliquez sur le bouton " Enregistrer les restrictions ».

Assurez-vous que la devise est paramétrée sur votre contrat VAD auprès de votre banque avant de la proposer le paiement dans cette devise à vos clients. Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 19

3.2 GESTION DES GROUPES DE CLIENT

Si vous êtes amenés à gérer des groupes spécifiques de clients, le module Paybox peut être

activé ou désactivé pour certains groupes. " Restriction des groupes » accessible via le menu " Modules > Paiement » ou " Modules et

Services > Paiement ».

Pour que le module soit proposé pour un groupe donné, assurez-vous que la case au croisement de la ligne du groupe et de la colonne du module soit cochée.

Une fois votre configuration effectuée, cliquez sur le bouton " Enregistrer les restrictions ».

Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 20

3.3 GESTION DES PAYS

Le module Paybox peut être activé ou désactivé pour des pays spécifiques. La configuration

Restriction des pays » accessible via le menu " Modules > Paiement » ou " Modules et Services > Paiement ». Pour que le module soit proposé pour un pays donné, assurez-vous que la case au croisement de la ligne du pays et de la colonne du module soit cochée.

Une fois votre configuration effectuée, cliquez sur le bouton " Enregistrer les restrictions ».

Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 21

3.4 TRADUCTION ET PERSONNALISATION

Sofinco fournit le module pour PrestaShop en langue française uniquement. Vous pouvez modifier ou ajouter les traductions, y compris modifier le libellé des méthodes de paiement en utilisant la fonctionnalité de traduction de PrestaShop. Depuis la page de configuration du module, utilisez le bouton " traductions » en haut de

page pour accéder à cette fonctionnalité. Vous trouverez toutes les expressions utilisées

dans le module traduites ou à traduire. Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 22

4. INFORMATIONS DE PAIEMENT

en utilisant le module Paybox, plusieurs informations sont comme par exemple : Des indicateurs anti-fraude : Statut 3-D Secure, nationalité IP Identifier une transaction et la retrouver dans le Back Office Paybox Analyser un éventuel problème avec le module Pour visualiser vos commandes, ouvrir le menu " Commandes > Commandes » dans le

Back Office PrestaShop :

Dans la liste des commandes qui apparaît, choisissez une commande payée via Sofinco (libellé " Sofinco » dans la colonne " Paiement ») : Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 23

Sur la page de détail de commande, un bloc intitulé " Détails du paiement » et précédé du

logo Paybox est présente les informations de paiement ainsi que des actions possibles en fonction de la configuration des paiements du module.

4.1 INFORMATIONS AFFICHÉES

Suivant le paramétrage du module, la zone affiche : Référence Paybox : numéro de transaction Sofinco Paybox. Cette information vous permet de rapidement retrouver la commande dans le Back Office Paybox Méthode de paiement : type de moyen de paiement utilisé par le client Pays de la carte : pays du porteur de la carte de paiement utilisée Pays IP : pays dans lequel sest trouvé le client au moment du paiement

Garantie 3-D Secure : précise si le 3-D Secure a été utilisé pour le paiement (Oui / Non)

Date de traitement : date

Premier / deuxième / troisième débit : date et montant du débit (pour le paiement en 3 fois) Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 24

4.2 ERREUR DE PAIEMENT

Office PrestaShop

de son statut " Erreur de paiement ». Vous trouverez le détail du code erreur et sa

signification dans le Back Office Paybox.

A partir du Back

site PrestaShop, vous pouvez revenir vers votre client et lui proposer un encaissement par téléphone (onglet Saisie Manuelle du Back

Office Paybox).

Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 25

5. ON HMAC

site Marchand et les serveurs Verifone. Vous devez donc générer votre propre clé unique et confidentielle et l

Génération de la clé HMAC

Le champ " Phrase de passe » peut être renseigné avec une phrase, un mot de passe, ou tout autre texte. La " Qualité de la phrase » est mise à jour automatiquement lorsque la phrase de passe est de passe. rer la clé» restera grisé tant que ces limitations ne sont pas respectées.

La force de la phrase de passe est calculée selon certains critères spécifiques, à savoir le

nombre de majuscules, minuscules, caractères spéciaux, etc. Il conviendra donc de varier final. 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. Attention, il est possible que le calcul de la clé prenne quelques secondes, selon le navigateur Internet utilisé et la puissance de répondre " Non Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 26

Une fois le calcul terminé, la clé sera affichée dans le champ " Clé ». Il est alors possible de

Marchand, ou autre mode de stockage, de préférence sécurisé. Par défaut, le bouton " Générer la clé » est grisé. Pour le rendre actif : Saisir une phrase de passe de plus de 15 caractères et dont la force est de plus de 90% Pour optimiser la sécurité de la clé HMAC, - même une clé.

Après validation du formulaire, un message récapitulatif sera affiché sur la page, expliquant

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

La clé est dépendante de la plateforme sur laquelle elle est générée. (environnement de pré- production.

Validation & Activation de la clé

trement de la nouvelle clé effectué, un email de demande de confirmation vous sera envoyé. Dans cet email se trouvera un lien pointant sur le programme "

CBDValid.cgi », par exemple :

BC9601

correspond à la clé à valider. Comme dit précédemment, la clé ne sera pas transmise dans

Après avoir cliqué sur ce lien, si un message annonce " Votre clé est activée », alors la clé est immédiatement en fonction. Cela signifie sur le site Marchand pour permettre les échanges avec les serveurs

Verifone

Expiration

Sofinco pour PrestaShop | Version 1.1 | 12/11/2019 du module PAYBOX pour PrestaShop 27

Lorsque la clé est validée, celle-

Quand cette date sera atteinte, la clé ne sera pas directement désactivée, pour permettre au

site Marchand de continuer à fonctionner, mais vous serez averti par email et sur la page -office que cette clé est expirée. Il est fortement recommandé de -là.

Transmission

par e-mail. Verifone ne vous la demandera jamais. Vous devez donc être particulièrement vigilants quant aux demandes suspectes de tentative de phishing ou social engineering. En cas de perte de la clé secrète, Verifone ne sera pas en mesure de vous la redonner, il faudra donc en générer une nouvelle. Sofinco pour PrestaShop | Version 1.1 | 12/11/2019quotesdbs_dbs31.pdfusesText_37

[PDF] Un pôle social au côté des pôles de compétitivité

[PDF] COMMISSION RETRAITE PROJET DE RAPPORT CONFERENCE NATIONALE LIMOGES

[PDF] Guide Pratique. pour les Elèves. DANSEURS Horaires Aménagés

[PDF] besoin D AIDE POUR accompagnement information outils formation intervention coordination

[PDF] Essentiels de la retraite 19 juin 2014 PLENIERE

[PDF] LA REPRISE DE SEPULTURES ET DE CONCESSIONS FUNERAIRES DANS LES CIMETIERES

[PDF] 1 Programmation Client/Serveur basée sur TCP/IP

[PDF] Rapport De Stage 28 mai au 27 juin 2013. Intégration Web Création de site vitrine (SGC)

[PDF] BAC Pro - Vente (prospection, négociation, suivi de clientèle)

[PDF] Enfants primo-arrivants LIVRET PERSONNEL DE COMPETENCES

[PDF] CONDITIONS PARTICULIÈRES DES SERVEURS DÉDIÉS

[PDF] Constats. Formation DTN D.T.N.

[PDF] Nic handle : CONDITIONS GENERALES DE VENTE SERVEUR DEDIE

[PDF] Marché à bons de commande Achat de mobilier de bureau

[PDF] TABLE DES MATIERES. Chapitre I : Dispositions générales