Mdule pur la slutin e-cmmerce Hybris
smmaire 1. Intrductin... 3 1.1. Objet du dcument... 3 1.2. Liste des dcuments de référence... 3 1.3. Avertissement... 3 1.4. Cntacts... 3 1.5. Histrique des révisins... 3 2. Présentatin du mdules pur Hybris... 4 2.1. Structure... 4 2.2. Cmpatibilité du mdule... 4 3. Intégratin du mdule dans vtre butique... 5 3.1. Pré-requis... 5 3.2. Installatin... 5 3.2.1. Cpie du mdule dans le système de fichiers... 5 3.2.2. Cmpilatin et mise à jur... 6 3.2.3. Redémarrage du serveur... 8 3.3. Cnfiguratin... 8 3.3.1. Internatinalisatin... 8 3.3.2. Créatin d utilisateur Payline et drits d accès... 9 3.3.3. Cnfiguratin du cmpte cmmerçant Payline... 10 3.3.4. Cnfiguratin des paramètres prxy... 11 3.3.5. Cnfiguratin du pint de vente... 12 3.3.6. Cnfiguratin des cntrats... 13 3.3.7. Cnfiguratin des statuts... 13 3.3.8. Cnfiguratin du paiement Web... 14 3.3.9. Cnfiguratin du paiement par Prtefeuille... 14 4. Fnctinnement... 15 4.1. Sélectin de la méthde de paiement... 15 4.2. Redirectin vers la page web de paiement Payline... 15 4.3. Retur à la butique... 15 4.4. Détail de la cmmande... 15 Ce dcument est la prpriété exclusive de. Tute reprductin intégrale u partielle, tute utilisatin par des tiers
1. Intrductin 1.1. Objet du dcument Ce dcument décrit la cmpsitin et le fnctinnement du mdule Payline pur Hybris, qui permet une mise en œuvre rapide de la slutin Payline dans vtre butique Hybris. 1.2. Liste des dcuments de référence Ce dcument cmplète le dcument de présentatin fnctinnelle de Payline dispnible sur le site Internet www.payline.cm u sur simple demande auprès du service d assistance Payline. 1.3. Avertissement Ce dcument est la prpriété exclusive de. Tute reprductin intégrale u partielle, tute utilisatin par des tiers, u tute cmmunicatin à des tiers, sans accrd préalable écrit de, est illicite. 1.4. Cntacts Vus avez besin d aide, de cnseil u vus suhaitez simplement nus pser une questin. Cntactez l Assistance Payline : supprt@payline.cm Si vus décuvrez une erreur dans cette dcumentatin, vus puvez nus envyez un email en décrivant l erreur u le prblème aussi précisément que pssible. Merci de préciser la référence du dcument, sa date (indiquée sur la première page du dcument) et le(s) numér(s) de page(s). 1.5. Histrique des révisins Le tableau ci-dessus liste les dernières mdificatins effectuées sur ce dcument. date versin mdificatins 15/09/2014 1A Refnte Ce dcument est la prpriété exclusive de. Tute reprductin intégrale u partielle, tute utilisatin par des tiers
2. Présentatin du mdules pur Hybris 2.1. Structure Le mdule pur Hybris est mis à dispsitin sus la frme d un dssier cmpressé nmmé QUA8_CRv20131009-ext-payline.zip cntenant un unique répertire : ext-payline. Cette archive est prtégée par un mt de passe qui vus sera cmmuniqué sur demande auprès du supprt Payline. Le mdule cntient les éléments permettant l appel des web services Payline, ainsi que l intégratin de Payline au sein des parties frnt-ffice (paiement) et back-ffice (cnfiguratin) de vtre butique réalisée sus Hybris. 2.2. Cmpatibilité du mdule Le mdule pur Hybris est dévelppé et testé avec l envirnnement suivant : Hybris Multichannel Acceleratr Standalne 4.7.4 systèmes d explitatin Windws 7 Prfessinnel JAVA 1.6 Ce dcument est la prpriété exclusive de. Tute reprductin intégrale u partielle, tute utilisatin par des tiers
3. Intégratin du mdule dans vtre butique 3.1. Pré-requis Le mdule Payline pur Hybris est cnstruit autur du kit Payline JAVA, vus devez également dispser d un cmpte Payline pur cnfigurer vtre mdule. La slutin Payline repse sur l appel de web services, assurez-vus que l appel de web services sécurisés est dnc pssible avec vtre slutin d hébergement (l uverture des prts 8080 et 443 en entrée/srtie est nécessaire). 3.2. Installatin 3.2.1. Cpie du mdule dans le système de fichiers Décmpressez le fichier QUA8_CR-v20131009-ext-payline.zip et placez sn cntenu sus hybris\bin\.l arbrescence de vtre envirnnement dit être de la frme : Ce dcument est la prpriété exclusive de. Tute reprductin intégrale u partielle, tute utilisatin par des tiers
L ensemble des fichiers de cnfiguratin mdifiés est furni dans le répertire hybris\bin\extpayline\ paylinekit\patch-hybris. Faire un cpier/cller du cntenu de ce répertire sur vtre dssier d installatin d Hybris. Lrs de la cpie Windws demande s il faut écraser les fichiers. Répndre ui. 3.2.2. Cmpilatin et mise à jur Ouvrir une invite de cmmande dans le répertire hybris\bin\platfrm Taper la cmmande : setantenv.bat Taper la cmmande : ant clean Taper la cmmande : ant Taper la cmmande suivante pur démarrer le server hybris : hybrisserver.bat Lrsque le serveur est pératinnel, le texte suivants apparait dans la cnsle : INFO: Server startup in 125060 ms Ouvrir un navigateur web, et allez à l url suivante : http://127.0.0.1:9001/platfrm/update Entrer le mt de passe administrateur (nimda si celui n a pas été changé) Sur l écran de cnfiguratin de l update, activer les ptins suivantes : Ccher update running system Ccher Clear the hmc cnfiguratin frm the database Ccher Lcalize types Ccher hmc Ce dcument est la prpriété exclusive de. Tute reprductin intégrale u partielle, tute utilisatin par des tiers
Ccher basecmmerce Ccher paylinekit Ccher paylinefulfilmentprcess Ccher paylinewallet Ccher paylinecmmerceservices Ccher paylineacceleratrservices Ccher paylinepayment Ccher paylinebackffice Puis faire click sur le butn Update et attendre la fin d la mise à jur. Lrsque la mise à jur est terminée, vtre écran dit ressembler à ceci : Ce dcument est la prpriété exclusive de. Tute reprductin intégrale u partielle, tute utilisatin par des tiers
3.2.3. Redémarrage du serveur Lrsque la mise à jur est réalisée, il est impératif de redémarrer vtre serveur : Faire cntrl+c dans vtre invite de cmmande pur arrêter le serveur Redémarrer le serveur en tapant la cmmande suivante : hybrisserver.bat 3.3. Cnfiguratin 3.3.1. Internatinalisatin Le mdule Payline supprte les langues Anglais et Français. Pur activer le français sur la platefrme Hybris, ajuter le langage Français (grâce à «create language») cmme sur la capture d écran ci-après : Ce dcument est la prpriété exclusive de. Tute reprductin intégrale u partielle, tute utilisatin par des tiers
Nte : Si la langue Française n était pas activé au mment de l installatin du mdule, il est nécessaire de refaire un update sur la platefrme pur les mêmes extensins en vérifiant que l ptin «Lcalize types» est cchée (il ne sera pas nécessaire dans ce cas de redémarrer le serveur). 3.3.2. Créatin d utilisateur Payline et drits d accès ext-payline\paylinekit\resurces\impex\prjectdata_user_acc_payline.impex ajute un utilisateur PaylineMgr au grupe emplyé et définis les drits assciés. Les drits d accès de cet utilisateur snt définis pur qu il puisse cnfigurer et utiliser les fnctins Payline. Il hérite également du grupe emplyé et des drits assciés. Cet utilisateur peut se cnnecter à hmc avec les identifiants suivants : Utilisateur : PaylineMgr Mt de passe : PaylineMgr Nus vus cnseillns de le prendre en mdèle et de le persnnaliser pur attribuer les drits d accès aux utilisateurs et grupes qui devrnt utiliser le back ffice Payline. La suite de la cnfiguratin décrite dans ce dcument peut être réalisée avec ce cmpte et ne nécessite plus d être administrateur de la platefrme Hybris. Ce dcument est la prpriété exclusive de. Tute reprductin intégrale u partielle, tute utilisatin par des tiers
3.3.3. Cnfiguratin du cmpte cmmerçant Payline Cnnectez-vus sur l applicatin hmc à l url suivante : http://lcalhst:9001/hmc/hybris Sur la partie gauche, les menus de cnfiguratin nt été ajutés : Faire un clic drit sur le menu Authentificatin, puis cliquer sur Create : Saisissez les infrmatins de vtre cmpte Payline (identifiant cmmerçant et clé d accès), puis cliquez sur Create. Cliquez ensuite sur le butn télécharger. Une fenêtre s uvre pur indiquer le résultat et la prcédure à suivre en cas d échec. Si aucune fenêtre ne s uvre, vérifiez dans la cnfiguratin du navigateur que les pp-up ne snt pas blqués. Ce dcument est la prpriété exclusive de. Tute reprductin intégrale u partielle, tute utilisatin par des tiers
3.3.4. Cnfiguratin des paramètres prxy Si vus devez cnfigurer prxy, faire click sur le menu prxy, puis click sur le butn search: Dans la partie drite, l nglet «results» présente la cnfiguratin existante du prxy, faire duble click sur la ligne de résultat pur puvir l éditer : Enter vs paramètres prxy, et activer les en cchant la case actif, puis faire click sur le butn «save»: Ce dcument est la prpriété exclusive de. Tute reprductin intégrale u partielle, tute utilisatin par des tiers
3.3.5. Cnfiguratin du pint de vente Cliquez sur le menu Pint de vente, puis sur rechercher. Dans la liste de résultat, sélectinner le pint de vente que vus suhaitez utiliser par duble clic sur la ligne (il est également pssible de faire une sélectin multiple de tus les pints de vente puis de cliquer sur use). Les butiques Hybris hébergés sur le serveur divent être assciées à un pint de vente Payline : faire un clic drit dans le tableau Butique Hybris et chisir ajuter, puis dans la fenêtre qui s uvre sélectinner la/les butique(s) qui sernt asscié à chaque pint de vente. Ntez que : Ce dcument est la prpriété exclusive de. Tute reprductin intégrale u partielle, tute utilisatin par des tiers
Chaque butique Hybris dit être assciée à un pint de vente Payline. Plusieurs butiques peuvent être assciées à un même pint de vente Payline La cnfiguratin nminale est d utiliser un pint de vente par butique Hybris Il est pssible par clic drit sur le tableau de supprimer une assciatin entre butique et pint de vente Astuce Pur faciliter la navigatin entre les éléments il est parfis agréable de garder la zne de résultats tujurs visible, pur cela : faire click sur le cadenas à drite de la vue que vus suhaitez garder à l écran. A chaque chargement de page, elle restera ainsi uverte. 3.3.6. Cnfiguratin des cntrats Pur cnfigurer vs cntrats, cliquez sur le menu cntrats, puis sur le butn search. La liste de résultat présente l ensemble des cntrats actifs de vtre cmpte Payline. Faire un duble clic sur la ligne du cntrat que vus suhaitez prpser, puis définir ses ptins : prpser dans la butique prpser sur les pages payline en cas de refus du premier essai Cliquez enfin sur le butn save pur sauvegarder la cnfiguratin. 3.3.7. Cnfiguratin des statuts Cliquez sur le menu Statuts Pur créer une cnfiguratin de statut, faites un clic drit sur Statuts dans la partie gauche de l écran, puis sélectinnez create Item. Sélectinnez une butique Hybris, puis les valeurs suhaitées dans chaque liste dérulante, et cliquez sur Save. Ce dcument est la prpriété exclusive de. Tute reprductin intégrale u partielle, tute utilisatin par des tiers
Vtre cnfiguratin des statuts dit être assciée à une butique Hybris. Une cnfiguratin de statuts dit être créée pur chaque butique Hybris Attentin : nus vus cnseillns de cnserver la cnfiguratin définis cmme ci-dessus hrmis le nm de la butique asscié. 3.3.8. Cnfiguratin du paiement Web Cliquez sur le menu Pers paiement Web. Faire un clic drit sur Pers paiement Web pur créer une cnfiguratin de persnnalisatin paiement Web. Faire clic sur search pur sélectinner et éditer une cnfiguratin existante Entrer les valeurs suhaités, puis faire click sur le butn save Chaque butique Hybris dit avir une cnfiguratin Pers paiement Web existante. 3.3.9. Cnfiguratin du paiement par Prtefeuille Cliquez sur le menu Pers paiement Prtefeuille. Faire un clic drit sur Pers paiement Prtefeuille pur créer une cnfiguratin de persnnalisatin paiement Prtefeuille Faire clic sur search pur sélectinner et éditer une cnfiguratin existante Entrer les valeurs suhaités, puis faire click sur le butn save Chaque butique Hybris dit avir une cnfiguratin Pers paiement Prtefeuille existante. Ce dcument est la prpriété exclusive de. Tute reprductin intégrale u partielle, tute utilisatin par des tiers
4. Fnctinnement 4.1. Sélectin de la méthde de paiement Une fis le mdule installé, cnfiguré et activé, Payline peut être sélectinnée par les clients de vtre butique Hybris à l étape 3 du prcessus de cmmande. Les myens de paiement pur lesquels l ptin prpser dans la butique est active (vir 3.3.6) snt affichés sus frme de lgs. Le chix fait par l acheteur est sauvegardé et rappelé dans l écran de récapitulatif cmmande. 4.2. Redirectin vers la page web de paiement Payline La redirectin vers la page de paiement se fait après la validatin du récapitulatif. L acheteur prcède en tut sécurité à la saisie des dnnées de paiement pur le myen qu il a sélectinnée en butique. 4.3. Retur à la butique Une fis la saisie de ses infrmatins de paiement validée, le client btient un écran de cnfirmatin l infrmant du résultat de sa transactin. Sur cet écran un butn «retur à la butique» lui permet d être redirigé vers la page de cnfirmatin de cmmande dans la butique Hybris. Le retur à la butique met immédiatement le statut de la cmmande à jur. Si le paiement est refusé u annulé, la cmmande est passée au statut crrespndant. Lrsque le paiement est accepté, la cmmande passe à l état En curs. Si la page web de paiement est fermée sans que le client returne à la butique, la mise à jur dans vtre butique Hybris sera autmatiquement effectuée par le traitement de ntificatin Payline. 4.4. Détail de la cmmande Les infrmatins relatives à Payline apparaissent dans l nglet du même nm au niveau du détail de la cmmande. 3 butns d actins snt dispnibles (affiché seln l état du paiement): Cancel : annulatin de la cmmande Remburser: rembursement de la cmmande (sélectinner les lignes désirées si nécessaire) Valider : validatin de la cmmande et du paiement (sélectinner les lignes désirées si nécessaire) Ce dcument est la prpriété exclusive de. Tute reprductin intégrale u partielle, tute utilisatin par des tiers