Paiement SIPS pour Joomla 1.5 et Tienda - Configuration du paiement

Écrit par Valérie Isaksen

Tutoriels - Tienda

Joomla ecommerce avec Tienda

Ce tutoriel a été écrit avec la version Version: 0.5.3 Community r615. Cet extension de Joomla étant relativement récente, il se peut qu'elle est évoluée entre temps.

Tienda est une solution de e-commerce pour Joomla proposé par l'équipe de Dioscouri Design.

La grande différence entre VirtueMart et Tienda, est que cette dernière a été conçue de toutes pièces pour Joomla, dans le respect du framework MVC de Joomla. La conséquence étant que  les templates sont  facilement être modifiables , et surtout il est très simple d'y ajouter de nouvelles fonctionnalités grâce à des plugins.

Paiement Sécurisé SIPS d'ATOS

SIPS est la solution de paiement sécurisé d'ATOS proposée par certaines banques comme :

	HSBC / CCF (Elysnet)
	Crédit agricole (e-transactions )
	Crédit Lyonnais / LCL (Sherlocks)
	Banque Populaire (Cyberplus ) *
	Société Générale (Sogenactif)
	La Poste (Scellius)
	Crédit du Nord (Webaffaires)
	BNP Paribas (Mercanet)

* Depuis septembre 2009, les banques du groupe Banque populaire utilisent nouvelle plate-forme de paiement e-commerce SYSTEMPAY.

Pour chacune de ces banques, la solution proposée est la même. Seul le nom marketing change.

Cette solution de paiement sécurisé fonctionne sur n'importe quel type d'hébergement : mutualisé, dédié ou virtuel.

 

Pré-requis techniques

Le plugin exploite des exécutables fournis par SIPS / Atos permettant de générer des données cryptées. Ces binaires sont fournis pour des noyaux linux 2.4 et 2.6 uniquement. Par ailleurs, la fonction exec() doit être autorisée pour utiliser le module (le safe_mode en particulier doit être désactivé).

Le Kit de Paiement SIPS d'ATOS

Lorsque vous passez un contrat de VAD (vente à distance) avec votre banque, elle vous transmet un kit de paiement NomDeLaSolution_p600_PLUGIN_linux-2.6.9 contenant les fichiers nécessaires à la mise en place du paiement sécurisé et une documentation détaillée expliquant la marche à suivre.
Une fouis dézippée, cette archive contient des répertoires sous la forme de fichiers réparties dans plusieurs répertoires :

• /bin : répertoire contenant les exécutables des CGI du module de paiement
• /logo : répertoire des logos des moyens de paiement
• /param : répertoires des fichiers paramètres
• /sample : répertoire des exemples de scripts shell d'appel des cgi
• /template : outil de validation d'une feuille de style

Cas particulier des kits Windows

Une fois dézippé, le kit de paiement est un fichier .exe (xxx_600_PLUGIN_W2003.EXE). Cliquez sur le fichier à partir de votre PC, une fenêtre d'install-shield s'ouvre, et installe les répertoires / fichiers ci-dessus sur votre ordinateur. Ensuite procéder comme indiqué ci dessous.

Installation et configuration du plugin SIPS avec Joomla 1.5 et Tienda

Transférer les fichiers CGI du kit de paiement sur le serveur

1. Copier les fichiers CGI contenu dans le répertoire /bin du kit du paiement dans le répertoire acceptant les CGI chez votre hébergeur. Généralement ce répertoire se trouve au même niveau que votre répertoire web (Le répertoire web est le repertoire qui contient les fichiers de votre site.  En général il a pour nom : www/ ou htdocs/ ou public_html/.

2. Changer les permissions des fichiers. En génral vous avez accès à cette fonction à partit d'un clic droit de votre souris. Mettez la permission Executer (x) pour les le propriétaire, le groupe, et le public.

Installer des autres fichiers du kit de paiement

Téléchargement du paiement SIPS d'ATOS pour Joomla & Tienda

1. Créer un répertoire  /sips dans  le répertoire /images de Joomla.

2. Transférer le  contenu du répertoire /logo du kit de paiement fourni par votre banque vers le répertoire /images/sips de Joomla.

3. Créer un répertoire /sips-param de préférence hors de votre répertoire web. (pour des

4. Transférer le contenu du répertoire /param du kit de paiement fourni par votre banque vers ce répertoire  /sips-param Sécurité
- Si vous ne pouvez pas créer de repertoire hors de votre site WEB, transférez alors, un fichier index.html vide.
- De même protégez ce répertoire à l'aide d'un fichier  .htaccess contenant la directive deny from all. deny from all interdit à tout le monde l'accès à vos fichiers, mais des scripts peuvent continuer à les utiliser.

Installation du plugin de paiement SIPS d'ATOS pour Tienda

1. A partir du menu Extensions > Installer / Désinstaller et installer le plugin

Configuration de la méthode de paiement

1. Rendez vous dans l’administration des plugins Extensions > Gestion des plugins

2. Dans la liste déroulante sur la droite de la fenetre , sélectionnez les plugin de type Tienda

3. Sélectionner Sips payment

Compléter dans la partie droite, les informations:

Configuration du plugin de paiement

• Nom de la solution de paiement : sélectionnez la bonne solution
• Serveur : vous devez précisez l'étape du processus d'installation du paiement
• Identification boutique: l'identifiant correspond à votre numéro de Siret. Pendant la pahse de test, le numéro de l'identifiant utilisé est celuipendant la phase de test avec le serveur de démonstration inscrivez les numéros de l’extension du fichier. Dans le cas de sherlocks ce fichier est: param/parmcom.014295303911111. L'identifiant est donc: 014295303911111
• Chemin absolu du CGI: le chemin réel du répertoire où vous avez copié les exécutables CGI du kit de paiement. Exemple: /home/monsite/cgi-bin/
• Chemin absolu du fichier pathfile: le chemin réel du répertoire que vous avez nommé /sips et où vous avez copié l'ensemble des fichiers du répertoire param, dont le fichier Pathfile. Exemple: /home/monsite//sips/

Les cartes de paiements

Ensuite, choissisez les cartes que vous autorisez sur votre site

Paramètrage du paiement

• Etat paiement accepté/refusé: ATOS envoie une réponse automatique à votre site indiquant si la transaction a été acceptée ou non. L'état de la commande est mis à jour en fonction des états sélectionné ici. Les états listés sont ceux définis dans Tienda
  

• Remise en banque: choisissez le mode de capture, c’est à dire la méthode d’envoi de vos transactions à votre banque. SI VOUS NE SAVEZ PAS QUOI METTRE , CHOISSISEZ CAPTURE AUTOMATIQUE.
  
  
• Nombre de jours avant envoi: Nombre de jours avant l'envoi en banque de la transaction. (Un nombre entre 0 et 99).
  

Le choix du mode VALIDATION ou AUTHOR_CAPTURE dépend du souhait du commerçant de contrôler ou non l'envoi en banque des transactions.

Tests de paiements

Sur le serveur de test

Lorsque vous êtes sur la page de paiement, vous devez voir apparaitre les logos des cartes bancaires:

 

Si vous avez mal renseigné les paramètres de configuration, un message d'erreur apparait, et une tentative de diagnostic des erreurs possibles. Voici les erreurs les plus fréquentes:

• le chemin du CGI mal renseigné,
• les fichiers request et response ne sont pas en mode executables
• les fichiers request et response ne correspondent pas au noyau Linux de votre hébergement
• le chemin du répertoire contenant le fichier pathfile n'est pas un chemin absolu.

En haut de la page, lorsque vous êtes sur le serveur de démonstration, ou le serveur de production en mode PRE-production, vous verrez le message suivant apparaitre. Ce message n'apparaitra plus lorsque vous êtes en sur le serveur de production en mode production.

Exemple de numéros de cartes pour tester le paiement:

Numéro de carte	Termine par	Résultat
4974934125497800	00	paiement accepté
4972187615205	05	paiement refusé

La date de validité de la carte doit être postérieure à la date du jour. La taille du numéro de carte doit être comprise entre 10 et 19 chiffres.

Tests de paiements sur le serveur de pré-production

Lorsque vos tests sur le serveur de démonstration sont OK demandez à votre banquier de vous fournir votre certificat de production. Vous recevrez votre certificat de production sous forme cryptée, et le mot de passe pour le décrypter par pli sécurisé.
Pour paramétrer votre site en mode pré-production, il faut connaître au préalable le numéro de boutique (il est fourni lors de l'inscription). Il correspond en général au SIRET précédé de 0 (exemple: si le SIRET du commerçant vaut 12345678901234, le numéro de boutique est égal à 012345678901234).

1. Décrypter le certificat de production
2. Renommer le certificat: certif.fr.<numéro de boutique>
3. Copier le certificat de production, qui vous a été transmis, dans le même répertoire que le certificat de démonstration c'est à dire le répertoire /sips,
4. Renommer le fichier des paramètres de la boutique en parmcom.<numéro de boutique>.
5. Dans la configuration de votre méthode de paiement Extensions > Gestion des plugins > Sips payment , rensignez le paramètre  identifiant boutique par votre numéro de boutique.
6. Sélectionnez Serveur de production / PRE-production pour le paramètre serveur

Tester avec une vrai carte bancaire. Votre boutique étant en mode pré-production. Ne vous inquiétez pas, votre compte ne sera pas débité.

Mise en production

Vos tests sont concluants, vous pouvez demander le passage en production.

1. Allez dans  la configuration de votre méthode de paiement Extensions > Gestion des plugins > Sips payment ,
2. Sélectionnez Serveur de production / production pour le paramètre serveur
   

Attention, ne demandez ce passage que lorsque votre boutique est prête et tous vos tests sont finis. Une fois votre boutique en production, les paiements seront débités, et vous ne pouvez plus simuler de paiement.