Mode d'emploi PAYBOX SERVICES

[. . . ] 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 : . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [. . . ] les données renvoyées n'ont pas été altérées, ??c'est bien PAYBOX qui effectue un appel de vos URLs Pour utiliser la signature PAYBOX et vous assurez que les deux prédicats précédents soient vérifiés, vous devez dans l'ordre : 1) Récupérer le contenu de la donnée du type "K", 2) "URL décodée" cette signature, 3) Décodée en base 64 le résultat de l'étape précédente, 4) Décrypter avec la clé publique de PAYBOX le résultat de l'étape précédente, 5) Calculer une empreinte SHA-1 avec les autres données de la variable « PBX_RETOUR », 6) L'empreinte calculée dans l'étape précédente doit être égale au résultat de l'étape 4. Par exemple, voyons ce que donne le contrôle avec le contenu de la variable « PBX_RETOUR » suivant sur l'appel de l'URL http://www. maboutique. com/return/result. php : PBX_RETOUR=montant:M;auto:A;idtrans:S;sign:K Pour un montant de 13, 09 avec une autorisation fournie par la banque "145704" et un numéro de transaction égal à 702587912, l'appel de l'URL sera donc le suivant : http://www. maboutique. com/return/result. php?montant=1309&auto=145704&idtrans=70258 7912&sign=QDFSVV456%02F4354GDGVF%2BGVRtvvzREVertv45reTZRv= En décomposant les six étapes précédentes, on obtient : 1) "URL décodage de la signature". QDFSVV456%02F4354GDGVF%2BGVRtvvzREVertv45reTZRv= devient QDFSVV456/4354GDGVF+GVRtvvzREVertv45reTZRv= 2) Soit "BBBBB" le résultat du décodage en base 64 du résultat de l'étape précédente, 3) Soit "PPPPP" le résultat du décryptage de "BBBBB" avec la clé publique de PAYBOX. ___________________________________________________________________________________________ PAYBOX SERVICES. Centre Espace Sud ­ Route d'Elne - 66200 LATOUR BAS ELNE Version 3. 41 Page 19 sur 44 tél : 04. 68. 85. 79. 90 -fax : 04. 68. 85. 79. 99 4) Calcul d'une empreinte SHA-1 avec les autres données de la variable « PBX_RETOUR ». Dans notre exemple, ce calcul s'effectue sur la chaîne suivante : montant=1309&auto=145704&idtrans=70258 5) Le calcul de l'empreinte précédente doit être égale au résultat de l'étape 3 ("PPPPP"). Il est important de noter que la donnée K de la variable « PBX_RETOUR » doit être toujours être situé en dernière position. PBX_RETOUR=montant:M;auto:A;idtrans:S;sign:K est correcte ??PBX_RETOUR= montant:M;auto:A; sign:K;idtrans:S est incorrecte La clé publique de PAYBOX est en libre téléchargement depuis le site www. paybox. com à la rubrique téléchargements. Pour être en conformité avec les règles de sécurité, PAYBOX est susceptible de changer sa paire de clé publique/privée : vous devrez être en mesure de mettre en place différentes clés publiques au niveau de vos serveurs. e ­ Interfaçage avec le traitement PAYBOX DIRECT Plus La valeur U de la variable "PBX_RETOUR" assure un interfaçage avec le produit PAYBOX DIRECT Plus ([voir page Erreur !Pour cela, vous devez souscrire auparavant auprès de notre service commercial les droits d'utilisation de ce traitement. Les informations retournées sont sous la forme : Partie_Du_Numéro_De_Carte_Cryptée++Date_De_Validité_De_La_Carte++CVV Les trois informations seront séparées par la chaîne "++". La partie du numéro de carte cryptée est "URL encodée" et vous devez l'URL décodée pour l'utiliser avec le traitement PAYBOX DIRECT Plus. VI - L ES DIF F ER EN TES O P TION S E T P ERS ON NA LISA TIO NS a - Gestion des paiements différés : Paybox System peut gérer les paiements différés, c'est à dire garder les transactions un certain nombres de jours avant de les envoyer vers le centre de télécollecte de la banque pour débiter l'acheteur et créditer le commerçant. Cette option peut s'avérer très utile, lorsque le commerçant désire s'assurer que la marchandise ou le service a été livré au client avant que ce dernier soit débité. Sur la fiche d'inscription Paybox System, il vous sera demandé le nombre de jours de différé par défaut (si vous en souhaitez un) : - 1 : le paiement sera envoyé le lendemain, - 2 : le paiement sera envoyé le surlendemain, - etc. . . ___________________________________________________________________________________________ PAYBOX SERVICES. Centre Espace Sud ­ Route d'Elne - 66200 LATOUR BAS ELNE Version 3. 41 Page 20 sur 44 tél : 04. 68. 85. 79. 90 -fax : 04. 68. 85. 79. 99 Il est également possible de gérer les différés de façon dynamique pour chaque paiement. Pour cela il faudra utiliser la « sous-variable » « IBS_DIFF » à la fin de votre référence commande (précisée dans « PBX_CMD ») en lui affectant une valeur variant entre 00 et 99 (sous réserve d'acceptation de la banque). Par exemple, si « PBX_CMD » a comme valeur : mareference123abc pour gérer un différé de 4 jours, il faudra mettre comme valeur : mareference123abcIBS_DIFF04 A noter qu'il est possible de supprimer cette mise en attente à partir du back office commerçant. Par exemple, une transaction réalisée le 1er novembre et différée jusqu'au 4 novembre, peut être débloquée et envoyée le 2 novembre par action manuelle. b - Gestion de la page intermédiaire : L'utilisation des variables «PBX_TXT », « PBX_WAIT », « PBX_BOUTPI » et « PBX_BKGD » permet de gérer la page intermédiaire «Paybox » affichée juste avant la page de paiement « Paybox ». ?« PBX_TXT » : Elle permet d'afficher du texte sur cette page. Il devra être saisie au format HTML. [. . . ] - tickets : Permet de rééditer un ticket de paiement. - Remboursement : Remboursement d'un porteur à partir d'une transaction d'origine. Pour accéder au Back Office, il faut se connecter à l'URL https://admin. paybox. com ou https://admin1. paybox. com (secours). Il faut saisir le login et mot de passe préalablement demandés auprès du service technique de PAYBOX SERVICES. [. . . ]