Plateforme PAYZEN Intégration du module de paiement pour la plateforme Magento 1.4 et supérieur. Version 1.5.1 Guide d intégration du module de paiement Magento 1/52
Notes de versions Version Date Commentaires 1.5.1 02/03/2015 1.5 18/02/2015 1.4.1 20/10/2014 1.4 16/06/2013 Corrections de bug : Prise en compte du statut UNDER_VERIFICATION pour les transactions PayPal. Nouvelles fonctionnalités : Ajout du moyen de paiement SOFORT banking Possibilité de restreindre les différents moyens de paiement en fonction des groupes de clients Corrections de bug : En cas de commande en échec, le nouveau panier était enregistré en double en base données. En mode multi magasins, en cas de commande en échec, le panier était vidé (sauf pour le magasin principal). Les items du panier n étaient pas chargés correctement sur les versions Magento 1.5 et inférieures (Fatal error: Call to a member function getcategoryids() on a non-object) Lors d un paiement Paypal, le montant total diffère de la somme des montants des items du panier. Affichage des noms de méthodes de paiement (au lieu des codes) dans la colonne "Méthode de paiement" de la grille des commandes affichée dans la partie admin. Nouvelles fonctionnalités : Le choix TOUTES a été remis à disposition dans la liste des types de cartes disponibles Ajout d une case à cocher qui permet au marchand d indiquer s il utilise un contrat FacilyPay (nécessaire si le type de cartes sélectionné est TOUTES) La configuration des catégories a été généralisée à tous les types de paiement. Modification du logo Paypal Nouvelles fonctionnalités : Paiement Facilipay Oney Paiement via Paypal Activation des logs depuis le panneau de configuration du module Prise en compte des contrôles de risques et passage des commandes suspectes dans l état «Fraude Suspectée» Corrections de bug : Le passage à l état PROCESSING des commandes de produits virtuels n était pas automatique. 1.3 03/12/2013 Nouvelles fonctionnalités : Paiement 3xCB Cofinoga Paiement depuis le Back End de Magento, Remboursement depuis le Back End pour les paiements CB et 3xCB Possibilité de charger un logo personnalisé, 1.2 23/04/2013 1.1 09/08/2012 Refonte du module, compatibilité PHP5, respect des standards Zend et Magento, compatibilité avec les versions Magento CE 1.4, 1.5, 1.6 et 1.7 Nouvelles fonctionnalités : Paiement fractionné Paiement en plusieurs fois, Paiement par carte cadeau 3D-Secure Sélectif, Choix du type de carte sur le site Acquisition des données de la carte sur le site, Evolution de la procédure de mise à jour Ajout d un bouton de réinitialisation Modification du nom de la classe et de l api. Correction de la génération de la facture pour afficher correctement les articles contenus dans un produit packagé 1.0b 14/12/2011 Modification du champ types de carte acceptées Guide d intégration du module de paiement Magento 2/52
1.0a 09/12/2011 Suppression du contrôle de la méthode de livraison pour les produits téléchargeables 1.0 12/10/2011 Version initiale 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 Magento 3/52
SOMMAIRE 1. Objectif... 5 2. Fonctionnalités du module... 5 3. A LIRE ABSOLUMENT AVANT D ALLER PLUS LOIN... 6 4. Pré-requis... 7 5. Installation et paramétrage du module de paiement... 8 5.1 Description du package... 8 5.2 Mise à jour du module de paiement... 9 5.3 Première installation du module... 9 5.4 Configuration générale... 10 5.1 Paramétrage du mode de paiement comptant... 17 5.2 Paramétrage du mode de paiement en plusieurs fois... 20 5.3 Paramétrage du mode de paiement par carte cadeau... 24 5.4 Paramétrage du mode de paiement 3x CB Cofinoga... 27 5.5 Paramétrage du mode de paiement Facilipay Oney... 30 5.6 Paramétrage du mode de paiement Paypal... 32 5.7 Paramétrage du mode de paiement Sofort banking... 35 6. Exemples d utilisation du module de paiement... 37 6.1 Paiement comptant... 37 6.2 Paiement en plusieurs fois... 40 6.3 Paiement par carte cadeau et paiement fractionné... 42 6.3.1. Cinématique... 42 6.3.2. Visualisation du détail d un paiement fractionné... 45 6.4 Configuration avec un seul bouton... 48 7. Paramétrage de l URL serveur de la boutique.... 49 7.1 URL serveur à la fin du paiement... 49 7.2 URL serveur sur annulation... 50 7.3 Test de l url serveur... 50 8. Option ajout code magasin à l URL... 51 9. Passage d une boutique en mode production... 52 10. Mise à jour de la documentation.... 52 11. Support... 52 Guide d intégration du module de paiement Magento 4/52
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 du module de paiement. Cependant, la lecture du guide de démarrage de votre offre est un pré-requis à la bonne compréhension de ce document. Avertissement : Le module Payzen_Magento_1.4-1.9_v1.5.1.zip n est pas compatible avec les versions MAGENTO antérieures à la version 1.4 2. FONCTIONNALITES DU MODULE Le module de paiement propose les fonctionnalités suivantes : Compatible avec Magento version 1.4 et supérieure, Compatible multi magasin / multi vue Compatible multi langue, Compatible multi devise, Redirection automatique à la boutique à la fin du paiement, Paramétrage d un montant minimum/maximum pour chaque type de paiement, Gestion de l état des commandes pour les paiements accepté, refusés et annulés. Enregistrement systématique des commandes à la fin du paiement via une url silencieuse (url serveur), 3D-Secure sélectif en fonction du montant de la commande, Paiement en plusieurs fois Paiement par carte cadeau Paiement fractionné (commande réglée avec x cartes cadeau et une cb) Paiement en 3 fois avec Cofinoga Paiement en 3 ou 4 fois avec Facily Pay (Oney) Paiement via PayPal Paiement via SOFORT Banking Guide d intégration du module de paiement Magento 5/52
3. A LIRE ABSOLUMENT AVANT D ALLER PLUS LOIN L erreur la plus fréquente concerne l url serveur. Il est indispensable de comprendre que l URL serveur est le seul mécanisme permettant à la plateforme Payzen de vous notifier de la fin du paiement. Le chapitre 6 doit être lu avec attention et les indications données respecté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». Guide d intégration du module de paiement Magento 6/52
4. PRE-REQUIS Avant de 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_1.4-1.9_v1.5.1.zip - 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) Rappel de l url de votre back office marchand : https://secure.payzen.eu/vads-merchant/ Guide d intégration du module de paiement Magento 7/52
5. INSTALLATION ET PARAMETRAGE DU MODULE DE PAIEMENT 5.1 Description du package Décompresser le fichier Payzen_Magento_1.4-1.9_v1.5.1.zip. Vous devez visualiser les fichiers cidessous : Le répertoire app contenant les fichiers du module de paiement Le répertoire skin contenant la CSS appliquée à la page de configuration du module Le répertoire media contenant les logos des différents types de cartes Le fichier Integration_PayZen_Magento_1.4-1.9_v1.5.1.pdf correspond à cette documentation. Ce module permet aux marchands de proposer du paiement comptant et du paiement en plusieurs fois par carte bancaire. Remarque Importante Avant de procéder à l installation de ce module de paiement, assurez-vous que: - la compilation soit désactivée sur votre site (Système / Outils/ Compilation). - les caches soient désactivés (cache Magento, externe, APC, etc.) Nous vous recommandons également d effectuer une sauvegarde de votre base de données. Guide d intégration du module de paiement Magento 8/52
5.2 Mise à jour du module de paiement 1: Sauvegardez votre identifiant boutique ainsi que les certificats présents dans l interface d administration du module. 2 : Assurez-vous que la compilation soit désactivée sur votre site (Système / Outils/ Compilation) 3 : Assurez-vous que caches soient désactivés (cache Magento, externe, APC, etc.) 4 : Si vous aviez installé le module de paiement Payzen (vads) : Supprimez le fichier app/etc/modules/mage_vads.xml Supprimez le répertoire app/code/local/mage/vads 5 : Si vous aviez installé le module de paiement en plusieurs fois Payzen (vadsmulti) : Supprimez le fichier app/etc/modules/mage_vadsmulti.xml Supprimez le répertoire app/code/local/mage/vadsmulti 6 : Si vous aviez installé une version antérieure du module de paiement Payzen (payzen): Supprimez le fichier app/etc/modules/mage_payzen.xml Supprimez le répertoire app/code/local/mage/payzen 7 : Si vous aviez installé le module de paiement en plusieurs fois Payzen (payzenmulti) : Supprimez le fichier app/etc/modules/mage_payzenmulti.xml Supprimez le répertoire app/code/local/mage/payzenmulti 8 : Copiez le répertoire app contenu dans le fichier Payzen_Magento_1.4-1.9_v1.5.1.zip puis collez-le dans le répertoire magento de votre site 9 : Videz les caches de Magento (Système/Gestion du cache). 10 : Cliquez sur le bouton Réinitialiser afin de prendre en compte les nouvelles fonctionnalités du module 5.3 Première installation du module Copiez les répertoires app, media et skin contenus dans le fichier Payzen_Magento_1.4-1.9_v1.5.1.zip puis collez-les dans le répertoire magento de votre site Videz les caches de Magento (Système/Gestion du cache). Guide d intégration du module de paiement Magento 9/52
5.4 Configuration générale Dans le menu VENTES (de la configuration par défaut) cliquez sur Modes de paiement : Vous visualisez la liste des modes de paiements : Sélectionnez le module PayZen pour le configurer Guide d intégration du module de paiement Magento 10/52
Informations et contact Informations sur le module Accès à la plateforme de paiement Identifiant de la boutique Saisir l identifiant du site. Cet identifiant est disponible sur votre back office. (cf.4) 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 votre outil de gestion de caisse (cf. 4). Mode TEST ou PRODUCTION Attention ce certificat de production n est disponible que lorsque le PV de recette a été renvoyé et validé par Payzen. Dans tous les cas vous êtes informé par mail de la génération de ce certificat Indiquer la valeur TEST ou PRODUCTION en fonction du statut de la boutique. URL de la page de paiement URL serveur Ce champ est pré rempli par défaut: https://secure.payzen.eu/vads-payment/ URL à copier dans votre outil de gestion de caisse (cf. 6) : /index.php/payzen/payment/check/ Attention : Lire attentivement le chapitre 7 de la documentation Guide d intégration du module de paiement Magento 11/52
Page de paiement Langue Cette option permet de choisir la langue de la page de paiement par défaut dans le cas où la langue de Magento (ex Turc) ne serait pas connue par PAYZEN. Langues disponibles Délai avant remise en banque Type de validation Si la langue/les langues utilisées par Magento sont implémentées dans PayZen alors la page de paiement s affichera dans la langue de Magento au moment où l internaute clique sur payer. Cette option permet de faire afficher des drapeaux permettant ainsi à l internaute de changer la langue sur la page de paiement. Si vous ne sélectionnez aucune langue, alors tous les drapeaux seront apparents sur la page de paiement. Pour effectuer une sélection maintenir la touche Ctrl puis cliquer sur les langues souhaitées. Langues disponibles : Français, allemand, anglais, espagnol, chinois, italien, japonais, portugais, néerlandais, suédois, russe 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. Configuration back-office : Valeur conseillée. Permet d utiliser la configuration définie dans le backoffice. (Menu : Paramétrage / Boutiques / Configuration rubrique : mode de validation) Manuelle : Cette valeur indique que les transactions devront faire l'objet d'une validation manuelle de la part du commerçant depuis le back-office. Attention : sans validation par le commerçant avant la date d expiration, la transaction ne sera jamais remise en banque. Automatique : Cette valeur indique que le paiement sera remis en banque de manière automatique sans l intervention du commerçant. Types de cartes acceptées Ce champ permet d indiquer les visuels des cartes à afficher sur la page de paiement ou sur le site marchand (cf. «entrée des données cartes»). Attention : Les types de paiement proposés à l internaute sur la page de paiement dépendent des contrats et des options associés à votre offre PayZen. Par défaut, seuls les moyens de paiement du réseau CB sont sélectionnés. Guide d intégration du module de paiement Magento 12/52
Association des catégories Vous permet d associer rapidement une catégorie à l ensemble des produits de votre catalogue. Le module détecte automatiquement l ensemble des catégories disponibles sur votre site marchand. Pour chaque catégorie vous devez associer un type produit parmi la liste disponible. Personnalisation de la page de paiement Configuration du thème Nom de la boutique URL de la boutique Permet de personnaliser la page de paiement en utilisant des mots clés spécifiques. La liste des mots clé est disponible dans le guide d implémentation «Personnalisation avancée». Cette fonctionnalité est particulièrement utile si vous souhaitez afficher un logo différent par magasin Attention, l utilisation de certains mots clé est conditionnée par la souscription à l option «Personnalisation avancée» Nom de la boutique qui sera affiché dans les mails de confirmation de paiement envoyés par PayZen. Si le champ est vide alors le nom de boutique qui apparaîtra sera celui enregistré dans l outil de gestion de caisse PayZen. Vous pouvez définir l url boutique qui s affichera sur la page de paiement ainsi que dans les mails de confirmation de paiement. Si le champ est vide alors l url de boutique qui apparaîtra sera celle enregistrée dans l outil de gestion de caisse PayZen. 3-D Secure Sélectif Montant minimum Montant minimum pour lequel vous souhaitez demander une authentification 3-D Secure. ATTENTION : La valeur de ce champ ne sera prise en compte uniquement si l option 3D-Secure sélectif est activée sur votre boutique Payzen. Cette option ne peut être activée qu après accord préalable de votre banque. Guide d intégration du module de paiement Magento 13/52
Retour à la boutique Redirection automatique Délai en cas de succès 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. Message avant redirection en cas de succès Délai en cas d échec Message avant redirection en cas d échec Mode de retour Remplir le panier en cas d échec Dans le cas où l option redirection automatique est activée vous pouvez définir le délai en seconde avant que votre client soit redirigé vers votre boutique dans le cas d un paiement réussi. Dans le cas où 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 où l option redirection automatique est activée vous pouvez définir le délai en seconde avant que votre client soit redirigé vers votre boutique dans le cas d un paiement échoué. Dans le cas où 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. 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 oblique l internaute à cliquer sur accepter pour retourner à la boutique. Cette option permet de définir l état du panier en cas d échec. Est considéré comme un échec, un paiement refusé ou un paiement non finalisé par l internaute dans le cas où celui-ci a cliqué sur le bouton annuler et retourner à la boutique. Comportement : Si l option est positionnée à oui la commande est annulée dans le back office Magento et le panier est conservé. Le client peut donc à nouveau payer son panier. Si l option est positionnée à non la commande est annulée dans le back office Magento et le panier est vidé. Guide d intégration du module de paiement Magento 14/52
Statut des commandes enregistrées avec ce mode de paiement Cette option permet de définir le statut d une commande payée avec succès via ce mode de paiement. Valeurs possibles : En attente (pending) En attente de paiement (processing). Il est conseillé de renseigner En cours de traitement. Si le paiement est refusé alors la commande sera annulée. Création de la facture Permet de choisir la méthode (automatique ou manuelle) de génération de la facture lorsque le statut des commandes enregistrées avec succès est En attente de paiement. Options additionnelles - FaciliPay Contrat FacilyPay Valeur par défaut : Non. Options de livraison (FacilyPay Oney) Sélectionnez «Oui» si vous avez déclaré un contrat FacilyPay auprès de PayZen. Vous accèderez à la configuration options de livraison. Le module de paiement détecte automatiquement toutes les méthodes de livraison activées sur votre site. Vous devrez ensuite les configurer en renseignant les champs ci-dessous. Libellé Facilipay Oney Type Permet de modifier le libellé d un transporteur lorsque la valeur du champ n est pas compatible avec le moyen de paiement Oney. Les seuls caractères spéciaux autorisés sont : espace, slash, tiret, apostrophe. La longueur maximale est de 545 caractères. Permet de définir le type de transporteur parmi les choix suivants : Compagnie de livraison : Transporteurs (La Poste, Colissimo, UPS, DHL etc ) Retrait en magasin : Retrait de marchandise chez le marchand. Point Relais : utilisation d un réseau de points-retrait tiers (kyala, alveol etc ) Retrait en station : Retrait dans un aéroport, une gare, ou une agence de voyage. Guide d intégration du module de paiement Magento 15/52
Vitesse Rapidité de livraison : Express (-de 24heures) ou standard. Afin de valider le paramétrage du module, cliquez sur Le module de paiement comptant 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 6 et est impérative pour le bon fonctionnement du module de paiement. Guide d intégration du module de paiement Magento 16/52
5.1 Paramétrage du mode de paiement comptant Depuis la liste des modes de paiements : Sélectionnez le module PayZen Paiement standard pour le configurer Guide d intégration du module de paiement Magento 17/52
Paramètres de base PayZen Paiement standard Activation Afin d activer la nouvelle méthode de paiement sélectionnez Oui Ordre de tri Ce paramètre permet d afficher l ordre des modules de paiement. Par défaut, le module de paiement comptant sera affiché en première position. Titre de la méthode de paiement Valeur par défaut Paiement par carte bancaire Activation de la restriction en fonction des pays 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 où 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. Personnalisation du logo Permet au marchand de modifier l image affichée lors de la sélection des moyens de paiement. Image par défaut : Restrictions sur le montant par groupe de client Montant Minimum Ce champ défini le montant minimum pour lequel vous souhaitez proposer le paiement avec cette méthode de paiement. Montant Maximum Ce champ défini le montant maximum au-delà duquel vous ne souhaitez pas proposer le paiement par carte bancaire. Guide d intégration du module de paiement Magento 18/52
Options de Paiement Mode d acquisition Le module vous propose 3 modes de fonctionnement : Acquisition des données sur la plateforme de paiement Le choix du type de carte se fera sur la page de paiement PayZen. Sélection du type de carte sur le site marchand Le choix du type de carte se fera lorsque le client sélectionnera le moyen de paiement «Paiement par carte bancaire» La liste des moyens de paiement proposés dépend de la configuration des types de carte acceptés (cf. plus haut) Acquisition des données sur le site marchand Cette option permet le choix du type de carte et la saisie du numéro de carte directement sur le site marchand. Nécessite la souscription de l option Acquisition carte Cette option ne peut être activée qu après accord préalable de votre banque. Une fois le paramétrage terminé, cliquez sur le bouton Guide d intégration du module de paiement Magento 19/52
5.2 Paramétrage du mode de paiement en plusieurs fois Depuis la liste des modes de paiements : Sélectionnez le module PayZen Paiement en plusieurs fois pour le configurer Guide d intégration du module de paiement Magento 20/52
Paramètres de base Activation Afin d activer la nouvelle méthode de paiement en plusieurs fois sélectionnez Oui Par défaut ce mode est désactivé Ordre de tri Ce paramètre permet d afficher l ordre des modules de paiement. Par défaut, le mode de paiement en plusieurs fois sera affiché en deuxième position. Titre de la méthode de paiement Valeur par défaut Paiement par carte bancaire en plusieurs fois Activation de la restriction en fonction des pays 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 où 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. Personnalisation du logo Permet au marchand de modifier l image affichée lors de la sélection des moyens de paiement. Image par défaut : Restrictions sur le montant par groupe de client Montant Minimum Ce champ défini le montant minimum pour lequel vous souhaitez proposer le paiement avec cette méthode de paiement. Guide d intégration du module de paiement Magento 21/52
Montant Maximum Ce champ défini le montant maximum au-delà duquel vous ne souhaitez pas proposer le paiement par carte bancaire en plusieurs fois. Options de paiement Options de paiement Ce module vous permet de créer autant de méthode de paiement en plusieurs fois que vous souhaitez. Chaque méthode aura un code différent qui pourra être affiché dans le tableau des commandes. Pour ajouter une option de paiement, cliquer sur le bouton Libellé de l option Texte décrivant l option de paiement multiple telle qu elle sera proposée pendant le checkout. Exemple : Payer en 3 fois sans Frais Montant minimum Permet de définir le montant minimum pour que l option de paiement soit proposée. Montant maximum Permet de définir le montant maximum pour que l option de paiement soit proposée. Contrat Permet de définir le contrat commerçant à utiliser lors d un paiement avec cette option. Nombre d échéances Nombre d échéances d un paiement: 3 pour du paiement en 3 fois 4 pour du paiement en 4 fois Etc... Guide d intégration du module de paiement Magento 22/52
Période Période (en jours) entre chaque échéance. Montant de la première échéance Montant de la première échéance, en pourcentage du montant. 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 souhaitez des montants identiques pour chaque échéance, laissez le champ vide. Exemple de configuration : Une fois le paramétrage terminé, cliquez sur le bouton Guide d intégration du module de paiement Magento 23/52
5.3 Paramétrage du mode de paiement par carte cadeau Depuis la liste des modes de paiements : Sélectionnez le module PayZen Paiement par carte cadeau pour le configurer Guide d intégration du module de paiement Magento 24/52
Paramètres de base Activation Afin d activer la nouvelle méthode de paiement par carte cadeau sélectionnez Oui Par défaut ce mode est désactivé Ordre de tri Ce paramètre permet d afficher l ordre des modules de paiement. Par défaut, le mode de paiement par carte cadeau sera affiché en troisième position. Titre de la méthode de paiement Valeur par défaut Paiement par carte cadeau Activation de la restriction en fonction des pays 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 où 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. Personnalisation du logo Permet au marchand de modifier l image affichée lors de la sélection des moyens de paiement. Image par défaut : Restrictions sur le montant par groupe de client Montant Minimum Ce champ défini le montant minimum pour lequel vous souhaitez proposer le paiement avec cette méthode de paiement. Guide d intégration du module de paiement Magento 25/52
Montant Maximum Ce champ défini le montant maximum au-delà duquel vous ne souhaitez pas proposer cette méthode de paiement. Page de paiement Type de cartes cadeau Ce champ permet de sélectionner le visuel des cartes cadeau à afficher sur la page de paiement ou sur le site marchand. Ajout d une nouvelle carte cadeau Ajout Ce module vous permet d ajouter de nouvelles cartes cadeau. Attention, pour qu un nouveau type de carte cadeau puisse être utilisé pour le paiement, vous devez au préalable contacter le support technique PayZen. Pour ajouter une carte cadeau, cliquer sur le bouton Code de la carte Code technique qui sera fourni par PayZen Libellé de la carte Libellé de la carte cadeau. Logo de la carte Permet de définir le logo de la carte affiché lors de la sélection des moyens de paiement. Une fois le paramétrage terminé, cliquez sur le bouton Guide d intégration du module de paiement Magento 26/52
5.4 Paramétrage du mode de paiement 3x CB Cofinoga L activation de ce moyen de paiement suppose que vous ayez au préalable : souscrit un contrat d acceptation auprès de Cofinoga, souscrit à l option «paiement 3xCB Cofinoga» auprès de Payzen, transmis à Payzen le numéro de contrat 3xCB délivré par Cofinoga. Depuis la liste des modes de paiements : Sélectionnez le module PayZen Cofinoga 3xCB pour le configurer Guide d intégration du module de paiement Magento 27/52
Paramètres de base Activation Afin d activer la nouvelle méthode de paiement par carte cadeau sélectionnez Oui Par défaut ce mode est désactivé Ordre de tri Ce paramètre permet d afficher l ordre des modules de paiement. Par défaut, le mode de paiement 3xCB Cofinioga sera affiché en quatrième position. Titre de la méthode de paiement Valeur par défaut Cofinoga 3 fois CB Activation de la restriction en fonction des pays 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 où 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. Personnalisation du logo Permet au marchand de modifier l image affichée lors de la sélection des moyens de paiement. Image par défaut : Restrictions sur le montant Montant Minimum Ce champ défini le montant minimum pour lequel vous souhaitez proposer le paiement avec cette méthode de paiement. Montant Maximum Guide d intégration du module de paiement Magento 28/52
Ce champ défini le montant maximum au-delà duquel vous ne souhaitez pas proposer cette méthode de paiement. Une fois le paramétrage terminé, cliquez sur le bouton Guide d intégration du module de paiement Magento 29/52
5.5 Paramétrage du mode de paiement Facilipay Oney L activation de ce moyen de paiement suppose que vous ayez au préalable : souscrit un contrat d acceptation auprès de Banque Accord, souscrit à l option «paiement FacilyPay Oney» auprès de Payzen, transmis le numéro de contrat FacilyPay Oney délivré par Banque Accord à Payzen. Depuis la liste des modes de paiements : Sélectionnez le module PayZen Facilipay Oney pour le configurer Guide d intégration du module de paiement Magento 30/52
Paramètres de base Activation Afin d activer la nouvelle méthode de paiement par carte cadeau sélectionnez Oui Par défaut ce mode est désactivé Ordre de tri Ce paramètre permet d afficher l ordre des modules de paiement. Par défaut, le mode de paiement par FacilyPay sera affiché en cinquième position. Titre de la méthode de paiement Valeur par défaut FacilyPay Sélection des pays FacilyPay Oney n est disponible que pour les livraisons réalisées en France. Vous ne pouvez donc pas modifier ce paramètre. Personnalisation du logo Permet au marchand de modifier l image affichée lors de la sélection des moyens de paiement. Image par défaut : Restrictions sur le montant par groupe de client Montant Minimum Montant Maximum Ce champ défini le montant minimum pour lequel vous souhaitez proposer le paiement avec cette méthode de paiement. Ce champ doit obligatoirement être renseigné avec le montant le plus bas autorisé, toutes options commerciales confondues, par votre contrat Oney. En général ce montant est de 100. Ce champ défini le montant maximum au-delà duquel vous ne souhaitez pas proposer cette méthode de paiement. Ce champ doit obligatoirement être renseigné avec le montant le plus haut autorisé, toutes options commerciales confondues, par votre contrat Oney En général le montant maximum est de 2000. Une fois le paramétrage terminé, cliquez sur le bouton Guide d intégration du module de paiement Magento 31/52
5.6 Paramétrage du mode de paiement Paypal L activation de ce moyen de paiement suppose que vous ayez au préalable : ouvert un compte Paypal marchand sur le site de Paypal, souscrit à l option «paiement Paypal» auprès de Payzen, dans le back office Payzen : o ajouté le compte Paypal marchand o donné les habilitations o associé votre compte marchand à votre boutique Depuis la liste des modes de paiements : Sélectionnez le module PayZen Paypal Payment pour le configurer Guide d intégration du module de paiement Magento 32/52
Paramètres de base Activation Afin d activer la nouvelle méthode de paiement par carte cadeau sélectionnez Oui Par défaut ce mode est désactivé Ordre de tri Ce paramètre permet d afficher l ordre des modules de paiement. Par défaut, le mode de paiement par Paypal sera affiché en sixième position. Titre de la méthode de paiement Valeur par défaut Paiement Paypal Activation de la restriction en fonction des pays 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 où 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. Personnalisation du logo Permet au marchand de modifier l image affichée lors de la sélection des moyens de paiement. Image par défaut : Restrictions sur le montant Montant Minimum Ce champ défini le montant minimum pour lequel vous souhaitez proposer le paiement avec cette méthode de paiement. Guide d intégration du module de paiement Magento 33/52
Montant Maximum Ce champ défini le montant maximum au-delà duquel vous ne souhaitez pas proposer cette méthode de paiement. Une fois le paramétrage terminé, cliquez sur le bouton Guide d intégration du module de paiement Magento 34/52
5.7 Paramétrage du mode de paiement Sofort banking L activation de ce moyen de paiement suppose que vous ayez au préalable : ouvert un contrat auprès de Sofortl, souscrit à l option «paiement Sofort Banking» auprès de Payzen, dans le back office Payzen : o ajouté le contrat sofort banking avec votre projectid et votre ApiID o associé votre contrat à votre boutique Depuis la liste des modes de paiements : Sélectionnez le module PayZen Sofort Banking pour le configurer Guide d intégration du module de paiement Magento 35/52
Paramètres de base Activation Afin d activer la nouvelle méthode de paiement par carte cadeau sélectionnez Oui Par défaut ce mode est désactivé Ordre de tri Ce paramètre permet d afficher l ordre des modules de paiement. Par défaut, le mode de paiement Sofort sera affiché en sixième position. Titre de la méthode de paiement Valeur par défaut Paiement Sofort Banking Activation en fonction du pays Sélectionner le pays depuis lequel vous souhaitez que ce mode de paiement apparaisse. Personnalisation du logo Permet au marchand de modifier l image affichée lors de la sélection des moyens de paiement. Image par défaut : Restrictions sur le montant par groupe de client Montant Minimum Ce champ défini le montant minimum pour lequel vous souhaitez proposer le paiement avec cette méthode de paiement. Montant Maximum Ce champ défini le montant maximum au-delà duquel vous ne souhaitez pas proposer cette méthode de paiement. Une fois le paramétrage terminé, cliquez sur le bouton Guide d intégration du module de paiement Magento 36/52
6. EXEMPLES D UTILISATION DU MODULE DE PAIEMENT 6.1 Paiement comptant Exemple d une commande d un montant de 649.95. Voici les choix qui seront proposés à l acheteur en fonction de la configuration du mode de saisie des données de sa carte : Acquisition par la plateforme de paiement : Si l acheteur sélectionne un paiement en «Paiement par carte bancaire», il sera redirigé vers la page de paiement ci-dessous : Guide d intégration du module de paiement Magento 37/52
Sélection du type de carte sur le site marchand : Si l acheteur sélectionne un «Paiement par carte bancaire» avec une carte CB, il sera redirigé vers la page de saisie du numéro de carte : Guide d intégration du module de paiement Magento 38/52
Acquisition des données carte sur le site marchand : Après avoir renseigné les informations de la carte, l acheteur ne sera pas redirigé vers la plateforme de paiement. La page ci-dessous sera affichée le temps du paiement : Guide d intégration du module de paiement Magento 39/52
6.2 Paiement en plusieurs fois Exemple d une commande d un montant de 649.95. Avec notre configuration, l acheteur pourra choisir parmi les modes de paiement ci-dessous : S il sélectionne un paiement en «3x sans frais», il sera redirigé vers la page de paiement ci-dessous : Guide d intégration du module de paiement Magento 40/52
Les montants et les dates de vente de chaque échéance sont rappelés à chaque étape du paiement : Guide d intégration du module de paiement Magento 41/52
6.3 Paiement par carte cadeau et paiement fractionné 6.3.1. Cinématique Exemple d une commande d un montant de 620. L acheteur désire utiliser une carte cadeau dont le solde est inférieur au montant total de la commande. L acheteur est alors redirigé sur la page de paiement pour saisir le numéro les informations de sa carte cadeau : Guide d intégration du module de paiement Magento 42/52
Une fois le paiement réalisé, la plateforme propose à l acheteur de régler le solde avec un autre moyen de paiement : L acheteur peut alors sélectionner un moyen de paiement complémentaire et finaliser son paiement : Guide d intégration du module de paiement Magento 43/52
Puis saisir les informations de la carte pour le paiement complémentaire : Remarque : A tout moment, l acheteur peut annuler un paiement partiel en cliquant sur l icône corbeille ( ). Une fois la commande finalisée, le récapitulatif du paiement indique les différents moyens de paiement utilisés : Guide d intégration du module de paiement Magento 44/52
6.3.2. Visualisation du détail d un paiement fractionné Dans le détail de la commande : le bloc Informations de paiement comportera de détail des cartes utilisées lors du paiement fractionné : Dans l onglet Transactions : vous pourrez visualisez chaque transaction composant la séquence du paiement : Guide d intégration du module de paiement Magento 45/52
Dans le détail de chaque transaction, vous pourrez visualiser le montant et le type de carte utilisé : Première transaction de type ILLICADO : Deuxième transaction de type CB : Guide d intégration du module de paiement Magento 46/52
Le mail de confirmation de commande envoyé par Magento reprendra lui aussi le détail des cartes utilisées : Guide d intégration du module de paiement Magento 47/52
6.4 Configuration avec un seul bouton Dans cette configuration, vous ne devez activer que le module de paiement standard. Dans la configuration générale du module, sélectionnez tous les types de cartes que vous souhaitez proposer à l acheteur. Une fois le processus de commande terminé, l acheteur n aura qu un seul choix de paiement : Vous pouvez modifier les textes et logos depuis la configuration du module afin de rendre cet écran plus clair pour l acheteur. Une fois la commande validée sur votre site, l acheteur est redirigé sur la page de paiement : L acheteur pourra alors choisir son moyen de paiement parmi la liste des contrats disponibles sur votre boutique. A noter que certains moyens de paiement, ne seront pas affichés si les contraintes liées au montant (ou autres) ne sont pas respectées. Guide d intégration du module de paiement Magento 48/52
7. PARAMETRAGE DE L URL SERVEUR DE LA BOUTIQUE. 7.1 URL serveur à la fin du paiement 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 à la fin du paiement. Dans l outil de gestion de caisse, aller dans le menu paramétrage/boutique/règles de notifications Recherchez la règle «URL serveur à la fin du paiement» Effectuez un clic droit sur la règle et sélectionnez Gérer la règle. (Vous pouvez également effectuer un double clic sur la ligne). Vous visualisez alors la fenêtre ci-dessous : Guide d intégration du module de paiement Magento 49/52