module Prestashop v1B - Citelis€¦ · de paiement « web » (comptant ou en plusieurs fois). Dans ce cas bouton « retour à la boutique » lui permet d’être redirigé vers la

Module pour la solution e-commerce Prestashop

Monext

260, rue Claude Nicolas Ledoux, Pôle d'Activités d'Aix-en-Provence 13593 Aix-en-Provence

Ce document est la propriété exclusive de Monext. Toute reproduction intégrale ou partielle, toute utilisation par des tiers

ou toute communication à des tiers, sans accord préalable écrit de Monext est illicite.

sommaire 1. Introduction ...................................... ...................................................................... 3

1.1. Objet du document ........................................................................................... 3

1.2. Liste des documents de référence .................................................................... 3

1.3. Avertissement ................................................................................................... 3

1.4. Contacts ........................................................................................................... 3

1.5. Historique des révisions .................................................................................... 4

2. Présentation du module Prestashop ................. ................................................... 5

2.1. Structure ........................................................................................................... 5

2.2. Compatibilité du module ................................................................................... 5

2.3. Parcours client .................................................................................................. 5

2.3.1. Sélection de la méthode de paiement ............................................................................. 5 2.3.1.1. Paiement web comptant .................................................................................................... 6

2.3.1.2. Paiement web en plusieurs fois ........................................................................................ 7

2.3.1.3. Paiement direct.................................................................................................................... 8 2.3.1.4. Paiement par portefeuille ................................................................................................... 9

2.3.1.5. Paiement par abonnement .............................................................................................. 10

2.3.2. Redirection vers la page web de paiement Payline .................................................... 11

2.3.3. Retour à la boutique et confirmation de commande ................................................... 11

2.4. Validation simple ..............................................................................................12

2.5. Remboursement simple ...................................................................................12

2.6. Validation et remboursement groupés .............................................................13

3. Intégration du module dans votre boutique ......... ..............................................13

3.1. Pré-requis ........................................................................................................13

3.2. Installation .......................................................................................................13

3.3. Vérification installation .....................................................................................14

3.4. Configuration ...................................................................................................16

3.4.1. Note concernant Prestashop 1.5 .................................................................................... 16

3.4.2. Accès plateforme Payline ................................................................................................ 16

3.4.3. Proxy ................................................................................................................................... 17

3.4.4. Méthode paiement ............................................................................................................ 18 3.4.4.1. Paiement web .................................................................................................................... 19 3.4.4.2. Paiement web en plusieurs fois ...................................................................................... 20

3.4.4.3. Paiement direct.................................................................................................................. 21 3.4.4.4. Paiement par portefeuille ................................................................................................. 22

3.4.5. Paiement par abonnement .............................................................................................. 23

3.4.5.1. Paramétrage Prestashop ................................................................................................. 23

3.4.5.2. Paramétrage Payline ........................................................................................................ 24

Monext




3.4.6. Contrats .............................................................................................................................. 24 3.4.7. Retour boutique ................................................................................................................. 25

1. Introduction

1.1. Objet du document

Ce document décrit la composition et le fonctionnement du module Payline pour Prestashop, qui permet

une mise en œuvre rapide de la solution Payline dans votre boutique Prestashop.

1.2. Liste des documents de référence

Ce document complète le document de présentation fonctionnelle de Payline disponible sur le site Internet

www.payline.com ou sur simple demande auprès du service d’assistance Payline.

1.3. Avertissement

Ce document est la propriété exclusive de Monext. Toute reproduction intégrale ou partielle, toute

utilisation par des tiers, ou toute communication à des tiers, sans accord préalable écrit de Monext, est

illicite.

1.4. Contacts

Vous avez besoin d’aide, de conseil ou vous souhaitez simplement nous poser une question. Contactez

l’Assistance Payline par :

� Email : [email protected]

Si vous découvrez une erreur dans cette documentation, vous pouvez nous envoyez un email 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, sa

date (indiquée sur la première page du document) et le(s) numéro(s) de page(s).

Monext




1.5. Historique des révisions

Le tableau ci-dessous liste les dernières modifications effectuées sur ce document.

date version modifications

20/06/2012 1.0 livraison version initiale

27/08/2012 1.1 Précision sur configuration contrats

12/10/2012 1.2 Procédure en cas d’erreur d’installation

13/11/2012 1.3 Certification Prestashop 1.5

23/01/2013 1A Mise à jour pour version 1.3 du module : ajout du paiement récurrent

28/01/2013 1B Paramétrage CA Payline pour paiement récurrent

Monext




2. Présentation du module Prestashop

2.1. Structure

Le module est mis à disposition sous la forme d’un dossier compressé nommé

PaylineForPrestashop_1.3.zip contenant un unique répertoire : payline .

Ce répertoire contient l’ensemble des éléments permettant l’appel des web services Payline, ainsi que

l’intégration de Payline au sein des parties front-office (paiement) et back-office (configuration) de votre

boutique Prestashop.

2.2. Compatibilité du module

Le module Payline est développé et testé avec l’environnement suivant : � Prestashop 1.4.3 à 1.4.8.2 (le fonctionnement avec l’ensemble des versions 1.4.x est garanti)

� Prestashop 1.5.2 (voir note en 3.4.1)

� systèmes d’exploitation Windows XP Professionnel

� Apache 2.2.3

� PHP 5.3

2.3. Parcours client

2.3.1. Sélection de la méthode de paiement

Une fois le module installé, configuré et activé en suivant les instructions du chapitre 3, Payline, peut être

sélectionnée par les clients de votre boutique lors du processus de commande :

� A l’étape 5 si le processus de commande standard est activé

� Sur la page One Step Checkout si cette fonction est active (version Prestashop 1.4.4 et au delà)

Plusieurs composants visuels peuvent apparaitre en fonction de ce qui a été configuré par le commerçant :

Monext




2.3.1.1. Paiement web comptant

Voir Figure 1

Les moyens de paiement désignés comme « primaires » dans la configuration Payline sont proposés à

l’acheteur dans des composants visuel séparés faisant apparaitre le logo du moyen de paiement, son nom

et le logo Payline attestant la sécurisation du paiement.

Si le compte Payline renseigné dans la configuration est celui d’homologation, un message est également

affiché dans la boutique.

Figure 1

Monext




2.3.1.2. Paiement web en plusieurs fois

Voir Figure 2

Les contrats CB et AMEX renseignés dans la configuration sont proposés à l’acheteur sous la forme d’un

logo inclus dans un composant visuel propre au paiement en plusieurs fois. Ce composant contient

également les titres et sous-titre renseignés dans la configuration du module, ainsi que le logo Payline

attestant la sécurisation du paiement.



Figure 2

Monext




2.3.1.3. Paiement direct

Voir Figure 3


logo inclus dans un composant visuel propre au paiement en direct. Ce composant contient le titre

renseigné dans la configuration du module, le logo Payline attestant la sécurisation du paiement et un

formulaire permettant à l’acheteur de saisir ses données de paiement directement dans la boutique.



Attention : dans le cas du paiement direct, la sécurisation du transfert des données de paiement entre la

boutique et les serveurs Payline doit être assurée par le commerçant.

Figure 3

Monext




2.3.1.4. Paiement par portefeuille

Voir Figure 4

Les cartes CB ou AMEX que le client a sauvegardé dans son portefeuille Payline lui sont proposées dans

un composant visuel propre au paiement par portefeuille. Ce composant contient également le titre

renseigné dans la configuration du module et le logo Payline attestant la sécurisation du paiement.

Figure 4

Monext




2.3.1.5. Paiement par abonnement

Voir Figure 5


logo inclus dans un composant visuel propre au paiement en plusieurs fois. Ce composant contient

également les titres et sous-titre renseignés dans la configuration du paiement par abonnement, ainsi que

le logo Payline attestant la sécurisation du paiement.

Sous les titres et sous titres, un texte détaille les échéances à venir, en fonction de la remise

éventuellement configurée pour cette méthode.



Lors du clic sur un des logos, l’acheteur est redirigé vers la page Payline pour effectuer le paiement

correspondant à la première échéance. Son portefeuille virtuel sera créé à cette occasion, et utilisé dès le

retour à la boutique pour créer le dossier de paiement correspondant aux échéances à venir.

Figure 5

Monext




2.3.2. Redirection vers la page web de paiement Payline

Si le client choisi une méthode Payline de paiement « web » (comptant ou en plusieurs fois) il est redirigé

vers la page web de paiement Payline. Le moyen de paiement correspondant au logo cliqué dans la

boutique lui est proposé.

Il peut procéder à la saisie de ses informations de paiement en toute sécurité.

2.3.3. Retour à la boutique et confirmation de commande

Une fois la saisie de ses informations de paiement validée, le client obtient :

- directement l’écran de confirmation de commande s’il a choisi le paiement pdirect ou par

portefeuille

- l’écran de confirmation de paiement sur la page Payline s’il a choisi une méthode Payline

de paiement « web » (comptant ou en plusieurs fois). Dans ce cas bouton « retour à la

boutique » lui permet d’être redirigé vers la page de confirmation de commande dans la

boutique Prestashop.

Les informations sur le paiement sont automatiquement mise à jour et peuvent être consultées par le

commerçant dans le détail de la commande.

Monext




2.4. Validation simple

Voir Figure 6

Dans le back office Prestashop, dans le détail d’une commande payée avec Payline en mode Autorisation

simple, un composant visuel contenant un bouton Capturer la transaction est affiché.

Au clic sur ce bouton, la totalité du montant correspondant à l’autorisation est validé dans Payline, rendant

ainsi le paiement effectif.

Attention : une autorisation simple peut être validée dans un délai de 7 jours

Figure 6

2.5. Remboursement simple

Le composant ci-dessous apparait dans le détail des commandes payées avec Payline, et dont le

paiement a été validé.

Au clic sur ce bouton, la totalité du montant correspondant à l’autorisation est remboursé dans Payline.

Il est aussi possible de procéder à des remboursements partiels en sélectionnant les produits puis en

cliquant sur le bouton Rembourser les produits .

Monext




2.6. Validation et remboursement groupés

Dans le back office Prestashop, le sous-menu Commandes Payline de l’écran de liste des commandes

redirige vers une vue des commandes payées avec Payline.

Dans cette vue, il est possible de valider ou rembourser plusieurs commande en une seule action :

- Cocher la checkbox en début de ligne pour les commandes à valider ou rembourser

- Cliquer sur le bouton correspondant à l’action souhaitée en bas de la page

3. Intégration du module dans votre boutique

3.1. Pré-requis

Le module Prestashop repose sur le kit Payline PHP, dont le fonctionnement nécessite l’activation des

extensions PHP php_curl , php_http , php_openssl et php_soap .

Vous devez également disposer d’un compte Payline pour configurer votre module.

La solution Payline repose sur l’appel de web services, assurez-vous que l’appel de web services

sécurisés est donc possible avec votre solution d’hébergement (l’ouverture des ports 8080 et 443 en

entrée/sortie est nécessaire).

3.2. Installation

Sous l’onglet Modules de votre back office Prestashop, cliquez sur le lien Ajouter un module depuis mon ordinateur . Dans le champ Fichier du module, sélectionnez le fichier PaylineForPrestashop_1.4.x_v1.2.zip puis cliquez sur Charger le module (voir Figure 7)

Figure 7

Le répertoire payline est automatiquement déposé sous le répertoire modules de votre installation Prestashop, et le module Payline apparait dans la liste des modules de la catégorie Paiement (voir Figure 8)

Monext




Figure 8

Attention : veillez à ce que le répertoire payline (et tout son contenu) déposé sous modules soit accessible

en lecture/exécution pour tous les utilisateurs (masque 755 sous UNIX). Cliquer sur le bouton Installer . Le message Module installé apparait e haut de page et dans le pavé du module Payline.

3.3. Vérification installation

Connectez-vous à votre interface de gestion de la base de donnée et consultez la liste des tables.

Cinq tables relatives à Payline doivent être présentes :

prefix_payline

prefix_payline_card

prefix_payline_lang

prefix_payline_order

prefix_payline_wallet

Note : prefix_ dépend du choix effectué lors de l’installation de Prestashop. Il peut être vide.

Si des tables sont manquantes, exécutez les requêtes correspondantes pour les créer

manuellement (veillez à remplacer PREFIX_ par la valeur correspondant à votre environnement) :

CREATE TABLE `PREFIX_payline` (

ìd_payline` int(10) unsigned NOT NULL auto_increment,

PRIMARY KEY (ìd_payline`)

) ENGINE=MYISAM DEFAULT CHARSET=utf8;

INSERT INTO `PREFIX_payline` (ìd_payline`) VALUES(1);

--

CREATE TABLE `PREFIX_payline_card` (

ìd_card` INT(2) NOT NULL AUTO_INCREMENT PRIMARY KEY ,

`type` VARCHAR(12) NOT NULL ,

`contract` VARCHAR(12) NOT NULL,

`primary` INT(1) NULL,

`secondary` INT(1) NULL

) ENGINE=MYISAM;

INSERT INTO `PREFIX_payline_card` (ìd_card`, `type`) VALUES

(NULL, 'CB'),

(NULL, 'VISA'),

(NULL, 'MASTERCARD'),

(NULL, 'AMEX'),

(NULL, 'SOFINCO'),

Monext




(NULL, 'DINERS'),

(NULL, 'AURORE'),

(NULL, 'PASS'),

(NULL, 'CBPASS'),

(NULL, 'COFINOGA'),

(NULL, 'CDGP'),

(NULL, 'PRINTEMPS'),

(NULL, 'KANGOUROU'),

(NULL, 'SURCOUF'),

(NULL, 'CYRILLUS'),

(NULL, 'FNAC'),

(NULL, 'JCB'),

(NULL, 'MAESTRO'),

(NULL, 'SWITCH'),

(NULL, '1EURO.COM'),

(NULL, 'PAYPAL'),

(NULL, 'PAYSAFECARD'),

(NULL, 'CASINO'),

(NULL, 'SKRILL'),

(NULL, 'MANDARINE'),

(NULL, 'OKSHOPPING'),

(NULL, 'TICKETSURF'),

(NULL, 'ELV'),

(NULL, 'PAYFAIR'),

(NULL, '3XCB'),

(NULL, 'IDEAL'),

(NULL, 'INTERNET+')

;

--

CREATE TABLE `PREFIX_payline_lang` (

ìd_payline` int(10) unsigned NOT NULL,

ìd_lang` int(10) unsigned NOT NULL,

`recurring_title` varchar(255) NOT NULL,

`recurring_subtitle` varchar(255) NOT NULL,

`direct_title` varchar(255) NOT NULL,

`wallet_title` varchar(255) NOT NULL,

PRIMARY KEY (ìd_payline`, ìd_lang`)


--

CREATE TABLE `PREFIX_payline_wallet` (

ìd_customer` INT(11) NOT NULL ,

ìd_wallet` VARCHAR(30) NOT NULL ,

UNIQUE (

ìd_customer`,

ìd_wallet`

)

) ENGINE=MYISAM;

--

CREATE TABLE IF NOT EXISTS `PREFIX_payline_order` (

ìd_order` int(10) unsigned NOT NULL,

Monext




ìd_transaction` varchar(255) NOT NULL,

`contract_number` varchar(255) NOT NULL,

`payment_status` varchar(255) NOT NULL,

`mode` varchar(255) NOT NULL,

àmount` int(10) unsigned NOT NULL,

`currency` int(10) unsigned NOT NULL,

`payment_by` varchar(255) NOT NULL,

PRIMARY KEY (ìd_order`)


--

CREATE TABLE IF NOT EXISTS `PREFIX_payline_wallet` (

ìd_customer` INT(11) NOT NULL ,

ìd_wallet` VARCHAR(30) NOT NULL ,

UNIQUE (

ìd_customer`,

ìd_wallet`

)

) ENGINE=MYISAM;

3.4. Configuration

Cliquer sur le lien Configurer du pavé Payline dans la liste des modules. L’écran de configuration est

affiché. Les paramètres sont répartis dans 5 onglets.

3.4.1. Note concernant Prestashop 1.5

Sous Prestashop 1.5 la mise en page de l’écran de configuration du module est détériorée : l’ensemble des

paramètres sont présentés sur une page unique, et non séparés en 5 onglets comme sous Prestashop

1.4.x.

Ce défaut de mise en page sera corrigé dans une prochaine version du module, et n’affecte en rien son

bon fonctionnement.

3.4.2. Accès plateforme Payline

Voir Figure 9

Renseignez dans cet onglet votre identifiant commerçant, votre clé d’accès pour l’appel des web services

Payline et votre numéro de contrat principal (votre contrat CB/VISA/MASTERCARD).

Si les identifiants renseignés correspondent à votre compte d’homologation, sélectionnez la valeur Non

pour le champ Mode production .

Monext




La valorisation à Oui du paramètre Mode debug permet de visualiser la trame de réponse des web

services Payline. Pour une utilisation normale du module, laissez ce paramètre à Non .

3.4.3. Proxy

Voir Figure 10

Si les connexions depuis vers votre serveur vers le réseau Internet passent par un proxy, renseignez ses

informations dans cet onglet. Sinon, laissez tous les champs vides.

Figure 9

Figure 10

Monext




3.4.4. Méthode paiement

Voir Figure 11

Les 4 méthodes de paiement offertes par le module Payline doivent être activées et configurées dans cet

onglet.

Le détail du paramétrage de chaque méthode de paiement s’affiche lorsque le champ Activé est valorisé à

Oui (voir paragraphes suivants)

Le paramètre Langue en haut de page ne concerne que les méthodes de paiement web. Elle détermine la

langue dans laquelle la page web de paiement est affichée à l’acheteur. La valeur par défaut, - Basé sur le

navigateur client - , permet d’afficher la page web de paiement dans la même langue que celle

couramment utilisée par le client pour sa navigation Internet.

Figure 11

Monext




3.4.4.1. Paiement web

Voir Figure 12

Le paramètre Action détermine si une le paiement réalisé par l’acheteur correspondra à une simple

empreinte bancaire (Autorisation ) ou à un débit immédiat (Autorisation + Capture ).

Dans le premier cas, pour être effectif le paiement devra être validé. La validation peut être effectuée via le

centre d’administration Payline, ou depuis le détail de la commande dans votre back office Prestashop :

- soit via le bouton Capturer la transaction (voir Figure 6)

- soit lors du passage de la commande au statut renseigné dans le champ Validation (si

aucun statut ne doit déclencher la validation, sélectionner Manual capture )

Les paramètres de mise en forme de votre page web de paiement (personnalisation statique ou par

template dynamique) se renseignent au niveau des deux champs suivants.

Enfin, en sélectionnant Oui pour le champ Paiement par portefeuille , le portefeuille virtuel du client (s’il

en possède un) lui sera proposé sur la page web de paiement.

Figure 12

Monext




3.4.4.2. Paiement web en plusieurs fois

Voir Figure 13

Les champs Titre et Sous-titre correspondent à ce qui est affiché au client dans le composant visuel

Payline du paiement en plusieurs fois (voir Figure 2).

De même que pour le paiement web simple, il est possible de spécifier la mise en forme de vos pages web

de paiement via les paramètres URL du template dynamique et Identifiant de personnalisation de

pages web du commerçant .

Le nombre et la périodicité des échéances de paiement sont définis en sélectionnant les valeurs

souhaitées dans les champs Nombre de paiements et Périodicité des paiements .

Le client pourra sélectionner son portefeuille sur les pages web si le paramètre Paiement par portefeuille

vaut Oui .

Figure 13

Monext




3.4.4.3. Paiement direct

Attention : dans le cas du paiement direct, la sécurisation du transfert des données de paiement entre la

boutique et les serveurs Payline doit être assurée par le commerçant.

Voir Figure 14

Le champ Titre correspond à ce qui est affiché au client dans le composant visuel du paiement direct, à

droite du logo Payline (voir Figure 3).

Les paramètres Action et Validation fonctionnent de la même façon que pour le paiement web.

Figure 14

Monext




3.4.4.4. Paiement par portefeuille

Voir Figure 15

Le champ Titre correspond à ce qui est affiché au client dans le composant visuel du paiement par

portefeuille, à droite du logo Payline (voir Figure 4)

Les paramètres Action et Validation fonctionnent de la même façon que pour le paiement web.

En valorisant le paramètre Mettre à jour vos données personnelles à Oui , vous offrez à vos clients la

possibilité de modifier les coordonnées transmises à Payline lors de la création ou modification d’un

portefeuille. Par défaut, les coordonnées renseignées par le client dans sont compte sont envoyées.

En valorisant le paramètre Mettre à jour les données de paiement à Oui , vous leur offrez la possibilité de

modifier leur numéro de carte.

La pop up de création/mise à jour d’un portefeuille peut être mise en page via le paramètre Identifiant de

personnalisation de pages web du commerçant .

Figure 15

Monext




3.4.5. Paiement par abonnement

3.4.5.1. Paramétrage Prestashop

Le paramètre début de l’échéancier détermine la date de la seconde échéance (la première étant

immédiatement réalisée). Jour de prélèvement permet de choisir le jour où auront lieu les échéances (si

la périodicité mensuelle est choisie).

Il est possible d’offre une réduction sur les premières échéances. Leur nombre est déterminé par Nombre

de paiement remisé . La réduction peut être un montant fixe ou un pourcentage du montant (en fonction

du paramètre Type de réduction ), sa valeur est à renseigner dans le champ Pourcentage ou montant

fixe de la réduction .

L’acheteur aura la possibilié de sauter une échéance autant de fois que vous l’aurez déterminé via le

paramètre Nombre de fois où le client peut suspendre son abon nement .

Monext




3.4.5.2. Paramétrage Payline

Pour que les échéances de paiement récurrent soient notifiées à votre boutique par Payline, il est

nécessaire de configurer votre point de vente en conséquence.

� Connectez-vous au centre d’administration Payline

� Dans l’écran Configuration > Vos points de vente , cliquez sur le bouton Rechercher

� Dans les résultats, cliquez sur le point de vente utilisé pour le paiement récurrent dans votre boutique

� Dans le pavé Gestion des notifications

- Cochez la case Notification des paiements d'échéances

- Copiez l’URL de retour à la boutique définie dans l’onglet Retour boutique de la

configuration du module Prestashop dans le champ URL notification , en remplaçant

validation.php par validation_subscribe.php .

3.4.6. Contrats

Cet onglet possède un champ par moyen de paiement pouvant être proposé via Payline. Renseignez vos

numéros de contrats dans les champs appropriés, puis pour chaque champ sélectionnez

• La case Primaire si vous souhaitez que le moyen de paiement soit proposé à votre client dès

l’étape de validation de commande

• La case Secondaire si vous souhaitez qu’il soit proposé comme alternative suite à un refus avec

le premier moyen de paiement.

Note : dans le cas des moyens de paiement CB, VISA et MASTERCARD, un même numéro de contrat

compatible avec toutes les cartes peut être renseigné :

Monext




3.4.7. Retour boutique

Cet onglet permet de définir la cible des boutons Retourner à la boutique et Annuler le paiement

affichés sur les pages web Payline, ainsi que l’URL de notification, appelée par Payline si le client ne

revient pas à la boutique après son paiement.

A moins que vous ne souhaitiez effectuer une intégration personnalisée de Payline dans votre boutique

Prestashop, ne modifiez pas les valeurs par défaut des 3 champs de cet onglet.

module Prestashop v1B - Citelis€¦ · de paiement « web » (comptant ou en plusieurs fois). Dans ce cas bouton « retour à la boutique » lui permet d’être redirigé vers la

Documents