TggAtos, module de paiement opensource pour Prestashop 1.6/1.7 ATOS Sips 2.0 par Wordline (et qui accepte SSL)

Version de test :

Introduction

Les modules officiels de paiements avec contrat VAD ATOS Sips 2.0 de Prestashop et du LCL (Sherlock’s) sont incompatibles avec la protection SSL. En fait, l’adresse de retour permettant la confirmation de la transaction ne peut être appelée. Ainsi, vous ne recevrez ni la confirmation de paiement par mail ni la notification du back-office Prestashop. D’autant que la commande n’est pas créée et il est impossible de réaliser le suivi par Prestashop.

C’est un problème assez grave car le client a bel et bien payé, mais vous n’avez aucun moyen de le savoir dans l’immédiat sinon de vous connecter au logiciel de gestion de votre banque pour consulter les transactions.

Beaucoup de solutions existent mais TroloGeek a créer un module qui est non seulement opensource mais aussi bien plus puissant que les modules officiels ATOS 2.0 et qui permet de forcer l’adresse de retour. Ce module s’appelle TggAtos.

Si vous voulez ajouter la protection HTTPS à votre site boutique, l’implémentation de ce module est une bonne solution (et gratuite). Du moins si votre banque dispose de ATOS 2.0 Sips. Renseignez-vous auprès du service technique de votre banque pour connaître votre version d’ATOS Sips.

Téléchargement de TggAtos

Nous allons reprendre une partie du tutoriel officiel d’installation en y ajoutant au fur et à mesure du temps quelques modifications notamment la modification du logo ou de la page de paiement. Mais surtout de forcer l’adresse de confirmation.

Le GitHub du module : https://github.com/TrogloGeek/prestashop-tggatos-module

• Le répertoire du FTP est <repertoire_ftp>
• Le répertoire du prestashop est <repertoire_prestashop>
• Le répertoire du module est <tggatos>
  (situé dans <repertoire_ftp>/<repertoire_prestashop>/modules/<tggatos>)

Installation de TggAtos

• Décompresser le .zip et renommer le dossier prestashop-tggatos-module-RC_4.1.3 en tggatos
• Placer le répertoire du module dans <repertoire_prestashop>/modules/tggatos
• Remplacer les binaires dans <tggatos>/bin par les binaires de votre banque ou de votre prestataire ATOS Sips. Important, si vous utilisez un logiciel de transfert SFTP, il faut envoyer les fichiers binaire en mode binaire sous peine d’avoir une erreur du type Error when calling request binary, system exit code
• Mettre le fichier certification fourni par votre banque dans le dossier <tggatos>/param/ ce fichier est de la forme certif.<languagee>.<id_marchant>
  • Supprimer les autres fichiers certif.* dans le dossier, ils sont inutiles
• Mettre le fichier pathfile fourni par votre banque dans le dossier <tggatos>/param/
• Régler les permissions :
  • <tggatos>/bin, son contenu, et ses dossiers en mode execution pour l’utilisateur php
    • chmod -R 755 <tggatos>/bin
  • <tggatos>/param et son contenu en mode écriture pour l’utilisateur php
    • chmod -R 770 <tggatos>/param
  • <tggatos>/log en mode écriture pour l’utilisateur php
    • chmod 770 <tggatos>/log
• Installer le module par le back-office de prestashop
• Pour des questions de sécurité, déplacer les dossiers ci dessous à la racine de <repertoire_ftp> si vous y avez accès ou dans un dossier non accessible par le protocole HTTP :
  • <repertoire_ftp>/tggatos/param et aller dans la section BASIC du module dans le back-office et indiquer le nouveau répertoire dans le champs Location of ATOS configuration
  • <repertoire_ftp>/tggatos/log et aller dans la section ADVANCED du module dans le back-office et indiquer le nouveau répertoire dans le champs Responses logs storage path
  • Vérifier que les permissions sont toujours respectées après le déplacement de ces dossiers
• Renseigner votre banque dans la section BASIC, dans le champs Your bank
• Renseigner votre certificat dans la section BASIC, dans le champs Select the production certificate 
• Renseigner votre fuseau horaire dans la section ADVANCED, dans le champs transaction_id time zone
• Pour les utilisateurs de SSL, dans la section ADVANCED, cocher la case Force user return from bank
• Renseigner le nom du fichier du logo que vous avez fourni à votre banque dans la section GRAPHIC, dans le champs Center banner
• Si vous n’avez pas d’autre logo, dans la section GRAPHIC, laisser le champs Upper right logo vide
• Selon votre besoin, choisissez l’un des trois moyens de paiement disponibles :
  • Dans la section SINGLE, cocher la case Enable single payment mode
  • Dans la section 2TIMES, cocher la case Enable 2 times payments mode
  • Dans la section 3TIMES, cocher la case Enable 3 times payments mode
• Si vous pouvez accepter les cartes American Express :
  • Dans le cas du paiement simple, dans la section SINGLE, dans le champs Accepted payment means, remplacer
    CB,1,VISA,1,MASTERCARD,1 par CB,1,VISA,1,MASTERCARD,1,AMEX,1
  • Dans le cas du paiement en deux fois, dans la section 2TIMES, dans le champs Accepted payment means, remplacer
    CB,2,VISA,2,MASTERCARD,2 par CB,2,VISA,2,MASTERCARD,2,AMEX,2
  • Dans le cas du paiement en trois fois, dans la section 3TIMES, dans le champs Accepted payment means remplacer
    CB,3,VISA,3,MASTERCARD,3 par CB,3,VISA,3,MASTERCARD,3,AMEX,3
• Passer le module en mode (Pre-)Production, dans la section BASIC, sélectionner (Pre-)Production: Use your production certificate dans le champs ATOS Run mode

Vous pouvez dés à présent accepter les paiements par Carte Bleue

Si vous rencontrez un problème pendant l’installation, vous pouvez activer le mode debug de Prestashop en mettant la constante _PS_MODE_DEV_ égale à TRUE, en activant le journal d’erreur de PHP et en mettant la constante error_reporting égale à -1 pour avoir plus d’informations

Petites améliorations graphiques de TggAtos

Dans un premier régler les positions des cadres de paiement. Pour ce faire, rendez-vous dans les back-office de prestashop puis modules > positions et rechercher le point d’accroche displayPayment.

Sources

https://github.com/TrogloGeek/prestashop-tggatos-module/blob/RC_4.1.3/README.md

Todo

• Tester et régler CB.1
• Changer les logos
• Changer  la page finale de paiement
• Changer le cadre