ATOS est utilisé par les solutions (institutions) suivantes :

1/ E-transactions (Crédit Agricole)
2/ Sogénactif (Société Générale)
3/ CyberPlus (Banque Populaire, sauf BP Lorraine)
4/ Mercanet (BNP)
5/ Scellius (La Poste)

Téléchargement
La contribution pour OSC est téléchargeable sur le site d'oscommerce :
http://www.oscommerce.com/community/contributions,893

La contribution a été testée avec succès pour les versions 2.2 MS1 et MS2.

Installation
Pour installer cette contribution dans votre OSC, vous avez besoin :

1. du kit ATOS (livré par votre correspondant bancaire) pour la plateforme pour laquelle vous souhaiter l'installer. Classiquement le Kit ATOS : 5.0 pour plateforme linux ou 6.0 pour les serveurs récents.
2. La contribution d'ATOS pour OSC (téléchargeable dans l'url précédent).

Ensuite, suivez les instructions dans le fichier INSTALL contenu dans le fichier zip de la contribution (point 2).

Ce qui est utilisé du kit ATOS par la contribution ?

1. les fichiers du répertoire 'logo', a mettre dans 'images/atos' (ce répertoire doit être créé)
2. les fichiers du répertoire 'param', uniquement les fichiers certif.fr.0xxxxx et parmcom.0xxxxx sont à mettre dans le répertoire 'atos' (le fichier parmcom.yyyy où yyyy n'est pas un chiffre ne semble pas obligatoire). Tous les autres fichiers ne sont pas utiles, le pathfile sera généré automatiquement par le module
   
3. les binaires request et response du répertoire 'bin', à mettre dans le répertoire 'atos'. Assurez-vous que les permissions sur ces fichiers soient bien (au moins) à 755: il est important car ce sont des executables et non des fichiers simples

IMPORTANT
Les sessions doivent être mises dans la base de données (SESSION_STORE mis à 'mysql', cf. configure.php).

Assurez vous que les paramètres MERCHANT_COUNTRY et MERCHANT_LANGUAGE existe dans les fichiers parmcom.0xxxx des certificats que vous utiliser (valable pour les versions courantes du module ATOS <= 2.2.3). Pour ajouter la définition de ces paramètres, ajouter les lignes suivantes dans votre fichier parmcom.0xxxxx


Pour tester le module en local
Si vous faites des tests en local avec HTTP_SERVER en localhost, cela ne fonctionnera pas : vous devez remplacer "localhost" par l'adresse IP dynamique de votre machine. Si vous n'avez pas compris, cette section ne s'applique pas à vous.

• Il faut changer ses urls de type 'http://localhost/' par 'http://a.b.c.d/' afin que l'auto response appelle bien son serveur local,

Une fois sur le site de la banque, il suffit de saisir un numero de carte finissant par 00 et de saisir 000 pour les trois chiffres situés au dos de la carte. Si le mode production est activé, la transaction sera acceptée, sans bien sûr débiter votre compte.

Description du fonctionnement ATOS

Les scripts sont appelés comme suit:

1/ Dans checkout_confirmation.php, on choisit une carte pour payer avec et on est renvoyé sur le serveur de la banque,

2/ Une fois le paiement effectué sur le serveur de la banque, le serveur de la banque appele le script checkout_process.php avant d'afficher la page au client comme quoi le paiement a bien été effectué (on est toujours sur le serveur de la banque). Le checkout_process.php correspond à l'url d'auto-réponse,

3/ Le client clique alors sur 'Retour à la Boutique' et dans ce cas, il est directement envoyé sur atos_response.php qui va s'occuper de décoder les données du serveur et de renvoyer le client sur checkout_success.php si tout s'est bien passé,

les fichiers call_* sont inutiles dans le cadre d'OSC.

Pour des problèmes d'installation liés à vos problèmes:

1/ Chercher sur le forum: nombreux problèmes que vous rencontrez ont déjà été résolu par d'autres. Prenez le temps de cherchez,

2/ Si vous ne trouvez pas votre solution, créer une nouvelle question dans ce forum.


POUR LE SUIVI D'UN PROBLEME, METTEZ LES INFORMATIONS SUIVANTES DANS VOTRE POST

Kit ATOS: Version du Kit ATOS + OS
OSC: 2.2MS1 ou 2.2MS2 ou Autre (préciser si pas une version coeur, genre Creload6 ou contributions intégrées)
Solution Bancaire: CyberPlus ou E-Transaction ou Autre
OS: Windows [VERSION] ou Linux ou Autre
Server: local ou autre
Contributions: préciser si vous avez intégré ou non des contributions dans votre architecture.

Pour tenter d'aider les utilisateurs qui ont des difficultés à installer ce module, je me suis permis de faire un peu de nettoyage dans ce sujet pour ne lui garder que l'essentiel indispensable... Pardon et merci aux nombreux contributeurs.

Voici donc un résumé des éléments qui ont pus bloquer certains:

Messages d'erreur du type "une erreur inattendue est arrivée au cours de la demande"
Vérifier et REvérifier que les fichiers sont installés proprement au bon endroit et que les chemins renseignés dans l'admin sont corrects. 'request', 'response' et 'pathfile' doivent être des chemins absolus (le chemin physique sur la machine de type home/user/www/catalog/atos/)
Vérifier la présence du pathfile autogénéré (un fichier 'pathfile.parmcom.yyyyyyy', généré automatiquement par le module doit être présent dans le répertoire 'atos')
Bien mettre le module en mode "production" et non "demo"
Vérifier que le serveur n'est pas en en safe_mode. Il faut avoir le safe_mode sur "off" dans le php.ini. Si il est sur "on" voir ce tuto
Faire attention à la longueur des variables de définition de 'request' et 'response', elles ne doivent pas faire plus 80 caractères.
Vérifiez la version de l'API utilisée. La version doit être compatible avec votre hébergement et le système du serveur (linux, windows...) Le kit ATOS 6 peut poser des problèmes de compatibilité (version de la glibc), dans ce cas, demandez à votre banque une version 5.0.
La version 6 du kit ATOS peut être obligatoire sur des hébergements récents (OVH par exemple).

En cas de problème lors du retour au site (panier non validé)
Attention aux tests de session d'OsC: mettre la "vérification utilisateur" et "vérfication IP" sur FALSE dans l'admin->Configuration->Sessions
Garder les sessions en base de donnée: mettre 'mysql' dans le define SESSIONS du configure.php
Mettre sur FALSE l'utilisation de force des cookies
Laisser sur FALSE "Utiliser URL des moteurs de recherche"
Vérifier l'absence d'htaccess pouvant empêcher le serveur ATOS de se connecter au catalog (si vous avez mis un accès par mot de passe en phase de test)
Vérifier que L'IP autorisé à donner la confirmation d'achat (fourni par votre banque) est bien présent dans la liste de l'admin
Attention aux contributions touchant le checkout_process: Le checkout_process.php correspond à l'url d'auto-réponse. En cas de doutes, faire un test avec un checkout_process non modifié.

ATTENTION depuis la version 2.3, le module ATOS ne propose plus de mode "demo" dans le module, simplifiant la compréhension

Précisions sur les étapes du passage en production

Après avoir terminé l'installation et la mise en production du module de paiement ATOS/SIPS v-2.2.4, j'ai pensé qu'il était utile de fournir quelques précisions:

Dans le paramétrage du module (accessible par l'interface d'administration osC), le module propose un mode Démo et un mode Production.

Le mode Démo permet de tester la bonne implémentation du module, ainsi que la liaison avec le serveur de démo d'ATOS/SIPS. Dans ce mode Démo, il est normal au retour vers la boutique, après validaiton de la pseudo-transaction de démo, que la commande ne soit pas validée et d'avoir un e-mail d'erreur.

Lorsque l'on passe en mode Production dans le paramétrage du module (accessible par l'interface d'administration osC), la validation du panier doit alors s'effectuer correctement au retour du paiement sur le site de démo ATOS/SIPS et l'e-mail de confirmation de la commande doit être expédié, sans les messages d'erreur. Je souligne ici que jusque là, bien qu'étant en "Production" selon les termes employés pour le module ATOS/SIPS dans osCommerce, l'on n'est pas encore en "Production" pour ce qui concerne la plate-forme ATOS/SIPS proprement dite.

L'étape suivante consiste à remplacer dans le répertoire ATOS le certificat de test utilisé jusqu'à présent par le certificat définitif propre au commerçant, ainsi que décrit dans le module et dans la doc ATOS.

Je noterais juste ici un point: il n'y a pas à introduire le numéro du compte commerçant dans le paramétrage du module (accessible par l'interface d'administration osC). En effet, le module récupère tout seul les codes du/des fichiers certif présents dans le répertoire ATOS, que l'on peut ensuite le cas échéant sélectionner si nécessaire dans l'écran du paramétrage du module de paiement.

A partir du moment où une transaction est effectuée avec le certificat du commerçant, le serveur ATOS/SIPS la bascule vers le serveur opérationnel, et non plus le serveur "démo".

Dans le jargon ATOS/SIPS, il s'agit du mode "pré-production". Les transactions nécessitent alors un numéro de carte de crédit réel. Mais elles ne sont ni débitées ni créditées. Cela permet d'effectuer les derniers tests et notamment la personnalisation graphique (ne pas oublier les fichiers logos ou autre à transmettre à ATOS le cas échéant).

Une fois que tout est satisfaisant et que le document nécessaire a été renvoyé à ATOS le cas échéant, ATOS basculera alors le compte du commerçant en mode "production".

A partir de ce moment, les transactions sont réelles et coûtent (et rapportent) des sous...

Voilà; comme le terme "Production" est employé pour des étapes qui ne se recouvrent pas exactement dans le module, d'une part, et chez ATOS/SIPS, d'autre part, j'espère que ce récapitulatif pourra peut-être éviter à d'autres que moi de tourner en rond avant de saisir leurs subtiles différences...

Cela dit, bravo à tous ceux qui ont créé cette contribution, ou qui ont participé aux éclaircissements donnés sur ces forums. C'est un superbe travail!

Nouvelle version du module ATOS 2.3.0

Téléchargeable comme d'habitude

http://www.oscommerce.com/community/contributions,893

Cette version est compatible avec le kit ATOS v6 et pas avec les versions antérieures.

Intégration des modifications pour le kit v6.0
Modification pour le support safe_mode.