Plateforme PAYZEN Intégration du module de paiement pour la plateforme Magento version 1.3.x.x Paiement en plusieurs fois Version 1.4a Guide d intégration du module de paiement Multiple Magento 1/24
SUIVI, HISTORIQUE Rédaction, Vérification, Approbation Rédaction Vérification Approbation Nom Date/Visa Nom Date/Visa Nom Date/Visa Lyra-Network 10/10/2011 Lyra-Network 10/10/2011 Lyra-Network 10/10/2011 Historique du document Version Auteur Date Commentaires 1.4a Lyra-Network 10/10/2011 Amélioration de la compatibilité avec Magento 1.3 : Remplacement de l utilisation de la fonction iscanceled par la fonction getstate Suppression de la fonction qui permet de recréer le panier en cas de paiement refusé. Magento 1.3 ne vide pas le panier dans ce cas. Correction apportée pour accepter les «"» dans les champs de saisie (adresse par exemple) Ajout de l enregistrement des informations de la transaction dans la table sale_flat_quote_payment Affichage d un message d erreur dans le cas où les paramètres de configuration des options de paiements sont erronés. 1.4 Lyra-Network 30/06/2011 Modification du comportement lors du clic sur le bouton annuler et retourner à la boutique Deux comportements sont désormais possibles : Commande annulée et panier vidé Commande annulé et panier non vidé Gestion de la devise de manière dynamique Gestion de la langue de manière dynamique Compatibilité du module multi magasins et multi vues 1.3 Lyra-Network 14/06/2011 Modification apportée : si lors de l appel à la page de redirection vers la plateforme le panier est vide alors on renvoi l internaute sur la page checkout/cart. 1.2b Lyra-Network 31/05/2011 Ajout de fonctionnalité : Possibilité de paramétrer plusieurs modes de paiement en plusieurs fois. Par exemple 2 et 3 fois. Correction bug sur la sélection des cartes des paiements dans le ou l on sélectionnait toutes + un autre moyen. 1.1 Lyra-Network 20/04/11 Ajout de fonctionnalité : Possibilité de paramétrer plusieurs modes de paiement en plusieurs fois. Par exemple 2 et 3 fois. 1.0g Lyra-Network 01/02/2011 Contournement d un bug de Magento dans la gestion des erreurs. Dans certains cas, redirige l internaute vers la plateforme de paiement au lieu d afficher le message d erreur (ex lorsque la quantité d un article n est pas disponible. Ceci avait pour effet d envoyer un formulaire de paiement avec un montant à 0. 1.0f Lyra-Network 14/12/2010 Correction de la réponse à l appel de l URL serveur en cas de paiement échoué 1.0e Lyra-Network 08/12/2010 Correction de la gestion multi langue 1.0d Lyra-Network 08/11/2010 Arrondi de la première échéance. 1.0c Lyra-Network 30/09/2010 Mise en place de l option montant minimum et maximum pour Guide d intégration du module de paiement Multiple Magento 2/24
lequel sera proposé le module de paiement 1.0a Lyra-Network 02/09/2010 Correction d une incompatibilité avec PHP 4 liée à l utilisation d une fonction de type «static». Correction d une incompatibilité avec le module de paiement unique (format de l url après redirection). 1.0 Lyra-Network 21/07/2010 Annulation de la commande et retour au panier en cas d échec de paiement. Lors de la redirection vers la page de paiement, le bouton Aller sur la page de paiement est masqué lorsque le navigateur du client gère le JavaScript. Correction de l ordre des champs email et version dans l interface d administration Compatibilité avec le module de paiement unique Confidentialité Toutes les informations contenues dans ce document sont considérées comme confidentielles. L utilisation de celles-ci en dehors du cadre de cette consultation ou la divulgation à des personnes extérieures est soumise à l approbation préalable de Lyra Network. Guide d intégration du module de paiement Multiple Magento 3/24
SOMMAIRE Suivi, historique... 2 1. Objectif... 5 2. A LIRE ABSOLUMENT AVANT D ALLER PLUS LOIN... 5 3. Fonctionnalités... 6 4. Pré-requis... 6 4.1: Vérification de la version du module de paiement unique... 6 4.2: Eléments nécessaire à la mise en œuvre... 7 5. Installation et paramétrage du module de paiement... 8 5.1: Description du package... 8 5.2: Ajout du module de paiement... 8 5.3: Paramétrage du module de paiement... 9 6. Gestion des statuts... 17 7. Option ajout code magasin à l URL... 19 7.1: Ajout code magasin : NON... 19 7.2: Ajout code magasin : OUI... 19 8. Paramétrage de l URL serveur de la boutique... 20 9. Configuration multi magasin... 21 9.1: Paramétrage particulier... 21 9.2: URL serveur... 22 10. Exemple d utilisation du module de paiement... 23 11. Mise à jour de la documentation... 24 12. Support... 24 Guide d intégration du module de paiement Multiple Magento 4/24
1. OBJECTIF Ce tutorial s adresse à tous les commerçants ayant souscrit à l offre PayZen et s appuyant sur la plateforme MAGENTO pour le développement de leur boutique e-commerce. Il décrit pas-à-pas l intégration et le fonctionnement du module pour le paiement en plusieurs fois. Ce module s adresse donc à tous les commerçants qui souhaitent proposer du paiement en plusieurs fois sans frais (Comme par exemple du paiement en 3 fois sans frais). Avertissement : La compatibilité du module PayZen_Magento_multi_1.3.2.2_v1.4a.zip a été validée avec la plateforme MAGENTO version 1.3.X.X. Ce module de paiement n est pas compatible avec les versions supérieures de Magento. 2. A LIRE ABSOLUMENT AVANT D ALLER PLUS LOIN L erreur la plus fréquente concerne l url serveur. Elle se produit parce que vous ne tenez pas suffisamment compte des informations données au chapitre 8. Il est indispensable de comprendre que l URL serveur est le seul mécanisme nous permettant de vous notifier de la fin du paiement. Donc merci de lire le chapitre 8 avec attention et de suivre les indications données. Il est aussi indispensable de comprendre la différence entre l url serveur et l url retour qui n est appelée que si l acheteur clique sur retour boutique. Erreurs fréquentes : 1. Si votre boutique Magento est en maintenance, nous ne pouvons pas exécuter l url serveur. 2. Si vous avez codé un htaccess sur l url serveur, nous ne pouvons pas exécuter l url serveur. 3. Si vous avez bloqué les adresses IP de la plateforme de paiement, nous ne pouvons pas exécuter l url serveur. 4. Si vous n avez pas codé l url serveur dans le back-office PayZen, nous ne pouvons pas exécuter l URL serveur. Comment vérifier que l url serveur est appelée : Il suffit depuis le back-office marchand d afficher le détail d un paiement (double clic) et d aller dans l onglet «Historique». N hésitez à survoler avec votre souris la valeur du champ info de la ligne correspondant à l appel à l URL serveur. Guide d intégration du module de paiement Multiple Magento 5/24
3. FONCTIONNALITES Ce module vous permet de proposer du paiement en plusieurs fois. Dans le paramétrage du module vous pouvez choisir le nombre d échéances et la période en jour entre chaque échéance. Le montant de toutes les échéances est identique. Ce module vous permettra de visualiser dans votre back office MAGENTO une commande avec le montant total ayant été payé avec le module 3 fois sans frais par exemple. Lors du premier paiement, une demande d autorisation (si date de remise en banque est inférieure à date du jour + 6) du montant de la première échéance est réalisée. Vous n avez donc pas la garantie que les échéances suivantes seront honorées. Pensez donc à surveiller que les paiements suivants seront bien autorisés. A compter de l échéance numéro 2, l URL serveur n est plus appelée, car MAGENTO ne gère pas une telle notification d une commande déjà finalisée. Il ne sert à rien de rejouer l URL serveur depuis le back-office. Vous trouverez un exemple d utilisation du module dans ce document au chapitre 10. Fonctionnalité supplémentaire implémentée dans ce module. La plateforme de paiement PayZen permet dans le cas d un paiement multiple de choisir également le montant de la première échéance. Exemple : Pour un montant de 100 euros en 3 fois, vous pouvez fixer le pourcentage du premier paiement à 50% du montant. Cela signifie donc que le montant de la première échéance sera de 50 euros et que les deux autres seront de 25 euros. Mode paiement multiple : Le module permet de paramétrer plusieurs modes de paiement en plusieurs fois. Par exemple vous pouvez définir le paiement en 3 fois et 10 fois. C est le client qui sélectionnera alors le mode paiement 3 ou 10 fois. Affichage du moyen de paiement Dans le paramétrage du module vous pouvez définir un montant minimum à partir duquel vous souhaitez proposer le paiement en plusieurs fois. De même vous pouvez paramétrer un montant maximum à partir duquel vous ne souhaitez pas proposer le paiement en plusieurs fois. Pour résumé vous définir une plage pour lequel vous souhaitez proposer le montant en plusieurs fois et cela pour chaque option de paiement en plusieurs fois 4. PRE-REQUIS 4.1: Vérification de la version du module de paiement unique Si vous proposez déjà du paiement CB sur votre boutique en paiement unique assurez-vous d avoir installé le module de paiement en version 2.13b minimum fournit par PayZen. Cette version est impérative afin que le module de paiement en plusieurs fois fonctionne correctement. Guide d intégration du module de paiement Multiple Magento 6/24
Pour vérifier la version de votre module de paiement connectez-vous sur l interface d administration de votre boutique : Dans l onglet Système, Configuration, allez dans le menu VENTE, puis Modes de paiement: Dans la liste des modules de paiements vous devez visualiser PayZen : Si le module n est pas à jour veuillez effectuer la mise à jour du module. Veuillez trouver le lien suivant vous permettant de télécharger la dernière version : http://www.payzen.eu/contributions.php Pour effectuer la mise à jour veuillez vous référez à la documentation PDF fournie dans le fichier ZIP. 4.2: Eléments nécessaire à la mise en œuvre Pour procéder à l intégration du module paiement, veuillez vous assurer d être en possession des éléments suivants : - Fichier du module de paiement : PayZen_ Magento_multi_1.3.2.2_v1.4a.zip Guide d intégration du module de paiement Multiple Magento 7/24
- Certificat de test ou de production : ces informations sont disponibles sur votre outil de gestion de caisse (Menu : Paramétrage / Boutique / certificats). - L identifiant de votre boutique : Cette information est disponible sur votre outil de gestion de caisse (Menu : Paramétrage / Boutique / configuration rubrique : identifiant de site) 5. INSTALLATION ET PARAMETRAGE DU MODULE DE PAIEMENT 5.1: Description du package - Décompresser le fichier PayZen_ Magento_multi_1.3.2.2_v1.4a.zip. Vous devez visualiser les fichiers ci-dessous : Le répertoire app contenant les fichiers du module de paiement Le fichier Integration_PayZen_ Magento_multi_1.3.2.2_v1.4a.pdf correspond à cette documentation. 5.2: Ajout du module de paiement La première étape consiste à ajouter le module de paiement. Dans l interface d administration de votre boutique sélectionnez «Ajouter un nouveau module». Mise à jour du module 1) Copier le répertoire app puis collez-le dans le répertoire magento de votre site. 2) Vider le cache de magento 3) Effectuer le paramétrage du module comme décrit dans le chapitre 4.3 Guide d intégration du module de paiement Multiple Magento 8/24
Première installation du module 1) Copier le répertoire app puis collez-le dans le répertoire magento de votre site. 5.3: Paramétrage du module de paiement Dans le menu Système/VENTES cliquez sur Modes de paiement Vous visualisez la liste des modes de paiements : Ouvrir le module pour le configurer : Guide d intégration du module de paiement Multiple Magento 9/24
Détails du paramétrage. CONFIGURATION DU MODULE DE PAIEMENT Informations sur le module Paramètres du module Activation Afin d activer la nouvelle méthode de paiement sélectionnez Oui Titre de la méthode de paiement Ordre de tri Activation sélection du pays Valeur par défaut Payzen Paiement multiple. Modifiez la valeur en fonction du nombre d échéances choisi. Par exemple Payzen. Payer en 3 fois sans frais. Si vous souhaitez proposer plusieurs méthodes de paiement en plusieurs fois (ex 3 et 10 fois) vous pouvez valoriser ce champs comme ceci => Ex : CB Payer en 3 ou 10 fois Ce paramètre permet d afficher l ordre des modules de paiement. Par exemple si votre boutique permet le paiement par chèque (ordre de tri 1) et par carte bancaire PayZen (ordre de tri 0) alors dans la liste des choix de paiement, PayZen apparaîtra en premier et chèque en second. Cette option permet de faire afficher ce mode de paiement en fonction du pays appelant votre boutique. Sélectionner ici Tous les pays ou Certains pays. Dans le cas ou vous sélectionnez Certains pays, veuillez renseigner la liste des pays ci après. Si vous avez sélectionné tous les pays alors ce mode de paiement sera disponible pour tous les pays du monde. Sélection des pays Sélectionner les pays depuis lesquels vous souhaitez que ce mode de paiement apparaisse. Ne renseignez ce champ que si vous avez précédemment sélectionné certains pays. Guide d intégration du module de paiement Multiple Magento 10/24
Accès à la plateforme de paiement Identifiant de la boutique Saisir l identifiant du site. Cet identifiant est disponible sur votre back office. Certificat en mode TEST Indiquer le certificat de test disponible votre outil de gestion de caisse (cf. 4). Certificat en mode PRODUCTION Indiquer le certificat de production disponible dans le back office outil de gestion de caisse (cf. 4). Attention : le certificat de production n est disponible qu après avoir reçu le mail de génération du certificat de production. Mode de fonctionnement Indiquer la valeur TEST ou PRODUCTION en fonction du statut de la boutique. URL de la plateforme de paiement Ce champ est pré rempli comme suit : https://secure.payzen.eu/vads-payment/ Page de paiement Langue Ce champ permet d afficher la page de paiement dans la langue choisie. Par défaut la page de paiement apparaîtra en français. Délai avant remise en banque Par défaut ce paramètre est géré dans votre outil de gestion de caisse. (Menu : Paramétrage / Boutique / configuration rubrique : délai de capture) De ce fait, il est conseillé de ne pas renseigner ce paramètre. Types de cartes acceptées Il est conseillé de laisser la valeur TOUTES. Guide d intégration du module de paiement Multiple Magento 11/24
Type de validation Restriction sur le montant Montant minimum Montant maximum Manuelle : Ce paramètre indique que cette transaction devra faire l'objet d'une validation manuelle de la part du commerçant depuis l outil de gestion de caisse. Automatique : Ceci indique que le paiement sera remis en banque de manière automatique sans l intervention du commerçant sur l outil de gestion de caisse. Configuration outil gestion de caisse : Si ce paramètre est «configuration outil gestion de caisse» alors la configuration par défaut du site définie dans l outil de gestion de caisse sera prise en compte. (Menu : Paramétrage / Boutique / configuration rubrique : mode de validation) Il est donc plutôt conseillé de laisser le champ sur «configuration outil gestion de caisse» sauf si vous souhaitez altérer les valeurs par défaut de votre configuration. Attention : Dans le cas du mode manuel, sans validation par le commerçant avant la date d expiration sur l outil de gestion de caisse la transaction ne sera jamais remise en banque. Ce montant défini le montant minimum pour lequel vous souhaitez proposer le paiement avec cette méthode de paiement. Exemple : Vous souhaitez proposer uniquement le paiement par carte bancaire à partir de 150 euros d achat alors veuillez saisir 150. Pour tous les achats inferieurs à 150 euros le paiement par carte bancaire ne sera pas proposé. Attention : si le champ est vide alors le paiement par carte bancaire sera systématiquement proposé sauf si le montant est supérieur au montant maximum (paramètre défini ci-dessous). Ce montant défini le montant maximum pour lequel vous ne souhaitez pas proposer le paiement par carte bancaire. Exemple : Vous ne souhaitez pas proposer le paiement par carte bancaire à partir de 2500 euros d achat alors veuillez saisir 2500. Pour tous les achats supérieurs à 2500 euros le paiement par carte bancaire ne sera pas proposé. Attention : si le champ est vide alors le paiement par carte bancaire sera systématiquement proposé sauf si le montant est inferieur au montant minimum (paramètre défini ci-dessus). En conclusion : si le montant maximum est vide alors le paiement par carte bancaire est toujours proposé quelque soit le montant de l achat. Guide d intégration du module de paiement Multiple Magento 12/24
Paiement en plusieurs fois Libellés des options de paiement multiple Texte décrivant l'option de paiement multiple. Vous pouvez spécifier plusieurs options en les séparant par des points-virgules sans espace. Par exemple : vous souhaitez proposer à vos clients seulement le paiement en 3 fois, écrivez alors dans ce champ par exemple «3x sans frais» Autre Exemple : Montant minimum pour chaque option vous souhaitez proposer 2 modes paiement multiples du 3 fois et du 10 fois sans frais écrivez alors «3X sans frais;10 fois sans frais» Cette option permet de définir le montant minimum pour chaque option de paiement multiple. Pour chaque option de paiement multiple le montant doit être séparé d un point virgule. Exemple 1 Vous avez défini une seule option de paiement en plusieurs fois le paiement 3 fois sans frais et vous souhaitez proposer le paiement 3 fois sans frais à partir de 0 euro. Vous devez alors renseigner 0. Exemple 2 Vous avez défini 2 options de paiement en plusieurs fois le 3 fois sans frais et le 10 fois sans frais. vous souhaitez proposer le paiement 3 fois sans frais à partir de 0 euros et le paiement 10 fois sans frais à partir de 500 euros. Vous devez alors renseigner 0;500 Montant Maximum pour chaque option Cette option permet de définir le montant maximum pour chaque option de paiement multiple. Pour chaque option de paiement multiple le montant doit être séparé d un point virgule. Exemple 1 Vous avez défini une seule option de paiement en plusieurs fois le 3 fois sans frais et vous ne souhaitez pas proposer le 3 fois sans frais au dessus de 500 euros. Vous devez alors renseigner 500. Exemple 2 Vous avez défini 2 options de paiement en plusieurs fois le 3 fois sans frais et le 10 fois sans frais. vous ne souhaitez pas proposer le 3 fois sans frais au dessus de 500 euros et le 10 fois sans frais au dessus 1500 euros. Vous devez alors renseigner 500;1500 Guide d intégration du module de paiement Multiple Magento 13/24
Nombres d échéances Il s agit du nombre d échéances pour un paiement. Par défaut la valeur est 3. Autrement dit pour un montant de 99 euros il aura 3 échéances d un montant de 33 euros. Période REMARQUE: Le montant de chaque échéance est identique si vous laisser le champ premier montant à vide Si vous souhaitez proposer plusieurs méthodes de paiement en plusieurs fois, veuillez séparer chaque méthode par un ; Exemple : Vous souhaitez proposer du 3 et 10 fois sans frais alors il faut paramétrer le champ de la manière suivante : 3;10 Il s agit de la période entre chaque paiement. Cette période est exprimée en jour. La valeur par défaut est 30 jours. Le premier jour est égal à J+ Délai (paramètre suivant) Si vous avez paramétrer plusieurs modes de paiement en plusieurs fois ( 3 et 10fois par exemple ) alors il faut définir la période entre chaque échéance pour chaque mode séparé par un point virgule «;» Exemple 30;30 pour 2 modes de paiement multiples. Premier Paiement Montant de la première échéance, en pourcentage du montant total. Exemple : Pour un montant de 100 euros en 3 fois, vous pouvez fixer le pourcentage du premier paiement à 50% du montant. Cela signifie donc que le montant de la première échéance sera de 50 euros et que les deux autres seront de 25 euros. Pour 50% saisir 50 Si vous avez paramétré plusieurs modes de paiement en plusieurs fois (3 et 10 fois par exemple) alors il faut définir le montant du premier paiement pour chaque mode séparé par un point-virgule «;» Exemple 50;50 Pour 50% pour les 2 modes paiement en plusieurs fois (3 et 10 fois par exemple) Exemple 50;30 Pour 50% pour la première méthode mode de paiement en plusieurs fois (3fois) et 30% pour la deuxième (10 fois). Rappel : si vous souhaitez des montants identiques pour chaque échéance et pour chaque mode paiement multiple paramétrez ce champ de la manière suivante : - Vide si une seul mode de paiement multiple. - un seul point-virgule ; pour deux modes de paiement multiple - 2 points-virgules ;; pour 3 modes de paiement multiple etc Guide d intégration du module de paiement Multiple Magento 14/24
Retour à la boutique Redirection automatique Cette option permet de rediriger de manière automatique votre client vers votre boutique. Cette option dépend du paramétrage qui suit. Cette option est désactivée par défaut. Délai avant redirection (paiement réussi) Message affiché avant redirection (paiement réussi) Dans le cas ou l option redirection automatique est activée vous pouvez définir le délai avant que votre client soit redirigé vers votre boutique dans le cas d un paiement réussi. Délais avant redirection (paiement échoué) Dans le cas ou l option redirection automatique est activée vous pouvez définir le message inscrit sur la plateforme suite à un paiement réussi avant que votre client soit redirigé vers la boutique. Par défaut le message est : «Redirection vers la boutique dans quelques instants» Dans le cas ou l option redirection automatique est activée vous pouvez définir le délai avant que votre client soit redirigé vers votre boutique dans le cas d un paiement échoué. Message affiché avant redirection (paiement échoué) Mode de retour Url de retour à la boutique Dans le cas ou l option redirection automatique est activée vous pouvez définir le message inscrit sur la plateforme suite à un échec de paiement avant que votre client soit redirigé vers la boutique. Par défaut le message est : «Redirection vers la boutique dans quelques instants» Lors du retour à la boutique les paramètres seront renvoyés en mode GET ou POST ou aucun paramètres. Le mode GET est plus confortable pour le client car il évite le pop up du navigateur lui indiquant qu il quitte un environnement https vers un environnement http, ce qui oblige l internaute à cliquer sur accepter pour retourner à la boutique. URL où sera redirigé l internaute dans le cas d une annulation de paiement ou d un paiement refusé. URL serveur URL à copier dans votre outil de gestion de caisse (cf 8) : URL_DE_VOTRE_SITE/index.php/vadsmulti/standard/che ck/ Guide d intégration du module de paiement Multiple Magento 15/24
Statut des commandes enregistrées avec ce mode de paiement Cette option permet de définir le statut d une commande à sa création avant même le paiement. Il est conseillé de renseigner En cours de traitement. Si le paiement est refusé alors le statut restera inchangé. C'est-à-dire En attente de PayZen Si le paiement est accepté alors la commande passera En cours de traitement. La facture sera automatiquement éditée pour les statuts En cours de traitement Afin de valider le paramétrage du module, cliquez sur Le module de paiement est maintenant installé. N oubliez pas de paramétrer l URL serveur dans l outil de gestion de caisse. Cette étape est décrite dans le chapitre 8 et est impérative pour le bon fonctionnement du module de paiement. Guide d intégration du module de paiement Multiple Magento 16/24
6. GESTION DES STATUTS Le statut des commandes après un paiement accepté peut être configuré de deux manières : soit En cours de traitement, qui édite automatiquement la facture. soit En attente, qui vous permet d éditer manuellement la facture. Voici le schéma de principe : Si le paiement est refusé, la commande sera annulée et le client sera redirigé vers son panier. Guide d intégration du module de paiement Multiple Magento 17/24
Sous-statuts : Magento offre la possibilité d ajouter des états intermédiaires, des sous-statuts, à des statuts existants. Cela permet de proposer au client des étapes supplémentaires liées à des règles ou des processus spécifiques à l entreprise. Vous pouvez donc définir par exemple des sous-statuts En cours de préparation ou Prêt pour expédition qui seront rattachés à l état maître En cours de traitement. Mise en œuvre : La définition d un sous-statut se fait en déclarant dans le fichier XML de configuration (/app/etc/config.xml) les éléments suivants : Un libellé. Le statut maître auquel il est rattaché. Pour notre exemple, nous allons créer un sous statut En cours de préparation rattaché au statut maitre En cours de traitement (processing): Il suffit de rajouter le code suivant à l intérieur du fichier config.xml : <config> <global> <sales> <order> <!--Déclarer le nouveau statut --> <statuses> <prepa translate="label"> <label> En cours de Préparation </label> </prepa> </statuses> <!-- Lier les statuts --> <states> <processing> <statuses> < prepa/> </statuses> </processing> </states> </order> </sales> </global> </config> Guide d intégration du module de paiement Multiple Magento 18/24
7. OPTION AJOUT CODE MAGASIN A L URL Dans l onglet système/ configuration cliquer sur l option Web : 7.1: Ajout code magasin : NON Si vous positionnez la valeur Non sur l option «ajouter le code magasin aux URL alors L url de retour dans le paramétrage du module de paiement est définie par défaut : {{unsecure_base_url}}index.php/vads/standard/return 7.2: Ajout code magasin : OUI Si vous positionnez la valeur oui sur l option «ajouter le code de la vue magasin aux URL alors : L url de retour dans le paramétrage du module de paiement doit être alors paramétrée de la manière suivante : {{unsecure_base_url}}index.php/en/vads/standard/return Code de la vue magasin Guide d intégration du module de paiement Multiple Magento 19/24
8. PARAMETRAGE DE L URL SERVEUR DE LA BOUTIQUE Dans le cas où votre client quitte son navigateur après le paiement sans avoir cliqué sur retour à la boutique, il est primordial que votre boutique soit informée du résultat du paiement. Dans l outil de gestion de caisse, vous devez paramétrer une URL qui sera systématiquement appelée après un paiement, et qui par conséquent informera votre boutique du résultat du paiement même si votre client n a pas cliqué sur retour à la boutique. Ce paramètre s appelle dans votre outil de gestion de caisse URL serveur de la boutique et URL serveur de la boutique en mode test. Connectez-vous sur l outil de gestion de caisse puis cliquez sur paramétrage/boutique Url Serveur de la boutique : (mode production et mode test) Pour Magento l Url doit appeler le fichier check : Option ajout code magasin à l URL à non Ex : http://url-de-votre-boutique.com/index.php/vads/standard/check/ Option ajout code magasin à l URL à oui Ex : http://url-de-votre-boutique.com/index.php/en/vads/standard/check/ Code de la vue magasin ATTENTION : SI vous avez plusieurs vue pour un magasin vous pouvez choisir le code vue du magasin que vous souhaitez cela n a aucune importance pour l url serveur. Si vous possédez déjà le module de paiement PayZen pour le paiement unique en version minimum 2.13b, dans les URL serveurs est renseignée l adresse suivante : http://votresite.com/index.php/vads/standard/check/ Cette adresse fonctionne aussi pour les 2 modules : - Paiement unique - Paiement en plusieurs fois. Guide d intégration du module de paiement Multiple Magento 20/24
9. CONFIGURATION MULTI MAGASIN 9.1: Paramétrage particulier Dans le cas d une configuration en multi magasins il est nécessaire de surcharger l url de retour du module de paiement pour le magasin et les magasins ajoutés. Dans la configuration courante sélectionner le magasin ajouté (ex boutique 1): Puis sélectionner méthode de paiement : Assurez-vous d être sur le bon magasin Guide d intégration du module de paiement Multiple Magento 21/24
Vous visualisez la liste des modes de paiements : Ouvrir le module pour le configurer. URL de retour à la boutique 1) Décocher utiliser la valeur par défaut 2) Configurer l url liée) votre magasin. Exemple : Pour le magasin par défaut l url de retour est {{unsecure_base_url}}/index.php/vads/standard/return Pour le magasin supplémentaire associé au répertoire shop_english l url devient: {{unsecure_base_url}}shop_english/index.php/vads/standard/return 3) Sauvegarder la configuration - 9.2: URL serveur Pour l url serveur à renseigner dans l outil de gestion de caisse vous devez utiliser celle du magasin principal. Se reporter au chapitre 8. Guide d intégration du module de paiement Multiple Magento 22/24
10. EXEMPLE D UTILISATION DU MODULE DE PAIEMENT Lorsque le client aura validé sa commande alors celui-ci devra choisir sa méthode de paiement. Veuillez trouver ci-joint un exemple de ce qui sera proposé au client suite à l installation du module de paiement en plusieurs fois. Si l internaute choisit le paiement en 3 fois alors l écran suivant apparaît. Guide d intégration du module de paiement Multiple Magento 23/24
L internaute visualise ici les montants et les dates des échéances. Pour rappel seule l échéance 1 a fait l objet d une autorisation, et d une authentification 3DS si votre commerce est enrôlé. 11. MISE A JOUR DE LA DOCUMENTATION Afin d améliorer constamment la compréhension et la bonne utilisation de cette documentation produit, les remarques constructives d utilisateurs sont des éléments significatifs. Merci d envoyer vos commentaires et suggestions à l adresse suivante : support@payzen.eu en indiquant impérativement la version utilisée de MAGENTO, la version du module de paiement utilisée ainsi que la version de la documentation «Intégration du module de paiement pour la plateforme MAGENTO.» 12. SUPPORT Ce module est distribué par la société Lyra Network, fournisseur de la plateforme de paiement PayZen. Nous vous rappelons que vous pouvez nous joindre au 0811 708 709 (coût d un appel local depuis un fixe) pour tout problème technique. Nous vous accompagnerons dans la mise en service du module et apporterons avec diligence toutes corrections relevant d un bug de fonctionnement du module. Vous pouvez également nous joindre à l adresse suivante : support@payzen.eu Guide d intégration du module de paiement Multiple Magento 24/24