Version 3.41 - 10/04/2006. PAYBOX SERVICES « Paiement Sécurisé sur Internet » MANUEL D'INSTALLATION ET PARAMETRAGE ___________________________________________________________________________________________ PAYBOX SERVICES. Centre Espace Sud ­ Route d'Elne - 66200 LATOUR BAS ELNE Version 3.41 Page 1 sur 44 tél : 04.68.85.79.90 -fax : 04.68.85.79.99 SOMMAIRE PRODUIT « PAYBOX SYSTEM » ............................................................................................................................................................3 I - PRESENTATION : ................................................................................................................................................................................ 3 II - LES MODULES DISPONIBLES : .................................................................................................................................................... 5 III - INSTALLATION DU MODULEV2.CGI : .................................................................................................................................. 5 IV - LANCEMENT DU MODULEV2.CGI : ....................................................................................................................................... 6 a - Les différentes variables :...................................................................................................................................................................6 b - Lancement par mode « formulaire HTML » : ...............................................................................................................................9 c - Lancement par mode « fichier local » :..........................................................................................................................................10 d - Lancement par mode « ligne de commande » :............................................................................................................................11 e - Lancement par mode « variables d'environnement » :...............................................................................................................11 f - Lancement par plusieurs modes : ...................................................................................................................................................12 V - LES URLS DE RETOUR ET « L'URL HTTP » :........................................................................................................................ 12 a - Les 3 urls de retour sur le site commerçant :...............................................................................................................................13 b - La validation des bons de commandes avec « l'url http » : .......................................................................................................14 c ­ Valeurs des codes erreurs ...............................................................................................................................................................18 d ­ Remarques sur la signature PAYBOX........................................................................................................................................19 e ­ Interfaçage avec le traitement PAYBOX DIRECT Plus ..........................................................................................................20 VI - LES DIFFERENTES OPTIONS ET PERSONNALISATIONS ............................................................................................ 20 a - Gestion des paiements différés : .....................................................................................................................................................20 b - Gestion de la page intermédiaire : .................................................................................................................................................21 c - Gestion des codes d'erreur : ............................................................................................................................................................23 d - Personnalisation de la page de paiement :....................................................................................................................................26 e - Personnalisation du ticket de paiement : ......................................................................................................................................26 f ­ Test de disponibilité des serveurs de paiement :..........................................................................................................................27 VII ­ LA PAGE DE PRESELECTION DU MOYEN DE PAIEMENT ...................................................................................... 28 a ­ Forçage des type et moyen de paiements : ...................................................................................................................................29 OPTION GESTION DES ABONNEMENTS.....................................................................................................................................31 I - PRESENTATION : .............................................................................................................................................................................. 31 II - PARAMETRAGE :............................................................................................................................................................................. 31 CODES REPONSES DU CENTRE D'AUTORISATION..............................................................................................................36 I - LES CODES REPONSES DU CENTRE D'AUTORISATION : ............................................................................................. 36 a ­ Réseau carte bancaire, American Express et Diners : ...............................................................................................................36 b ­ Réseau Cetelem/Aurore : ................................................................................................................................................................37 c­ TERMINEO (cartes prépayées) : ...................................................................................................................................................37 PARAMETRES DE TESTS .......................................................................................................................................................................38 I ­ PROCEDURE ET PARAMETRES DE TESTS : ......................................................................................................................... 38 LE BACK OFFICE COMMERÇANT ....................................................................................................................................................39 I ­ LE BACK OFFICE COMMERCANT : ......................................................................................................................................... 39 INSCRIPTION AUPRES DE PAYBOX SERVICES........................................................................................................................42 I ­ INSCRIPTION AUPRES DE PAYBOX SERVICES : ............................................................................................................... 42 ASSISTANCE ................................................................................................................................................................................................43 I ­ ASSISTANCE : .................................................................................................................................................................................... 43 GLOSSAIRE ...................................................................................................................................................................................................44 I ­ GLOSSAIRE : ....................................................................................................................................................................................... 44 ___________________________________________________________________________________________ PAYBOX SERVICES. Centre Espace Sud ­ Route d'Elne - 66200 LATOUR BAS ELNE Version 3.41 Page 2 sur 44 tél : 04.68.85.79.90 -fax : 04.68.85.79.99 Produit « Paybox System » I - PRESENTATION : Le produit «Paybox System » est un système sécurisé de gestion des paiements par cartes bancaires et privatives sur les sites marchands Internet. Le produit « Paybox System » s'intègre très facilement dans tous systèmes de galerie marchande. Il suffit d'installer le module CGI et d'y faire appel à partir de la page du site commerçant qui précède la page de paiement Paybox System : rien n'est à installer chez le client qui veut effectuer un paiement. Le module CGI (Common Gateway Interface) est un exécutable permettant de récupérer certaines données (telles que l'identifiant du commerçant, la référence de la commande, le montant de la transaction...). Le module crypte ces données et redirige le client vers la page de paiement Paybox System. Une fois le produit intégré sur le site marchand, le client pourra effectuer son paiement en toute sécurité : sa commande réalisée, il sera redirigé vers le serveur de PAYBOX SERVICES. Ce dernier établit alors une connexion cryptée avec l'acheteur (en SSL 128 bits, pour que la saisie du numéro de carte bancaire soit effectuée en toute sécurité) et affiche une page de paiement. Paybox System vérifie la validité de la carte en effectuant une demande auprès du centre d'autorisation bancaire du commerçant suivant les protocoles CBSA, CB2A version 5.1 et 5.2. ___________________________________________________________________________________________ PAYBOX SERVICES. Centre Espace Sud ­ Route d'Elne - 66200 LATOUR BAS ELNE Version 3.41 Page 3 sur 44 tél : 04.68.85.79.90 -fax : 04.68.85.79.99 Si le paiement est accepté, un ticket est alors affiché sur l'écran de l'acheteur (optionnel). Ce même ticket lui sera renvoyé par courrier électronique (e-mail) comme preuve du paiement. L'acheteur a alors la possibilité de revenir sur le site marchand pour effectuer d'autres achats. Paybox System envoie également par e-mail un double du ticket de paiement au commerce. Il sera possible, pour le commerçant, de gérer de façon automatique, le résultat de la tentative de paiement grâce à « l'url http ». En fin de journée, Paybox System réunit sous forme de « remise » tous les paiements réalisés sur le site, et envoie celle-ci, suivant le protocole CBPR, CB2A version 5.1 et 5.2, au centre de télécollecte bancaire du commerçant afin que les transactions soient traitées. Une fois la télécollecte effectuée, le commerçant recevra un ticket de compte-rendu par e-mail. ___________________________________________________________________________________________ PAYBOX SERVICES. Centre Espace Sud ­ Route d'Elne - 66200 LATOUR BAS ELNE Version 3.41 Page 4 sur 44 tél : 04.68.85.79.90 -fax : 04.68.85.79.99 II - LES MODULES DISPONIBLES : Le module CGI, fourni par PAYBOX SERVICES, est en libre téléchargement sur le site http://www.paybox.com. Le module est disponible pour les systèmes d'exploitation suivants : ? Windows NT, 9x, 2000, XP ? Unix SCO (Intel) ? Sun Solaris ? Linux (Intel) ? Free BSD ? Mac OS X ? Aix (IBM). Nous pouvons également réaliser sur demande un portage vers d'autres systèmes d'exploitation. III - INSTALLATION DU MODULEV2.CGI : Il faut télécharger le module correspondant au système d'exploitation de votre serveur Web (module disponible à partir de notre site www.paybox.com, rubrique « téléchargement »). Ce module doit ensuite être installé sur le répertoire «cgi-bin » de votre serveur Web (ce répertoire peut porter un autre nom). Le module pourra être renommé en « modulev2.cgi ». Par contre, pour des raisons de compatibilité, le module ne devra absolument pas être renommé sous le nom « module.cgi ». Il faudra ensuite y affecter les droits d'exécution : chmod 755. (propriétaire : lecture + écriture + exécution ; groupe : exécution ; autres : exécution). Attention : - il faut vérifier que le transfert FTP a bien été effectué en binaire et non en ascii, car le module est un exécutable. En cas de doute, vous pouvez comparer la taille en octets de votre module installé dans le répertoire cgi-bin avec le module sur le site www.paybox.com (en positionnant la souris sur le logo) : la taille doit être identique. - il faut vérifier que le répertoire cgi-bin est bien paramétré au niveau de votre serveur Web pour permettre l'exécution des scripts exécutables. Par exemple, si le module se met en téléchargement au lieu de s'exécuter, cela sig ...