Plateforme Systempay ntégration du module de paiement pour la plateforme Thelia.
Rédaction, Vérification, Approbation Rédaction Vérification Approbation Nom Date/Visa Nom Date/Visa Nom Date/Visa Lyra-Network 08/03/2010 Lyra-Network 08/03/2010 Lyra-Network 08/03/2010 Historique du document Version Auteur Date Commentaires 1.0a Lyra-Network 08/03/2010 Création du document 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.
SOMMARE 1. Objectif...1 2. Pré-requis...1 3. nstallation et paramétrage du module de paiement...2 3.1 : nstallation du module.... 2 3.2 : Paramétrage du module de paiement... 4 4. Paramétrage de l URL serveur de la boutique....9 4.1 : Accès au paramétrage... 9 4.2 : Test de l URL serveur... 10 5. Mise à jour de la documentation....10
1. Objectif Ce tutorial s adresse à tous les commerçants ayant souscrit à l offre Cyberplus Paiement (Systempay) et s appuyant sur la plateforme Thelia pour le développement de leur boutique e-commerce. l décrit pas-à-pas l intégration du module de paiement. Cependant, la lecture du guide de démarrage Cyberplus Paiement est un pré-requis à la bonne compréhension de ce document. Avertissement : La compatibilité du module Systempay_Thelia_1.4.2.1_v1.0a.zip n est pas garantie pour les versions Thelia antérieures à la version 1.4.2.1. 2. Pré-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 : Systempay_Thelia_1.4.2.1_v1.0a.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) Lyra Network- 1/10
3. nstallation et paramétrage du module de paiement 3.1 : nstallation du module. Afin d installer le module de paiement, connectez vous sur l interface d administration de votre boutique Thelia. Cliquez sur Configuration, puis éditer l activation des plugins. 1 2 Vous devez observer l écran suivant : Cliquez sur parcourir Se positionner sur le fichier fourni Systempay_Thelia_1.4.2.1_V1a.zip Puis cliquer sur Ouvrir Lyra Network- 2/10
Vous devez maintenant observer l écran suivant : Cliquez sur Valider L écran suivant est : Cliquez sur Activer Le module est désormais activé, vous devez observer : Lyra Network- 3/10
3.2 : Paramétrage du module de paiement Dans l administration de Thelia, cliquez sur Modules Ecran suivant : Cliquez sur Editer le module vads. Détails du paramétrage. Url de la page de paiement https://systempay.cyberpluspaiement.com/vadspayment/ Cette url est renseignée par défaut Url serveur à renseigner dans le back office Cyberplus Paiement dentifiant de votre site Certificat en mode test http://monsite/client/plugins/vads/confirmation.php Cette Url est l url qui sera appelée automatiquement après chaque paiement. Elle est à renseigner impérativement dans l outil de gestion de caisse dans l onglet paramétrage/boutique. Le chapitre 4 de cette documentation reprend l explication de l url Serveur. Saisir l identifiant du site. Cet identifiant est disponible sur votre back office. (cf. 2) ndiquer le certificat de test disponible dans le back office outil de gestion de caisse (cf. 2). Lyra Network- 4/10
Certificat en mode production ndiquer le certificat de production disponible dans le back office outil de gestion de caisse (cf. 2). Attention ce certificat de production n est disponible que lorsque le PV de recette a été renvoyé et validé par Natixis Paiement. Dans tous les cas vous êtes informé par mail de la génération de ce certificat. Mode de fonctionnement Cocher la valeur TEST ou PRODUCTON en fonction du statut de la boutique 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. DE ( allemand ), ZN ( Chinois ), EN ( anglais ), T ( talien ), JA ( Japonais ). Devise Ce champ permet de préciser la monnaie dans laquelle se fera le paiement. Le code 978 représente la devise Euro. Type de carte Ce champ permet d indiquer les visuels des cartes à afficher sur la page de paiement (Exemple CB, VSA, American Express, etc.). La valeur vide (valeur par défaut) permet d afficher tous les visuels de carte que votre adhésion à Cyberplus Paiement vous permet d accepter. l est vivement recommandé de laisser ce champ vide pour vous éviter d avoir à modifier ultérieurement ce paramétrage si vous souscriviez à l acceptation de nouveaux types de cartes. l est toute fois possible de configurer ce champ de la manière suivante : Exemple pour Paiement CB,Visa,MasterCard, American express. Valeur du champ : CB;VSA;MASTERCARD;AMEX Lyra Network- 5/10
Mode de paiement Ce champ permet de définir les modalités de paiement à appliquer (en une ou plusieurs fois). La valeur n est pas modifiable dans cette interface dans la mesure où le paiement en plusieurs fois n est pas nativement pris en compte par Thelia. 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. Mode de validation Ce paramètre indique si cette transaction devra faire l'objet d'une validation manuelle de la part du commerçant depuis l outil de gestion de caisse. Si ce paramètre est vide 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) l est donc plutôt conseillé de laisser le champ vide sauf si vous souhaitez altérer les valeurs par défaut de votre configuration. Attention : Dans le cas du mode manuel (valeur 1), 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. 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. False => désactivée True => Activée Temps avant redirection en cas de succès 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. Lyra Network- 6/10
Message avant redirection en cas de succès 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 : «Votre paiement a bien été pris en compte, vous allez être redirigé dans quelques instants» Temps avant redirection en cas d échec 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 avant redirection en cas d échec 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 rediriger vers la boutique. Par défaut le message est : «Une erreur s'est produite, vous allez être redirigé dans quelques instants» URL en cas de succès URL facultative où sera redirigé l internaute en cas de succès du paiement, après appui du bouton " retourner à la boutique ". Par défaut l url pointe vers le fichier http://monsite/client/plugins/vads/confirmation.php URL en cas de refus d autorisation URL en cas d autre refus URL facultative où sera redirigé le client en cas de refus d autorisation avec le code 02 «referral», après appui du bouton " retourner à la boutique ". Par défaut l url pointe vers le fichier http://monsite/regret.php URL facultative où sera redirigé le client en cas de refus pour toute autre cause que le " referral ", après appui du bouton " retourner à la boutique ". Par défaut l url pointe vers le fichier http://monsite/regret.php Lyra Network- 7/10
URL en cas d erreur URL en cas d annulation URL facultative où sera redirigé le client en cas d'erreur de traitement interne. Par défaut l url pointe vers le fichier http://monsite/regret.php URL facultative où sera redirigé le client si celui-ci appuie sur " annuler et retourner à la boutique " avant d'avoir procédé au paiement. Par défaut l url pointe vers le fichier http://monsite/regret.php URL par défaut dentifiant Du plugin URL obligatoire où sera redirigé par défaut le client après un appui sur le bouton " retourner à la boutique ", si les URL correspondantes aux cas de figure vus précédemment ne sont pas renseignées. Par défaut l url pointe vers le fichier http://monsite/client/plugins/vads/confirmation.php Ce paramètre affiche la version du module de paiement. Afin de finaliser le paramétrage, cliquez sur Valider (Bouton en bas en droite) 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 suivant et est impérative pour le bon fonctionnement du module de paiement. Lyra Network- 8/10
4. Paramétrage de l URL serveur de la boutique. 4.1 : Accès au paramétrage 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) Pour Thelia l Url doit appeler le fichier confirmation.php Ex : http://www.monsite.com/client/plugins/vads/confirmation.php Url Serveur de la boutique en mode test: (mode test) Pour Thelia l Url doit appeler le fichier confirmation.php Ex : http://www.monsite.com/client/plugins/vads/confirmation.php Lyra Network- 9/10
4.2 : Test de l URL serveur Effectuez un achat sur votre boutique sans cliquer sur le bouton retour à la boutique. Vérifiez dans l administration de votre boutique Thelia que votre commande soit enregistrée. 5. Mise à 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 : supportvad@lyranetwork.com en indiquant impérativement la version utilisée de Thelia, la version du module de paiement utilisée ainsi que la version de la documentation «ntégration du module de paiement pour la plateforme Thelia.» Lyra Network- 10/10