Module pour la solution e-commerce Magento
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... 3 2. Présentation du module Magento... 5 2.1. Magento Connect... 5 2.2. Compatibilité du module... 5 3. Intégration du module dans votre boutique... 5 3.1. Pré-requis... 5 3.2. Installation... 5 3.3. Post installation... 6 3.4. Configuration... 7 3.4.1. Paramètres généraux... 7 3.4.2. Moyens de paiement... 8 3.4.2.1. Moyens de paiement primaires... 8 3.4.2.2. Moyens de paiement secondaires... 9 3.4.3. Paiement web comptant... 9 3.4.4. Paiement web en plusieurs fois... 10 3.4.5. Paiement direct... 10 3.4.6. Paiement par portefeuille... 11 4. Fonctions... 12 4.1. Paiement web comptant... 12 4.2. Paiement web en plusieurs fois... 13 4.3. Paiement direct... 13 4.4. Paiement par portefeuille... 14 4.4.1. Paiement «One Click»... 14 4.4.2. Gestion du portefeuille... 15
1. Introduction 1.1. Objet du document Ce document décrit la composition et le fonctionnement du module Payline pour Magento, qui permet une mise en œuvre rapide de la solution Payline dans votre boutique Magento. 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. Toute reproduction intégrale ou partielle, toute utilisation par des tiers, ou toute communication à des tiers, sans accord préalable écrit de, 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 : support@payline.com 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). 1.5. Historique des révisions Le tableau ci-dessous liste les dernières modifications effectuées sur ce document.
date version modifications 19/04/2010 1.0 livraison version initiale 17/06/2010 1.1 Kit paramétrable directement via l IHM Magento 26/07/2012 1.2 Ajout de la fonctionnalité de remboursement 05/08/2010 1.3 Paiement en plusieurs fois, gestion du stock, validation 30/08/2010 1.4 Paiement direct 25/11/2010 1.5 Corrections suite audit 13/12/2010 1.5.1 Modification de la structure des dossiers 01/01/2011 1.6 Mise à jour pour la version 1.6 du module (comprenant le paiement en un clic) 25/11/2012 1.A Mise à jour pour la version 1.7.4 du module comprenant : - frais pour le paiement en plusieurs fois - paramétrage sécurisé des numéros de contrats de vente - gestion des arrondis - montée de version kit php payline 1.2.2 - choix du moyen de paiement dans la boutique - messages d'erreur affichés dans le BO lors du refus d'un paiement - options de retour à la boutique - prise en compte des alertes du module antifraude Payline
2. Présentation du module Magento 2.1. Magento Connect Le module Payline pour Magento est publié sur Magento Connect, la plateforme de téléchargement des extensions Magento : http://www.magentocommerce.com/magento-connect/ Le téléchargement du module Payline est gratuit, seul un compte utilisateur pour Magento Connect est nécessaire. 2.2. Compatibilité du module La compatibilité du module est assurée dans les configurations suivantes : Magento Community Edition 1.3, 1.4, 1.4.1.1, 1.4.2, 1.5, 1.6, 1.6.1, 1.6.2 Magento Enterprise 1.8, 1.9 systèmes d exploitation Windows XP Pro, Windows 7 Pro Apache 2.2.3 PHP 5.3 3. Intégration du module dans votre boutique 3.1. Pré-requis Le module Payline pour Magento 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 Identifiez-vous sur Magento Connect et rendez-vous sur la page Payline : http://www.magentocommerce.com/magento-connect/payline.html Récupérez l extension key du module Payline.
Connectez-vous ensuite au back office de votre boutique. Allez dans System > Magento Connect > Magento Connect Manager. Après vous être une nouvelle fois identifié, vous obtenez cet écran : Dans le champ Paste extension key to install, saisissez l extension key de Payline récupérée précédemment puis cliquez sur le bouton Install. L écran est rafraichi comme suit : Cliquez sur le bouton Proceed pour terminer l installation. Vérifiez l absence d erreur dans la console en bas de la page. 3.3. Post installation Allez dans System > Cache Management. 1) Cliquez sur le lien Select All
2) Dans la liste Actions, sélectionnez Refresh 3) Cliquez sur le bouton Submit Allez ensuite dans System > Configuration > ADVANCED > Advanced. _Payline doit apparaitre dans la liste Disable Modules Output. La valeur associée doit être Enable. 3.4. Configuration Notez que la configuration du module Payline peut être déclinée selon les différents périmètres de votre instance Magento : Default, Website, Store, Store view. 3.4.1. Paramètres généraux Allez dans System > Configuration > Payment Methods. Cinq pavés de configuration relatifs à Payline sont affichés. Déroulez le premier, Payline Common settings. Il contient les paramètres suivants : Merchant ID : l identifiant de votre compte commerçant. Access Key : la clé d accès associé à votre compte commerçant. Production : indicateur qui permet de basculer facilement de l environnement d homologation à celui de production. Merchant ID et Access Key doivent être saisis en cohérence avec ce champ. Language : langue dans laquelle la page web Payline est affichée. La valeur Based on browser permet de s adapter dynamiquement à l environnement de l acheteur. Proxy host : l URL du proxy reliant le serveur de la boutique à Internet. Proxy port : le port de communication du proxy. Proxy login : l identifiant utilisateur requis par le proxy. Proxy password : le mot de passe utilisateur requis par le proxy. Initial order status : statut initial attribué à la commande, lors de la redirection vers la page de paiement Payline. Order status when payment accepted by Payline : statut attribué à la commande après un paiement réalisé avec succès. Order status when payment canceled by customer : statut attribué à la commande lorsque le client annule son paiement (clic sur le lien «j annule mon paiement» sur la page Payline).
Order status when payment refused by Payline : statut attribué à la commande après un refus de paiement. Order status when payment abandoned by Customer : statut attribué à la commande lorsque le paiement est abandonné (fermeture de la page Payline sans action, ou session expirée). Automate wallet subscription : critère permettant d activer la création automatique de portefeuille virtuel lors du premier paiement réalisé par le client. Return options : page vers laquelle le client est redirigé après un refus de paiement. 3.4.2. Moyens de paiement Allez dans System > Manage Payline Contracts. Cliquez sur le bouton Import contracts. L ensemble des points de vente actifs de votre compte Payline et leurs contrats actifs associés sont importés dans Magento. Note : Cette action nécessite la bonne configuration du pavé Payline Common settings décrit cidessus. Les contrats affichés dans la grille correspondent à ceux du point de vente sélectionné dans la liste Point Of Sell. Pour changer de point de vente, sélectionner une valeur dans la liste Point Of Sell puis cliquer sur le bouton Search. 3.4.2.1. Moyens de paiement primaires Ce sont les moyens de paiement proposés à vos clients pour effectuer leur première tentative de paiement. Pour les définir : 1) Cochez les lignes correspondantes via la colonne de gauche 2) Dans la liste Actions, sélectionnez Change status 3) Dans la liste Status, sélectionnez Primary
4) Cliquez sur Submit La colonne Primary est alors mise à jour et vaut Yes pour les contrats choisis. Note : Il est obligatoire de définir au moins un moyen de paiement primaire. 3.4.2.2. Moyens de paiement secondaires Dans le cas d un paiement web, si la première tentative est refusée, les moyens de paiement secondaires sont proposés à l acheteur pour effectuer une nouvelle tentative. Pour définir les moyens de paiement secondaires, procédez comme pour les primaires en sélectionnant Secondary à l étape 3. 3.4.3. Paiement web comptant Allez dans System > Configuration > Payment Methods. Le paiement web comptant se configure via le second pavé Payline : Payline Cash web payment. Il contient les paramètres suivants : Enabled : témoin d activation du paiement web comptant. Sélectionner Yes pour que la méthode puisse être sélectionnée par vos clients lors du processus de commande (étape 4). Une fois la méthode sélectionnée, les logos des moyens de paiement primaires sont affichés. Title : le titre de la méthode Payline, vu par le client lors du choix de la méthode de paiement. Template URL : L'url d'une page HTML permettant de personnaliser l'affichage des pages de paiement Payline. Se référer au document «Guide de personnalisation avancée» disponible sur demande auprès du support Payline. Custom Payment page code : Le code de personnalisation des pages de paiement, créé depuis le centre d administration Payline. Le bouton Add Exception permet de rajouter une correspondance entre une valeur présente dans l en-tête HTTP_USER_AGENT de l acheteur, et un code de personnalisation. Cela permet par exemple de configurer une personnalisation distincte pour les navigateurs classiques et les Smartphones. Redirection message : texte affiché à l acheteur lors du choix du paiement web comptant, sous les logos des moyens de paiement primaires.
Payment action : type de transaction effectuée lors du paiement d une commande : authorization : autorisation de paiement qui devra être validée pour que le paiement soit effectif. La validation est faite via la création de facture dans Magento, ou directement dans le centre d administration Payline. authorization + capture : le paiement est effectif sans action complémentaire. Send wallet id : Sélectionnez Yes pour que le portefeuille virtuel de l acheteur, s il en possède un, lui soit proposé sur la page de paiement Payline. Automate invoice creation : L évènement sélectionné dans cette liste déclenchera la création de facture (et par conséquent la validation des paiements effectués en mode authorization) 3.4.4. Paiement web en plusieurs fois Allez dans System > Configuration > Payment Methods. Le paiement web en plusieurs fois se configure via le troisième pavé Payline : Payline Nx web payment. Il contient les paramètres suivants : Enabled : témoin d activation du paiement web en plusieurs fois. Sélectionner Yes pour que la méthode puisse être sélectionnée par vos clients lors du processus de commande (étape 4). Title : le titre de la méthode Payline, vu par le client lors du choix de la méthode de paiement Costs : type de frais (fixe ou pourcentage) à ajouter à la commande lorsque le client choisi le paiement en plusieurs fois. Costs amount/percentage : montant des frais. Ce montant sera ajouté au panier sous le libellé Payline fees. Template URL : L'url d'une page HTML permettant de personnaliser l'affichage des pages de paiement. Custom Payment page code : Même fonctionnement que pour le paiement comptant. Redirection message : texte affiché à l acheteur lors du choix du paiement web en plusieurs fois, sous le logo Payline. Billing occurences : nombre d échéances de paiement Billing cycle : périodicité des échéances de paiement Send wallet id : Sélectionnez Yes pour que le portefeuille virtuel de l acheteur, s il en possède un, lui soit proposé sur la page de paiement Payline. Automate invoice creation : L évènement sélectionné dans cette liste déclenchera la création de facture. 3.4.5. Paiement direct Note : L activation du paiement direct suppose la certification PCI DSS du commerçant, les données de paiement lui étant directement transmises. Allez dans System > Configuration > Payment Methods. Le paiement direct se configure via le quatrième pavé Payline : Payline direct payment. Il contient les paramètres suivants :
Enabled : témoin d activation du paiement direct. Sélectionner Yes pour que la méthode puisse être sélectionnée par vos clients lors du processus de commande (étape 4). Title : le titre de la méthode Payline, vu par le client lors du choix de la méthode de paiement Payment action : type de transaction effectuée lors du paiement d une commande : authorization : autorisation de paiement qui devra être validée pour que le paiement soit effectif. La validation est faite via la création de facture dans Magento, ou directement dans le centre d administration Payline. authorization + capture : le paiement est effectif sans action complémentaire. Automate invoice creation : L évènement sélectionné dans cette liste déclenchera la création de facture (et par conséquent la validation des paiements effectués en mode authorization) 3.4.6. Paiement par portefeuille Allez dans System > Configuration > Payment Methods. Le paiement par portefeuille se configure via le dernier pavé Payline : Payline wallet payment. Il contient les paramètres suivants : Enabled : témoin d activation du paiement par portefeuille. Sélectionner Yes pour que la méthode puisse être sélectionnée par vos clients lors du processus de commande (étape 4). Title : le titre de la méthode Payline, vu par le client lors du choix de la méthode de paiement Template URL : L'url d'une page HTML permettant de personnaliser l'affichage des pages de création et mise à jour de portefeuille. Custom Payment page code : Le code de personnalisation des pages de création et mise à jour de portefeuille, créé depuis le centre d administration Payline. registration CMS block id in customer account : identifiant du bloc CMS statique affiché au-dessus de l iframe de création de wallet dans le compte client. registration CMS block id in catalog : identifiant du bloc CMS statique intégré au pavé Payline de commande en 1 clic affiché sur la page d accueil de la boutique. Payment action : type de transaction effectuée lors du paiement d une commande : authorization : autorisation de paiement qui devra être validée pour que le paiement soit effectif. La validation est faite via la création de facture dans Magento, ou directement dans le centre d administration Payline. authorization + capture : le paiement est effectif sans action complémentaire. Allow user to update his personal details : Sélectionner Yes pour que, lors de la création ou mise à jour de son wallet, le client puisse lui associer d autres coordonnées que celles de son compte Magento. Allow user to update his payment details : Sélectionner Yes pour que, lors de la mise à jour de son wallet, le client puisse lui associer d autres données de paiement. Enable One Clic function : Sélectionner Yes pour que le bouton de commande en un clic soit affiché à vos clients au niveau du panier. One Clic bloc title : titre du pavé Payline de commande en 1 clic affiché sur la page d accueil de la boutique. Default shipping method : méthode de livraison sélectionnée lors d une commande en 1 clic. Automate invoice creation : L évènement sélectionné dans cette liste déclenchera la création de facture (et par conséquent la validation des paiements effectués en mode authorization).
4. Fonctions 4.1. Paiement web comptant La méthode de paiement web comptant est proposée à l étape 4 du processus de commande. Sélectionnée par le client, elle se présente de la façon suivante : Champ Title de la configuration du paiement web comptant Moyens de paiement définis comme primary dans l écran Manage Payline Contracts Champ Redirection message de la configuration du paiement web comptant Le client doit sélectionner un des moyens de paiement proposés avant de cliquer sur Continue pour poursuivre le processus de commande. En fin de commande, il est redirigé vers la page web sécurisée Payline pour saisir ses données de paiement. Une fois ces données validées : le retour à la boutique met immédiatement le statut de la commande à jour, et enregistre les informations sur la transaction. si la page web de paiement est fermée, la mise à jour dans Magento sera automatiquement effectuée par le traitement de notification Payline.
4.2. Paiement web en plusieurs fois La méthode de paiement web comptant est proposée à l étape 4 du processus de commande. Sélectionnée par le client, elle se présente de la façon suivante : Champ Title de la configuration du paiement web en plusieurs fois Champ Redirection message de la configuration du paiement web en plusieurs fois Le client est redirigé vers la page de paiement en fin de commande, comme pour un paiement comptant. Les contrats de type CB (VISA/MESTERCARD) et AMEX configurés par le commerçant lui sont proposés. Après validation du numéro de carte sur la page web de paiement, l échéancier est affiché. 4.3. Paiement direct La méthode de paiement direct est proposée à l étape 4 du processus de commande. Sélectionnée par le client, elle se présente de la façon suivante : Champ Title de la configuration du paiement direct Moyens de paiement CB/VISA/MASTERCARD ou AMEX définis comme primary dans l écran Manage Payline Contracts
Attention : via cette méthode les données de paiement sont directement saisies dans la boutique (d où son nom). 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. Une fois ses données les données de paiements saisies, elles sont rappelées dans la rubrique YOUR CHECKOUT PROGRESS (sous les adresses et la méthode de livraison) et le processus de commande se poursuit. Le paiement est effectif lorsque le client valide la dernière étape du processus. 4.4. Paiement par portefeuille La méthode de paiement par portefeuille est proposée à l étape 4 du processus de commande. Sélectionnée par le client, elle se présente de la façon suivante : Champ Title de la configuration du paiement direct Données correspondant à la carte enregistrée dans le portefeuille. Une fois le portefeuille sélectionné, ses données sont rappelées dans la rubrique YOUR CHECKOUT PROGRESS (sous les adresses et la méthode de livraison) et le processus de commande se poursuit. Le paiement est effectif lorsque le client valide la dernière étape du processus. 4.4.1. Paiement «One Click» Le paiement «One Click» s appuie sur le paiement par portefeuille décrit ci-dessus. Si la fonction est activée au niveau de la configuration deu paiement par portefeuille, le bouton suivant est affiché au niveau du panier : En cliquant sur ce bouton, l acheteur est directement redirigé vers la dernière étape du processus de commande. Les éléments suivants ont été automatique sélectionnés et sont rappelés dans la rubrique YOUR CHECKOUT PROGRESS : Adresse de facturation par défaut de l acheteur Adresse de livraison par défaut de l acheteur Méthode de livraison sélectionnée dans la configuration du paiement par portefeuille Carte enregistrée dans le portefeuille de l acheteur. L acheteur n a plus qu à valider sa commande.
4.4.2. Gestion du portefeuille L acheteur peut gérer son portefeuille via le menu Wallet management de la rubrique My Account. Si l acheteur n a pas encore de wallet, l écran affiché permet sa création : Cet affichage est le résultat d une intégration en iframe de la page Payline de création de wallet. La saisie se fait donc sur une interface entièrement sécurisée. La page est mise en forme en cohérence avec le paramètre Custom Payment page code renseigné dans la configuration du paiement par portefeuille. Elle est surmontée du bloc CMS renseigné dans le paramètre registration CMS block id in customer account. Les Moyens de paiement proposés pour la création du wallet sont ceux de type CB/VISA/MASTERCARD ou AMEX définis comme primary dans l écran Manage Payline Contracts. Une fois le portefeuille créé, le menu Wallet management présente l écran suivant ci-après. Le bouton Disable wallet permet à l acheteur de supprimer son portefeuille. Le bouton Update payment information permet de le mettre à jour (changement de coordonnées ou de données de paiement).