Nous venons d’installer ce module sur une de nos boutiques Magento et nous nous sommes rapidement rendus compte qu’il s’agit là d’un des modules bancaires les plus compliqués à installer et à tester, c’est pourquoi un petit tutoriel explicatif sera le bienvenue pour tous.

N.B. : la mise en place de ce module a été effectuée sur une boutique Magento 1.4.0.1, il existe peut-être d’autres erreurs sur d’autres versions et inversement, nous avons peut-être rencontrés des erreurs inexistantes sur d’autres versions.

Installation de l’extension

Première partie, la plus simple, il s’agit de l’installation du module. Rendez vous sur http://www.nom_de_votre_site.com/downloader. Collez la clé suivante : magento-community/Mage_Atos puis cliquez sur « Install ». L’installation doit normalement se dérouler sans embuches.

Récupération des fichiers de banque

Ca se complique. Ici, deux choix s’offrent à vous :

  • soit vous utilisez les fichiers de tests.
  • soit vous utilisez les fichiers fournis par votre banque.

Voici notre conseil : en sachant que lors de la création de votre contrat de vente à distance (VAD), votre interface de paiement est en pré-production, aucun paiement ne sera débité, il est judicieux de commencer à travailler directement avec les fichiers fournis par votre banque afin de ne pas avoir à résoudre deux fois les mêmes problèmes (même si nous espérons que tous vos problèmes se résoudront en lisant ce post). Tant que votre interface de paiement est en pré-production, vous pourrez travailler comme si vous utilisiez les fichiers de test sauf que pour passer en production vous n’aurez presque rien à faire.

Dans les deux cas, il vous faut télécharger le kit bancaire. Dans notre cas, il s’agissait d’un contrat avec Sogenactif, le kit correspondant est disponible ici.

Pour les autres (Mercanet,FIA-NET,Sherlocks), la banque envoie au client directement le kit d’installation.

Dans le kit, vous trouverez :

  • un dossier bin contenant 6 fichiers binaires
  • un dossier logo rempli d’images
  • un dossier param avec les fameux fichiers de tests
  • un dossier sample avec des fichiers PHP et Perl
  • une note de version

De plus, la banque vous envoie normalement une clé de décryptage ainsi qu’un logiciel permettant de générer votre certificat bancaire de production (équivalent au fichier de test certif.fr.014213245611111) .

Attention, le premier problème que nous avons rencontré a été la récupération de ce logiciel. En effet, il s’agit d’un fichier en .exe et la plupart des systèmes de messagerie interdise totalement l’envoi et la réception de ce type de fichier (car 80% des .exe circulant par mails sont des virus). Il vous faut donc fournir à la banque une adresse mail Free, Yahoo ou Hotmail car ce sont les seuls qui permettent encore la réception de ce type de fichier.

Une fois votre fichier certif généré grâce au logiciel et à la clé de décryptage, renommez le en certif.fr.votre_ID_bancaire (identifiant que vous avez du recevoir avec votre clé de décryptage).

Vous avez maintenant tout ce qu’il vous faut pour commencer la configuration de votre interface bancaire.

Transfert des fichiers

Renommez le fichier parmcom.XXXXXXXXX (situé dans le dossier param du kit) en parmcom.votre_ID_bancaire (comme pour le certif.fr) puis éditez-le.

  • Après AUTO_RESPONSE_URL!, rentrez la chaine suivante : http://www.nom_de_votre_site.com/atos/standard/automatic/!
  • Après CANCEL_URL!, rentrez la chaine suivante : http://www.nom_de_votre_site.com/atos/standard/cancel/!
  • Et enfin après RETURN_URL!, rentrez : http://www.nom_de_votre_site.com/atos/standard/normal/!
  • Vous pouvez également remplacer merchant.gif (juste après LOGO!) par l’adresse du logo de votre site qui s’affichera sur l’interface de paiement.

Sauvegardez le tout.

Connectez vous maintenant en FTP à votre site et créez un dossier /lib/atos.

Uploadez maintenant votre fichier certif.fr.votre_ID_bancaire (généré à partir du logiciel et de la clé), votre fichier parmcom.votre_ID_bancaire (que vous venez d’éditer) ainsi que le fichier parmcom.sogenactif (ou parmcom.votre_banque) contenu dans le dossier param du kit de test.

Uploadez ensuite les fichiers request et response contenus dans le dossier bin du kit de test mais attention, étant donné qu’il s’agit de fichiers binaires, il vous faut les transférer en binaire. Exemple : dans FileZilla, cliquez sur Transfert > Type de transfert et choisissez Binaire. N’oubliez pas de remettre la configuration par défaut une fois le transfert terminé.

Configuration

Dans le Back Office de votre boutique, rendez vous dans Système > Configuration > Ventes > Modes de paiement > Atos / Sips.

Activer le mode de paiement, votre identifiant de marchand doit se trouver dans la liste déroulante ID Marchand.

Pour le champ « Binaire pour construire la requête » rentrez le chemin vers le fichier binaire request. Attention il s’agit là du chemin à partir de la racine du serveur, ex : path/lib/atos/request. Si vous ne le connaissez pas, contactez l’administrateur de votre serveur. Faîtes de même pour le fichier response avec le champ suivant.

Laissez vide le champ « Fichier pathfile ». Laissez la configuration normale pour le reste sauf si vous souhaitez changer les état de commandes etc…

Sauvegardez la configuration et normalement votre boutique doit être configurée et prête à accepter des paiements.

Problèmes rencontrés et solutions

Malheureusement après les étapes précédentes, il est très probable que, comme beaucoup d’utilisateurs, vous rencontriez une pléthore d’erreurs.

Voici la liste des principales erreurs et comment les résoudre :

Impossible to execute binary file – Set correct chmod

Vos fichiers binaires request et response n’ont pas les droits suffisants pour être exécutés.

Connectez vous en SSH à votre site, rendez vous dans votre dossier /lib/atos et effectuez les commandes suivantes :

chmod 755 request
chmod 755 response

Boucle infinie sur la page /atos/standard/redirect/

4 possibilités :

  • votre serveur est en 64 bits et il faut qu’il puisse lire les fichiers binaires qui sont 32 bits, il vous faut vous connecter en SSH et exécuter la commande suivante :
    aptitude install ia32-libs
  • vous êtes sous OVH, il vous faut télécharger les fichiers binaires spécial OVH disponibles ici
  • la version de vos fichiers binaires ne correspond pas à votre noyau. Connectez vous en SSH et exécuter la commande :
    uname -r

    Cette commande vous donne la version de votre noyau, il faut ensuite uploadez les fichiers binaires correspondant à cette version (ex: la commande vous donne 2.6.XX, uploadez les fichiers binaires request_2.6.XX et response_2.6.XX) avant des les renommer en response et request.

  • votre serveur n’est pas en 64 bits, vos fichiers binaires correspondent à votre kernel et vous n’êtez pas chez OVH : vérifiez les droits d’exécution qu’ont les utilisateurs de votre serveur et quel utilisateur est propriétaire des fichiers binaires. En effet, nous avons rencontré ce problème et l’utilisateur propriétaire des fichiers binaires n’avait pas les droits d’exécution de fichiers binaires.

Vous n’arrivez pas à accéder au serveur de la banque

L’extension génère normalement un fichier pathfile.votre_identifiant_banquaire dans /lib/atos.

Editez-le et en dessous de « Fichiers des paramètres communs », remplacez le chemin après F_DEFAULT! (ex : /var/www/…) par :

lib/atos/parmcom.sogenactif! (remplacez sogenactif par le nom de votre banque)

Error reading certificate file lors du retour de la banque

L’extension génère un second fichier nommé pathfile.parmcom.votre_identifiant_banquaire dans /lib/atos.

Editez-le et, de la même manière que pour le fichier pathfile.votre_ID, remplacez le chemin après F_DEFAULT! par :

 lib/atos/parmcom.sogenactif!

Ecran jaune « Transaction invalide »

Si vous obtenez cette page, il est fort possible que l’URL se termine en /demo/callpayment. Cela signifie que vous utilisez les fichiers de test et pas les fichiers de production, rendez-vous à la partie « Récupération des fichiers » en haut de ce post pour résoudre le problème.

Les notifications de la banque n’arrivent pas

Plusieurs solutions :

  • soit les URL indiquées dans le fichier parmcom.votre_ID sont incorrectes.
  • soit un .htaccess empêche la banque d’accéder à votre boutique.

Conclusion

Normalement, vous devriez maintenant pouvoir effectuer des paiements de test avec vos certificats de production en utilisant le module Atos.

Une fois vos tests terminés, il vous suffit d’envoyer votre PV de recette à votre banque afin qu’il passe votre interface de paiement en production.

En espérant que cet article vous aidera dans la mise en place du module Atos sous Magento.