Guide d'installation et de configuration du module de paiement Atos/Sips Développé par : Ryu007 et Quadra Team Documentation réalisée par : Marine PASQUIN Quadra Informatique Dernière révision : avril 2010 Version : 1.1
1. Installation du module Atos/Sips La première étape de l'installation consiste à récupérer la clé d'extension ( extension key ) du module disponible à l'adresse suivante : http://www.magentocommerce.com/extension/981/atos-sips-extension/ La seconde étape consiste à installer le module grâce à Magento Connect. Pour accéder à Magento Connect, rendez-vous sur votre back-office et cliquez sur Système > Magento Connect > Magento Connect Manager. Vérifiez ensuite que Magento Connect est configuré sur Beta (onglet Settings). Il ne vous reste plus qu'à insérer la clé d'extension dans le champ de l'onglet principal et de cliquer sur le bouton Install. 2. Intégration des fichiers fournis par votre banque Voici les différents fichiers que votre banque doit normalement vous fournir : request response parmcom.<nomdevotrebanque> parmcom.<votreidcommerçant> certif.fr.<votreidcommerçant> Vous devez placer ces fichiers dans le répertoire lib/atos/ de votre site (vous devez créer le répertoire atos). Pensez également à faire un chmod 755 sur les fichiers request et response.
3. Mise à jour des templates Si vous avez personnalisé votre site en créant un nouveau paquet et/ou un nouveau thème, vous devez copier les fichiers suivants : vers app/design/frontend/<votrepaquet>/<votretheme>/template/payment/form/ app/design/frontend/default/detault/template/payment/form/atos.phtml app/design/frontend/default/detault/template/payment/form/atos_aurore.phtml app/design/frontend/default/detault/template/payment/form/atos_several.phtml vers app/design/frontend/<votrepaquet>/<votretheme>/template/payment/info/ app/design/frontend/default/detault/template/payment/info/atos.phtm app/design/frontend/default/detault/template/payment/info/atos_aurore.phtml app/design/frontend/default/detault/template/payment/info/atos_several.phtml 4. Rafraîchir le cache Pour rafraîchir votre cache, rendez-vous dans Système > Gestion du cache, sélectionnez Rafraîchir dans la liste déroulante. Note : Si votre cache n'est pas activé (aucun bouton n'est coché dans la gestion du cache), vous pouvez passer cette étape.
5. Configuration du module en back-office Pour configurer votre module Atos/Sips, rendez-vous sur Système > Configuration > Modes de paiement > Atos / Sips. 1 2 3 4 5 6 7 8 9
10 11 12 13 14 15 16 17
1 2 3 4 5 6 7 8 9 10 Votre ID marchand vous est donné par votre banque. Si vous avez correctement suivi l'étape 2 d'installation du module, alors il doit apparaître dans la liste déroulante. Il faut indiquer les fichiers à utiliser pour construire les requêtes et les réponses, ce sont les fichiers request et response de l'étape 2 d'installation du module. Pour les serveurs Linux : il faut renseigner le chemin absolu de ces fichiers. Nous conseillions de laisser ce champ vide puisque le module génère un fichier pathfile automatiquement. Pour les experts : si vous le souhaitez vous pouvez gérer votre propre fichier pathfile sur le modèle de celui que votre banque vous fournit. Libellé sous lequel apparaîtra le mode de paiement dans le tunnel de paiement du front-office. Statut de la commande qui apparaîtra dans le back-office lorsque celle-ci est terminée. Statut de la commande après acceptation du paiement par la banque. Statut de la commande après refus du paiement par la banque. Statut de la commande après annulation du paiement par le client. Liste des cartes que votre banque accepte. Il faut la faire correspondre avec le TPEV fournit par votre banque. Indique la méthode à utiliser pour déclencher le paiement. Pour le moment, seul le mode Normal est géré. 11 12 Options de personnalisation de la page de paiement. Pour plus de détails, consultez le fichier Guide de personnalisation des pages.
13 14 15 16 17 Permet de personnaliser l'affichage de la page de la banque. Liste des pays depuis lesquels le client peut payer avec le module. Attention : ce n'est pas la localisation de l'internaute qui est prise en compte mais le pays de provenance de sa carte bancaire. Définit la position de la méthode de paiement Atos/Sips dans la liste des méthodes de paiement affichée dans le tunnel de paiement du front-office. Montant minimum de la commande pour payer avec le module. Montant maximum de la commande pour payer avec le module. 6. Bugs connus Si lorsque vous testez la méthode de paiement Atos/Sips l'erreur suivante se produit : There has been an error processing your request. API ERROR Error reading pathfile (no key word F_DEFAULT) cela signifie que le path pour accéder à vos fichiers request et response est trop long. Le path ne doit pas excéder 75 caractères.