PAYBOX SERVICES
Contents
1. PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELN E Version 3 41 Page 8 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Temps d attente en secondes pour v rifier la disponibilit du serveur de secours tertiaire de Paybox 1 3 PBX_TIMEOUT3 chiffres facultatif Valeur par d faut 20 Temps d attente en secondes pour v rifier la disponibilit du serveur de secours quaternaire de Paybox 1 3 chiffres PBX_TIMEOUT4 facultatif Valeur par d faut 20 b Lancement par mode formulaire HTML Ce mode consiste cr er un formulaire HTML qui appellera le module avec les champs sp cifi s en param tre correspondant aux variables n cessaires La variable PBX MODE devra avoir comme valeur 1 Certaines Variables telles que PBX TOTAL PBX PORTEUR ou PBX_ CMD devront tre g r es de fa on dynamique car ces valeurs changent chaque paiement Voici titre d exemple un formulaire permettant l affichage de la page de paiement lt FORM ACTION cgi bin module 2 cgi METHOD post gt lt INPUT TYPE hidden NAME PBX_ MODE VALUE 1 gt lt l passage par formulaire gt lt NPUT TYPE hidden NAME PBX_SITE VALUE 1999888 gt lt NPUT TYPE hidden NAME PBX_ RANG VALUE 99 gt lt NPUT TYPE hidden NAME PBX_ IDENTIFIANT VALUE 2 gt lt NPUT TYPE hidden NAME PBX_ TOTAL VALUE 1500 gt lt NPUT TYPE hidden NAME PBX_DEVISE V2. 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 13096auto 145704 amp idtrans 7 0258 79128 amp sign QDFSV 456 02F4354GDGVF 2BGV RtvvzREVertv45reTZRv En d composant les six tapes pr c dentes on obtient 1 URL d codage de la signature QDFSVV456 02F4354GDGVF 2BGV RtvvzREVertv45reT ZRv devient QDFSVV456 4354GDGVF GVRIVVZREVertv45reT ZRv 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 LA TOUR 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 effetue sur la cha ne suivante montant 1309 amp auto 145704 amp idtrans 70258 5 Lecalcul del 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 dela variable
3. PBX_TYPEPAIEMENT Moyen de paiement utiliser voir page 28 Se jusqu 32 PBX_TYPECARTE Type de carte utiliser voir page 28 La transaction sera Uniquement en mode autorisation c est dire qu elle ne sera pas envoy e votre banque au moment de la t l collecte O Autorisation seule Pas de t l collecte de la transaction Pour capturer la transaction l envoyer votre banque au moment de la t l collecte vous devez utiliser les traitements PAYBOX Traitement Par Lot voir page Erreur Signet non d fini ou PAYBOX Direct voir pages Erreur Signet non d fini ou Erreur Signet non d fini PBX_AUTOSEULE 1 caract re facultatif gt 2 10 N par d faut Autorisation capture T l collecte dela transaction M thode utilis e GET ou POST pour l appel de l url http PBX_RUF1 Directs voir pege 4 facultatif gt 2 00 Valeur par d faut GET Temps d attente en secondes pour v rifier la disponibilit du PBX TIMEOUT serveur de paiement primaire de Paybox l 3 facultatif gt 2 11 _ chiffres Valeur par d faut 8 Temps d attente en secondes pour v rifier la disponibilit du PBX_TIMEOUT1 serveur de secours primaire de Paybox Ge facultatif gt 2 11 gt chiffres Valeur par d faut 10 Temps d attente en secondes pour v rifier la disponibilit du PBX_TIMEOUT2 serveur de secours secondaire de Paybox 1a3 facultatif gt 2 11 chiffres Valeur par d faut 20
4. voir page 10 facultatif gt 2 00 Texte pouvant tre affich sur la page interm diaire la place porte PBX_TXT du texte par d faut voir page 21 non limit facultatif gt 2 00 D lai d affichage dela page interm diaire La valeur est en jusqu 5 PBASWAIT milli secondes voir page 21 chiffres facultatif 2 00 Intitul du bouton dela page interm diaire nul pour la jusqu 50 8 PDA BOUTA suppression de ce bouton voir page 21 caract res facultatif gt 2 00 Fond d cran dela page interm diaire nom de couleur code jusqu 150 FRRBROD couleur ou image voir page 21 caract res facultatif gt 2 00 M ode de gestion de la page interm diaire Les valeurs possibles S PBX_OUTPUT sont A B C D et E voir page 211 1 caract re facultatif gt 2 00 Langue utilis e par Paybox pour l affichage dela page de paiement Par d faut la page est en fran ais Les valeurs 3 PBX_LANGUE possibles sont FRA Fran ais GBR Anglais ESP Espagnol adaa facultatif gt 2 00 ITA Italien DEU Allemand NLD Hollandais et SWE Su dois URL de votre site permettant d afficher la description des A RA PBX_ERREUR ventuelles erreurs pouvant survenir l affichage de la page de Jysqu a 19 facultatif gt 2 00 paiement voir page 23 ARTS URL du serveur de paiement primaire de Paybox si diff rente jusqu 150 PBX_PAYBOX de celle par d faut carac res facultatif gt 2 00 https
5. La foire aux questions est galement disponible sur le site www paybox com Pour tout contact aupr s de nos services il vous faudra IMPERATIVEMENT vous munir de vos IDENTIFIANTS Paybox savoir votre num ro de SITE 7 chiffres num ro de RANG 2 chiffres et num ro d identification PAYBOX 1 9 chiffres PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 43 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Glossaire GLOSSAIRE CGI Le CGI Common Gateway Interface est un standard d finissant les r gles qui permettent un programme informatique d interagir avec un serveur Web URL Les URL Uniform Resource Locators sont les adresses de ressources sur Internet Une ressource peut tre un serveur http un fichier sur votre disque une image Par exemple http www maboutique com site bienvenue html HTTP HTTP HyperText Transport Protocol est un protocole utilis pour transf rer des documents hypertextes ou hyperm dias entre un serveur Web et un dient Web SSL Le protocole SSL Secure Sockets Layer permet la transmission s curis e de formulaires dans le Web et peut donc servir des transactions financi res en ligne n cessitant l utilisation d une carte de cr dit FTP le FTP File Transfer Protocol est un protocole de transfert de fichiers permettant de t l charger des donn es choisies par l internaute d un ordin
6. PBX RETOUR doit tre toujours tre situ en derni re position Par exemple 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 PAY BOX DIRECT Plus La valeur U de la variable PBX_ RETOUR assure un interfa age avec le produit PAYBOX DIRECT Plus voir page Erreur Signet non d fini 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 LES DIFFERENTES OPTION SET PERSON NALISATIONS 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
7. effectu visuel invalide acc s refus ou site rang identifiant 16 abonn d j existant inscription nouvel abonn incorrect Valeur U dela variable PBX RETOUR date defin de validit incorrecte bin de carte non autoris e Pour le cas d un paiement refus par le centre d autorisation code erreur 001xx les xx repr sentent le code renvoy par le centre Ce code permet de conna tre la raison exacte du rejet dela transaction Par exemple pour une transaction refus e pour raison provision insuffisante le code erreur renvoy sera 00151 Tous les codes sont pr cis s en page 36 de ce manuel d Remarques sur la signature PAY BOX En utilisant la signature PA Y BOX dans les variables retourner vers vos URLs vous pouvez VOUS assurer que 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 dela 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 PA Y BOX le r sultat de l tape pr c dente 5 Calculer une empreinte SHA 1 avec les autres donn es dela variable PBX_ RETOUR 6 L empreinte calcul e dans l tape pr c dente doit tre gale au r sultat de l tape 4
8. la page de directe vers l la page de directe vers le la page de directe vers le la page de directe vers l la page de directe vers l la page de directe vers l PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE t l 04 68 85 79 90 fax 04 68 85 79 99 Version 3 41 Page 29 sur 44 SYMPASS DINERS SYMPASS JCB SYMPASS AURORE PAYNOVA PAYNOVA TERMINEO TERMINEO PAYPAL PAYPAL Pas d affichage de pr s lection redirection page de paiement Pas d affichage de pr s lection redirection page de paiement Pas d affichage de pr s lection redirection page de paiement Pas d affichage de pr s lection redirection page de paiement Pas d affichage de pr s lection redirection page de paiement Pas d affichage de pr s lection redirection page de paiement la page de directe vers l la page de directe vers l la page de directe vers le la page de directe vers l la page de directe vers l la page de directe vers l PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE t l 04 68 85 79 90 fax 04 68 85 79 99 Version 3 41 Page 30 sur 44 Option Gestion des Abonnements PRESENTATION La gestion des paiements par abonnement permet au commer ant de g rer des pr l vements p riodiques ou des paiements en plusieurs fois pour ses dients Ainsi une fois le paiement initial effectu le cli
9. 90 fax 04 68 85 79 99 wi d A lt e Ae den 8 e ATTENTION CECI N EST PAS UN VRAI PAIEMENT IL N Y A PAS EU DE VRAIE AUTORISATION CARTE BANCAIRE le 13 12 2004 16 19 Site de test 1999888 223333444 0301 d Paiement r alis avec succ s 86 099 200279392 Merci de votre confiance M DEBIT Ceci est une image du ticket lectronique AUTO XXXXKX qui vous sera envoy par E mail 4 Retour commerce MONTANT 10 00 EUR POUR INFORMATION 65 60 FRF 1 EUR 6 533957 FRF SAISIE MANUELLE TICKET A CONSERVER Si ces urls ne sont pas g r es dynamiquement via les variables PBX_ les adresses utilis es seront alors celles qui ont t enregistr es dans notre base de donn es Attention II est fortement d conseill d utiliser la variable PBX_EFFECTUE pour valider vos bons de commandes cette variable n est pas s curis e par Paybox et n est pas garantie comme tant lanc e syst matiquement En effet un acheteur qui a r alis son paiement peut ne pas vouloir revenir sur le site ou couper sa connexion En cas de pr sence du caract re dans l URL appeler il faut remplacer ce caract re par 3B Par exemple si l URL PBX_EFFECTUE est du type www commerce fr effectue jsp id _session 134ERF47 il faudra documenter la variable PBX_EFFECTUE dela mani re suivante www commerce fr effectue j sp 3Bid_session 134ERF47 Cette restriction est due la ges
10. 99 Ce mode ne garantit pas une s curit optimale contre les manipulations d un utilisateur mal intentionn En effet il peut tr s bien capturer votre page HTML sur son ordinateur en modifier quelques valeurs comme le montant ou votre num ro de commer ant puis re ex cuter la page avec ces nouvelles valeurs Pour viter ce type d attaque il est donc fortement pr f rable d utiliser en m me temps un autre mode pour prot ger l acc s des variables sensi bles c Lancement par mode fichier local Ce mode permet de g rer les variables via un fichier local de type texte Ainsi l appel du module il faut pr ciser comme valeur pour PBX_ MODE lechiffre3 Bien entendu tant donn que la variable PBX MODE ne peut tre mise dans le fichier lire l utilisation du fichier local doit tre combin e avec un autre mode par formulaire HTML mode 1 ou par ligne de commande mode 4 par exemple Ainsi PBX_ MODE n aura jamais 3 comme unique valeur mais 13 ou 43 attention l ordre est important 31 ou 34 g n rera une erreur Il faudra ensuite utiliser la variable PBX_OPT pour indiquer le chemin d acc s et nom du fichier Ce chemin devra tre sp cifi dans la syntaxe accept e par le syst me d exploitation du serveur Par exemple PBX_OPT C mon sita paybox fichier txt pour Windows PBX_OPT usr mon site paybox fichier txt pour Unix Si PBX O
11. Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 36 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 N 3 7 _ o EA _ 12 28 ER 2g identifiant del organisme acqu reur inconnu date de validit de la carte d pass e suspicion de fraude serveur inaccessible positionn par le serveur incident domaineinitiateur b R seau Ceteleny Aurore d autorisation d autorisation Co Transaction approuv e ou wait s avec succ s _ 09 _ Incompatibilit carter commer ant J R f rence de l op ration non renseign e lees j c TERMINEO cartes pr pay es d autorisation d autorisation Ce Transaction approuv e ou trait e avec succ s Slogan _ n ss E o _ seveur d autorisation indisponible 42 Montant de la transaction trop important pour EASYCODES PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELN E Version 3 41 Page 37 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Param tres de tests PROCEDURE ET PARA METRES DE TESTS Quelque soit le produit utilis Paybox System PPPS Traitement par Lot option Abonnement il est possible d effectuer des tests via une boutique Paybox pr vue cet effet Ainsi les identifiants param trer sont le num ro de site et le num ro de rang SITE 1999888 RANG 99 IDENTIFIANT PAYBOX 2 Il est galement possible d effectuer des
12. de passe valide PBX_RETOUR Donn es retourner inconnues PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELN E Version 3 41 Page 25 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 d Personnalisation de la page de paiement II faut nous envoyer les images logos banques le fond d cran les polices et les boutons valider annuler et retour boutique l adresse support paybox com Les boutons valider annuler et retour boutique doivent obligatoirement tre envoy s au format gif dans toutes les langues que vous souhaitez fran ais anglais allemand espagnol italien Ils seront g r s par PAYBOX SERVICES Les autres images pourront tre au format gif ou jpeg e Personnalisation du ticket de paiement Il est possible de personnaliser le mail du ticket de paiement envoy au dient Pour cela il suffit de nous envoyer un fichier HTML par mail support paybox com contenant du texte et ou une image les liens vers un site ou les images cons quentes sont viter Nous aurons besoin de votre num ro de site votre num ro de rang et votre identifiant PBX_ SITE PBX_RANG et PBX IDENTIFIANT Il vous faudra galement pr ciser si vous souhaitez une insertion en d but ou en fin de mail PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 26 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99
13. de supprimer ou de modifier l intitul du bouton paybox Il faudra ainsi donner comme valeur pour cette variable le nouvel intitul du bouton par exemple paiement Pour la suppression de ce bouton la valeur sera nul PBX_BKGD Elle permet de changer le fond d cran de la page interm diaire afin qu il corresponde par exemple celui utilis sur votre site marchand Vous pouvez sp cifier Un nom de couleur standard red black yellow un code couleur hexad cimal 55DA5 par exemple un nom de fichier gif ou jpg Les variables PBX_WAIT et PBX_TXT ne sont pas utilisables si vous utilisez PBX_ OUTPUT avec une valeur gale B C ou D Il en est de m me pour PBX BOUTPI except pour le mode B o son utilisation est accept e Si vous souhaitez le passage le plus discret possible de cette page interm diaire page invisible il vous faudra alors mettre PBX_ WAIT 0 PBX_TXT sans aucun texte voire des espaces PBX_BOUTPI nul PBX_BKGD une couleur correspondante la derni re page de votre site ou cale dela page de paiement Paybox PBX_OUTPUT Elle permet de g rer la derni re page du site marchand avant le syst me de paiement Elle n est pas obligatoire et peut avoir 5 valeurs diff rentes A B C D ou E Si cette variable n est pas utilis e ou poss de une valeur erron e le mode E sera c
14. 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 dient 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 LA TOUR BAS ELN E 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 dela banque Par exemple si PBX_CMD a comme valeur mareference123abc pour g rer un diff r de 4 jours il faudra mettre comme valeur mareference123abclBS 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 1 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 v
15. email du client f Test de disponibilit des serveurs de paiement La documentation de la variable PBX PING permet d effectuer uniquement un test de disponibilit d un serveur de paiement de PAY BOX SERVICES L utilisation de cette fonctionnalit peut tre utile afin de s assurer de la disponibilit des serveurs pour le traitement Paybox System avant que l internaute ne remplisse son panier par exemple Pour cela il faut documenter cette variable avec la valeur 1 et notre programme modulev2 cgi devra tre utilis en mode ligne de commande Ce dernier renverra 1 en cas de non disponibilit de serveurs et O en cas de succ s Par ailleurs une sortie est g n r e vers la sortie standard en indiquant le serveur utilisable PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 27 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 La tentative de connexion vers nos serveurs s effectuera suivant le port TCP 443 correspondant celui par d faut dela variable PBX_PORT En utilisant cette fonctionnalit les variables obligatoires doivent tre document es galement et les variables PBX PAYBOX et PBX_ BACKUPXx seront prises en compte pour la recherche d un serveur disponible VII LA PAGE DE PRESELECTION DU MOYEN DE PAIEMENT Une page de pr s ection des type et moyen de paiement s affichera avant la page de paiement uniquement si vous tes ins
16. essais de paiement avec un num ro de carte bancaire test Num ro de carte 1111222233334444 Date de fin de validit 0308 mars 2008 par exemple CVV ou cryptogramme visuel 123 Une fois votre inscription r alis e vous pourrez pr ciser votre propre num ro de site et de rang Attention La boutique de test PAYBOX SERVICES n effectue aucune demande aupr s d un centre d autorisation ni aucun envoi aupr s d un centre de t l collecte Une simple v rification sur la validit dela carte de cr dit d terminera si le paiement est accept ou refus Le num ro d autorisation retourn sera donc toujours XXXXXX si ces v rifications basiques sont correctes PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 38 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Le Back Office commer ant LE BACK OFFICE COMMERCANT Tout commer ant abonn au service Paybox System PPPS ou Traitement par Lot peut acc der au tableau de bord de son TPE virtuel Ce tableau de bord appel Back Office Commer ant est un ensemble de pages prot g es sur le site Web de PAYBOX SERVICES Elles permettent au commer ant via diff rents onglets d effectuer les op rations suivantes mon compte Visualisation des informations et autres param tres du commerce journal Visualisation impression des paiements effectu s sur les 2 derniers mois statisti
17. gt Votre programme commercant cgi ex cute son tour les commandes suivantes exemple pour Unix indiquer au e modulev2 cgi queles param tres sont en variables d environnement PBX_MODE 2 autres variables PBX_SITE 1999888 PBX_RANG 99 PBX_IDENTIFIANT 2 PBX_TOTA L 1500 exportation des variables d environnement et appel du modulev2 cgi export PBX_M ODE PBX_SITE PBX_RA NG PBX_IDENTIFIANT PBX_TOTAL modulev2 cgi f Lancement par plusieurs modes Il est possible d utiliser plusieurs modes pour appeler le modulev2 cgi Ainsi la variable PBX MODE peut contenir jusqu 4 chiffres parmi 1 2 3 et 4 Dans ce cas le modulev2 cgi cherchera les variables selon les modes sp cifi s et dans l ordre sp cifi Cela permet par exemple de d finir des valeurs par d faut dans un fichier ou en m moire Si PBX MODE 1234 alors modulev2 cgi recherche d abord les variables dans les champs HTML puis rechercheles variables manquantes en environnement local puis recherche les variables manquantes dans le fichier puis recherche les variables manquantes sur la ligne de commande PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 12 sur 45 t l 04 68 85 79 90 fax 04 68 85 79 99 V LESURLSDE RETOUR ET L URL HTTP Une fois le paiement r alis sur la page de paiement Paybox le client a
18. puis pr parer la ligne de commande correspondante et ex cuter appeler le modulev2 cgi e Lancement par mode variables d environnement Ce mode repr sente une technique fortement li e au syst me d exploitation du serveur et au logiciel de gestion du site Elle utilise les variables d environnement et requiert un acc s plus PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 11 sur 45 t l 04 68 85 79 90 fax 04 68 85 79 99 d taill au serveur du commer ant ainsi que le d veloppement de scripts ou de programmes particuliers dela part du responsable du site commer ant Ces variables sont lisibles par n importe quel programme utilisant la fonction standard C getenv Vous pouvez alors envisager de pr parer certains param tres n cessaires au modulev2 cgi comme autant de variables d environnement qui seront invisibles depuis le navigateur du dient Par exemple plut t que d appeler le modulev2 cgi depuis un formulaire HTML il vous sera possible d appeler votre programme CGI commercant cgi en Perl en C ou autre L4G sp cifique au logiciel utilis qui lui conna t le montant de l achat Votre programme cr era alors la variable d environnement PBX_ TOTAL puis appellera le modulev2 cgi lt FORM ACTION cgi bin commercant cgi METHOD post gt lt N PUT TYPE submit NAME bouton paiement VALUE paiement gt lt FORM
19. ques Consultation de statisti ques et tentatives de paiement Ce menu indique galement le motif du rejet dela transaction annulations avant envoi dela transaction au centre de t l collecte Annulation totale d un paiement Annulation partielle d un paiement modification du montant la baisse Annulation d un cr dit attentes M ise en recouvrement d un paiement diff r envoi du paiement au centre de t l collecte de la banque avant la date d ch ance pr vue initialement t l collecte Lancement d une t l collecte en manuel avant l heure pr vue cpt rendu Visualisation des comptes rendus de t l collecte Saisie R alisation d un paiement via une saisie manuelle cr dit R alisation d un cr dit abonnements Gestion des abonnements r siliation des abonnements en cours liste des abonnements finis PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 39 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 oppostions Mise en opposition de cartes bancaires ou privatives Pour les op rations de saisie manuelle ou de cr dit le commer ant devra disposer du num ro de carte du dient ip autoris es Gestion de vos adresses IP chappant la v rification comportementale tickets Permet de r diter un ticket de paiement Remboursement Remboursement d un porteur partir d une transaction d origin
20. tpeweb paybox com cgi M Y choix_pagepaiement cgi Type de navigateur internet 3 5 PBX_SOURCE ardora facultatif gt 2 00 HTML valeur par d faut PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELN E Version 3 41 Page 7 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 WAP cr ation d une page de paiement au format WML IMODE cr ation d une page de paiement au format IHTML URL du serveur de paiement de secours primaire de Paybox si jusqu 150 PBX_BACKUP1 diff rente de celle par d faut d facultatif gt 2 00 https tpewebl paybox com cgi MYchoix pagepaiement cgi i URL du serveur de paiement de secours secondaire de Paybox jusqu 150 PBX_BACKUP2 si diff rente de celle par d faut caradi res facultatif gt 2 00 https tpeweb2 paybox com cgi MY choix pagepaiement cgi URL du serveur de paiement de secours tertiaire de Paybox si jusqu 150 PBX_BACKUP3 diff rente de celle par d faut caract res facultatif gt 2 00 https tpeweb3 paybox com cgi MY choix pagepaiement cgi e jusqu 150 PBX_BACKUP4 URL du serveur de paiement de secours quaternaire Demande de tests de disponibilit d au moins un serveur de p PBX PING paiement PA Y BOX voir page 27 SES Port TCP utilis dans le cadre de la v rification dela PBX PORT disponibilit d un serveur de paiement voir page 27 l 5 facultatif gt 2 00 _ chiffres Valeur par d faut 443 E jusqu 32
21. 04 68 85 79 99 Produit Paybox System 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 I 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 0 0 dB X e 2 4 a Paiement S curis par Carte Bancaire Paiement de 10 00 EUR LA BOUTIQUE DE TEST u A t a Ee ES CEE EL pets Dien Souris 553 Paybox System v rifie la validit de la carte en effectuant
22. A Y BOX v2004 R123abcd R456defg PAYBOX r pond l exp diteur du mail par un mail du type Subject reponse resiliation PA Y BOX v2004 Erreur 0000000501 Resilie 000001203 Erreur en cas de probl me sur la r siliation d un abonnement et R sili pour le succ s de l op ration r siliation de l abonnement version ant ri eure novembre 2004 Les r siliations peuvent tre r alis es via le Back Office voir page 39 ou par mail envoyer l adresse abonne paybox com avec comme objet PBX_SITE PBX_RANG voir page 42 et comme contenu du mail la r f rence d abonnement pr cis e dans le mail ticket de paiement ou dans le back office ou votre r f rence commande pr cis e dans la variable PBX_CM D pr c d par la lettre R Exemple pour le site de test PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LATOUR BAS ELNE Version 3 41 Page 34 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 To abonne paybox com Subject 1999888 99 PAYBOX c IBS 1999 0000000501 0000012003 ou To abonne paybox com Subject 1999888 99 PAYBOX c IBS 1999 R123abcd R456defg PAY BOX r pond l exp diteur du mail par un mail du type Subject reponse resiliation PAYBOX c IBS 1999 Erreur 0000000501 Resilie 000001203 Erreur en cas de probl me sur la r siliation d un abonnement et R sili pour le succ s de l op ration r siliation de l a
23. ALUE 978 gt lt NPUT TYPE hidden NAME PBX_ CMD VALUE ma reference 123456 gt lt NPUT TYPE hidden NAME PBX_PORTEUR VALUE client test com gt lt NPUT TYPE hidden NAME PBX_RETOUR VALUE montant M ref R auto A trans T gt lt NPUT TYPE hidden NAME PBX_EFFECTUE VALUE http www commercefr merci html gt lt NPUT TYPE hidden NAME PBX_REFUSE VALUE http www commercefr regret html gt lt NPUT TYPE hidden NAME PBX_ANNULE VALUE http www commercefr regret html gt lt NPUT TYPE submit NAME bouton_ paiement VALUE paiement gt lt FORM gt Le client devra cliquer sur le bouton nomm paiement pour lancer la page de paiement L identification du commer ant site 1999888 rang 99 et identifiant 2 correspond la boutique de test Paybox Le paiement sera de 1500 centimes d euros soit 15 et l identification du paiement par rapport la commande du commer ant sera la r f rence ma reference 123456 Une fois le paiement effectu si ce dernier est accept la page http www commerce fr merci html s affichera et un ticket de paiement sera envoy par mail au commer ant ainsi qu au client client test com Si le paiement est refus ou annul la page http www commerce fr regret html sera appel e Attention PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 9 sur 45 t l 04 68 85 79 90 fax 04 68 85 79
24. ERVICES des param tres utiles au service Paybox AU pr alable vous devrez contacter votre banque habituelle pour demander l ouverture d un contrat de VAD VPC sur votre compte bancaire normal Les modalit s du contrat VAD VPC varient selon les banques Votre banque vous remettra alors un num ro de SITE 7 chiffres et un num ro de RANG 2 ou 3 chiffres ces num ros vous serviront d identification aupr s de PAYBOX SERVICES Les informations pr ciser sur la fiche d inscription sont les coordonn es du commer ant les coordonn es de l h bergeur ou interm diaire si le commerce ne g re pas directement son serveur les informations mon tiques remplir avec la banque les informations propres la personnalisation du site commer ant Si vous souhaitez accepter des paiements dans un monnaie autre que l Euro vous devez le pr ciser lors de l ouverture du contrat VAD VPC aupr s de votre banque PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 42 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Assistance ASSISTANCE Pour tout renseignement ou assistance l installation nos services commercial et technique restent votre disposition service commercial mail contact paybox com t l phone 01 61 37 05 70 fax 01 61 38 16 56 service technique mail support paybox com t l phone 04 68 85 79 90 fax 04 68 85 79 90
25. Format ent te ticket transaction CARTE BANCAIRE Date et heure locale de la le 25 05 2001 17 11 d tail du contenu d un transaction ticket de paiement Nom de votre soci t et adresse PAYBOX Exemple d un ticket de paiement i 66 PERPIGNAN sommaire Ref commande bc 01 veuillez rappeler ces XXXXXXXXXXXXX il faut supprimer les 6 premiers et le r f rences aupr s du site N de carte du client dernier num ro commer ant Date d expiration dela carte 0310 CARTE BANCAIRE N du fichier de transaction REPONSES inutile pour vous n dela 82 99 104377 machine rang n dela Te transaction num trans 1999888 M saisie manuelle type M DEBIT d op ration autoris Moste zT Num ro d autorisation d une AUTO XXXXXX transaction 00 99 104377 M DEBIT Montant de la transaction MONTANT 12 50EUR AUTO 987654 POUR INFORMATION Montant dela transaction en 81 99 FRF contre valeur LEUR 6 55957 FRF POUR INFORMATION Mode delecture du num ro SAISIE MANUELLE 81 99 FRF porteur 1 EUR 6 55957 FRF SAISIE MANUELLE Format pied ticket transaction TICKET A CONSERVER TICKET A CONSERVER MONTANT 12 50 EUR Email client contact paybox com Remarques Le dient ainsi que le commer ant re oivent un ticket de paiement l identique d un terminal de paiement classique avec en d but de ticket les 50 premiers caract res de la r f rence commande En pied de ticket commer ant se trouve galement l
26. ING Impossible de joindrehttp www commerce fr pour le paiement ref abc12 amp trans 712568 amp auto 30258 amp tarif 20008 abonnement 354341 amp pays F R A amp erreur 00000 XXX YYY Le premier nombre de l information entre parenth ses correspond au code retour du protocole HTTP Voir RFC 2616 seul les codes retour commen ant par un 2 sont consid r s comme valides Le second nombre entre parenth ses correspond au code retour dela librairie libcurl assurant les changes avec votre serveur WEB Codes erreurs du protocole HTTP Le premier chiffre du code de statut d finit la classe de r ponse Les deux derniers chiffres n ont pas de r le de cat gorisation II y a 5 valeurs pour le premier chiffre 1xx Information Requ te re ue traitement en cours 2xx Succ s La demande a t re ue avec succ s re ue comprise et accept e 3xx Redirection 4xx Erreur de Client La demande contient une mauvaise syntaxe ou ne peut pas tre accomplie 5xx Erreur de serveur Le serveur a chou accomplir une demande apparemment valable Codes erreurs dela librairie libcurl 1 Protocole non support 2 Echec durant la phase d initialisation 2 3 URL mal format e PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 15 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 4 URL mal format e 5 R solution du proxy imp
27. PT ne contient pas le chemin d acc s au fichier complet ou relatif le modulev2 cgi estimera que le fichier se situe dans le r pertoire courant o ce dernier est appel Si PBX_OPT n existe pas ou est vide le modulev2 cgi recherchera le fichier pbxinfos txt dans le r pertoire courant Ce r pertoire peut tre celui o est appel le fichier ou celui o est install le module cgi cela varie suivant le syst me d exploitation r f rence au Path Ce fichier contiendra les variables suivant un format sp cifique chaque ligne doit contenir une et une seule variable suivie du signe et de la valeur souhait e Chaque ligne est termin e par un retour chariot cr If ou If Les lignes vides ou commen ant par le symbole sont ignor es vous avez donc la possibilit si vous le souhaitez de rajouter des commentaires Voici titre d exemple l utilisation d un fichier local travers un formulaire HTML permettant l affichage dela page de paiement lt FORM ACTION cgi bin module 2 cgi METHOD post gt lt NPUT TYPE hidden NAME PBX MODE VALUE 13 gt lt NPUT TYPE hidden NAME PBX_OPT VALUE zs CH mon ste paybox fichier txt gt PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 10 sur 45 t l 04 68 85 79 90 fax 04 68 85 79 99 lt NPUT TYPE submitNAME bouton_paiement VALUE paiement gt lt FORM gt Contenu du fichier local
28. Version 3 41 10 04 2006 PAYBOX SERVICES Paiement S curis sur Internet MANUEL D INSTALLATION ET PARAMETRAGE lt gt D YBO SERVICES 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 PRODUIT PAYBOX SYSTEM Sci cai cesverivsetss saves G 6446606004606664 64 sisii ioi sTo r cev Rs 3 l PRESENTATION 220 a bE e nl Aere 3 IN ELESMODULESDISPONIBLES7 geesde 5 II INSTALLATION DU MODULEV2 CGI een 5 IV LANCEMENT DU MODULENZCGI 1021000022002100 1000000000200020000000000ne 6 a Les diff rentes Variables ae te EEN ee en er 6 b Lancement par mode TormulaireHTMler ie 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 LESURLS DE RETOUR ET L URL HTTP eee 12 a Les 3 urls deretour 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 lasignaturePAY BOX nn nn nn ne ne NN een 19 e Interfa age avec le traitement PAY BOX DIRECT blue 20 VI LES DIFFERENTES OPTIONS ET BERGONNALUIGATIONS een 20 a Gestion des paiements diff r s se 20 b Gestion de l a page iht rm di alre issmusanon de une ee Se ee een AS 21 ca Gestion dee
29. ainsi pour cette page choisir le fond d cran le texte la police d criture Ce mode reprend le m me proc d que le mode B mais supprime le bouton Paybox et la balise lt Form gt Cela vous permet de modifier le nom du bouton paiement la place par exemple ou de l enlever Ce mode a pour but de n afficher que la variable PBX DATA Ainsi dans la derni re page de votre site il vous faudra g rer le bouton si Vous en souhaitez un et appeler la page de paiement avec PBX_ DATA qui vous et donn e PBX RETOUR et les autres variables non obligatoires La gestion de ce mode engendre le d veloppement d un script de la part du commer ant permettant la r cup ration dela variable et la g n ration de la page c Gestion des codes d erreur En cas de probl me d ex cution ou de passage de mauvais param tres le modulev2 cgi affiche un message d erreur du type PAYBOX IN PUT ERROR code XX XX est une valeur n gative pr cisant l erreur rencontr e Si vous souhaitez g rer la description de ces erreurs repr sent es par Paybox sous forme de num ro vous avez la possibilit d utiliser la variable PBX_ERREUR Elle contiendra votre url qui sera appel e la place de la page contenant le texte PAY BOX INPUT ERROR code xx Paybox rajoutera une variable nomm e NUMERR la suite de votre url elle aura pour valeur le code xx afin que votre script puisse identifier le t
30. ariables 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 Elle permet d afficher du texte sur cette page Il devra tre saisie au format HTML Vous aurez ainsi la possibilit de rajouter des balises pour les retours la ligne de mettre en gras ou en italique Par exemple si PBX_TXT a comme valeur lt center gt lt b gt Vous allez tre envoy vers la page de paiement s curis Paybox lt b gt lt br gt Suite votre paiement vous recevrez un mail contenant le ticket de paiement pour votre achat lt br gt lt gt Nous vous remercions de bien vouloir patienter quelques secondes lt i gt xbr gt lt center gt vous obtiendrez Vous allez tre envoy vers la page de pai ement s curis Paybox Suite votre paiement vous recevrez un mail contenant le ticket de paiement pour votre achat N ous vous remercions de bien vouloir patienter quelques secondes PBX_WAIT Elle permet de g rer le d lai d affichage de la page interm diaire La valeur est en milli secondes si vous souhaitez afficher la page 10 secondes avant de passer sur la page de paiement automatiquement vous choisirez donc PBX_WAIT 10000 PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELN E Version 3 41 Page 21 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 PBX_BOUTPI Elle permet
31. asse pas par son navigateur Pour identifier et conna tre le r sultat du paiement lors de l appel de cette url il faut utiliser la variable PBX_RETOUR Elle d crit les 13 donn es que Paybox peut renvoyer en param tres la suite de votre url __leMontant dela transaction pr cis dans PBX TOTAL votre R f rence commande pr cis e dans PBX_ CMD __unidentifiant de Transaction num ro d appel s quentiel PA Y BOX SERVICES le num ro d Autorisation num ro remis par le centre d autorisation le num ro d aBonnement num ro remis par PAY BOX SERVICES __letype de Paiement retenu carte PAYNOVA SYMPASS letype de Carte retenu CB VISA EUROCARD MASTERCARD AMEX lenum ro delatranSaction identifiant unique de la transaction lecodepaYs dela banque mettrice de la carte norme ISO 4217 code alphab tique _lecode rreur dela transaction voir page 18 Datedefin de validit dela carte du porteur Format M MAA fonctionnalit disponible en juin 2006 Gestion des abonnements avec le traitement PA Y BOX Direct PIUS voir page 20 K Signature sur les variables de PBX RETOUR voir page 19 Ainsi il vous faudra pr ciser les valeurs souhait es dans cette variable de la mani re suivante PBX_RETOUR montantM maref R jauto A trans T abonnementB paiementP carte C idtransS paysY erreur validite D PPPS U sign K Vous pouvez changer selon vot
32. ateur un autre selon le mod le dient serveur HTML L HTML Hyper Text Markup Language est un langage de balisage de texte qui permet la cr ation de documents hypertextes affichables par le navigateur Web IP L IP Internet Protocol est l adresse unique d un ordinateur connect sur le World Wide Web PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 44 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99
33. bonnementet l URL http En cas d utilisation de l URL http cette derni re sera galement appel e pour chacune des transactions r silier La variable ETAT_PBX sera ajout e l URL d appel avec comme information PBX_RESILIATION_ABT Par exemple http www commercefr traite php ETAT_PBX PBX_RESILIA TION _A BT amp M t 1200 amp Trans 12345678 amp Ref M aReference amp N umA bonnement 56789 Il est noter qu il n y a pas d mission dela part de PAY BOX System d un email vers le porteur lors dela r siliation d un abonnement par le commer ant PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 35 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Codes r ponses du centre d autorisati on LES CODES REPONSES DU CENTRE D AUTORISATION A chaque traitement d une transaction par le centre d autorisation ce dernier renvoie un code r ponse en tant que motif de refus a R seau carte bancaire American Express et Diners Les diff rents codes r ponses lors du traitement de la carte bancaire ne sont pas tous retourn s certains tant internes au centre d autorisation signification coder ponsedu centre signification coder ponse du centre code code d autorisation d autorisation transaction approuv e ou trait e avec succ s 38 nombre d essais code confidentiel d pass Q w D lt O 8 4 conserver la carte provision insuffisante
34. 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 signifie que le r pertoire cgi bin est mal param tr En cas d utilisation du serveur WEB de la soci t Microsoft IIS il faut renommer le programme modulev2 cgi en modulev2 ee lors de l installation de celui ci PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 5 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Les ports TCP autoriser au niveau de votre architecture sont 80 http 443 HTTPS et 53 DNS Une fois install le module doit pouvoir s ex cuter directement travers l adresse Internet sur votre navigateur par exemple http www mabouti que com cgi bin modulev2 cgi A l ex cution vous devriez avoir un message du type paybox input error code 7 ou paybox input error code 3 cela signifie que le module s est bien ex cut l erreur tant seulement d l absence des variables r f rencer Pour tout type d erreur du style internal server error impossible d af
35. crits aupr s de PAYBOX SERVICES pour plusieurs moyens de paiement carte PAYN OVA SYMPASS ou plusieurs cartes privatives Celle ci se pr sente dela fa on suivante D PAYOOX Micresstt Internet Explore chier Edition Akten Fonte G t 6 L O H D A eienger E Le JE A ron M tpu Mtparebe pates ordea Vhon pagspatarent lt y gt w secs D 39 dsd 7 des crier La Boutique du net Mortan 36 89 ELR Em Ki Canmasicn drecie et curie La portau dle Paynova panet da payer sur k Not aussi bian des patas Some que des sommes mpotantes cans murd digue son num ro de carte bancane an eye Hun S lectionnez b carte uimge z aa Ge CS 077 EECH Si am DS lt es Dons z pay coon papous La carta Pr pay e TERMINEO wxi ums certa plastique despondike ba verte daris piusmurts miima panta de vente 15 J0 t D Eune Simple d utlisation et asonyma ale wua p rmat de rigar tous vos achata an toute s curit er avor phis Termineo gt PREPAYE PAYBOX SERVICESS WWW PAYROX COM P EI tarea iront En fonction du choix de l internaute la page de paiement sera affich e diff remment suivant sa s lection Par exemple il ne sera pas demand de saisie d un cryptogramme visuel pour la carte Diners mais il en sera demand une pour la carte A merican Express Par contre si vous n avez pas souscrits aupr s de PAY BOX SERVICES d option l internaute ne verra jamais s afficher cette
36. de refus d autorisation et ou erreur d un pr l vement carte arriv e expiration le commer ant sera averti par mail de cette erreur au moment de la reconduction de l abonnement En cas d utilisation de l URL http cette derni re sera galement appel e aussi bien en cas de reconduction r ussie qu chou e La variable ETAT _PBX sera ajout e l URL d appel avec comme information PBX_RECONDUCTION_ABT Par exemple http www commercefr traite php ETAT_PBX PBX_RECONDUCTION_ABT amp Mt 12008 amp Tr ans 12345678 amp Ref M aReference amp A utori sation 987654 amp N umA bonnement 56789 r siliation de l abonnement version post rieure novembre 2004 Les r siliations peuvent tre r alis es via le Back Office voir page 67 ou par mail envoyer l adresse abonnev2 paybox com avec comme objet PBX_SITE PBX_RANG PBX_ IDENTIFIANT voir page 42 et comme contenu du mail la r f rence d abonnement pr cis e dans le mail ticket de paiement ou dans le back office ou votre r f rence commande pr cis e dans la variable PBX_CM D pr c d par la lettre R PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELN E Version 3 41 Page 33 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Exemple pour le site de test To abonnev2 paybox com Subject 1999888 99 2 PA Y BOX v2004 0000000501 0000012003 ou To abonnev2 paybox com Subject 1999888 99 2 P
37. e 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 Il est possible de visualiser le Back Office dela boutique de test PA Y BOX SERVICES avec Login 199988899 Mot de passe 1999888 i majuscule PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 40 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 iy H gt RH gt H H H gt H H A gt H H R gt H H R gt H H z gt R gt z gt H H z gt H H gt H H R gt H 3 z gt H H gt H R PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELN E Version 3 41 Page 41 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Inscription aupr s de PA Y BOX Services INSCRIPTION AUPRES DE PAYBOX SERVICES Pour s abonner au service Paybox vous devez contacter le Service Commercial de PAYBOX SERVICES au 01L 61 37 05 70 ou prendre contact avec nous via le formulaire pr sent en rubrique contact l URL www paybox com ou bien envoyer un e mail contact paybox com Il vous sera envoy un contrat d finissant les aspects commerciaux prix d installation et d abonnement accompagn d un formulaire fiche d inscription pour l enregistrement par PAYBOX S
38. e XXXXXX signifie qu il s agit d une transaction de tests pour laquelle il n y a pas eu de demande d autorisation aupr s dela banque du commer ant Attention L url http est appel quelque soit le r sultat du paiement accept ou refus d o l importance de v rifier l existence du num ro d autorisation Ce num ro est remis par le centre d autorisation de votre banque son format est du type alpha num rique et de taille variable Afin d ajouter un niveau de s curit suppl mentaire Pour les appels http direct et les retours d url de confirmation vers le site marchand les adresses IP des serveurs de paiement Paybox sont les suivantes 195 101 99 76 195 101 99 77 62 39 109 166 et 194 50 38 6 Vous pouvez donc v rifiez la provenance des r ponses faites depuis PA Y BOX c Valeurs des codes erreurs Les codes r ponse renvoy s par la variable PBX_ RETOUR correspondent au r sultat de la requ te trait e par Paybox Services code Signification code Signification paiement refus par le centre d autorisation voir page 36 00010 devise inconnue en cas d autorisation dela transaction par le centre d autorisation de la banque le code erreur 00100 sera en fait remplac PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 18 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 num ro de porteur ou cryptogramme 00015 paiement d j
39. ement aura lieu le 31 novembre car la prise en compte de l abonnement est imm diate via IBS DELAIS qui est inexistante 10 pr l vements IBS_N BPAIE d un montant de 5 50 euros IBS_2M ONT seront r alis s tous les 3 mois BG FREQ le dernier jour du mois IBS QUAND Tableau d exemples de date de reconduction arana O 7220 gt gt 731208 H 2208 1 20 O M2 B JH Im 1 27112003 3 2 03122003 27 112003 2 29 112008 27 112003 30 2 30112003 27 112003 A 8 04012004 27 11 2003 6l 8 06122008 PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELN E Version 3 41 Page 32 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 27 11 2003 03 01 2004 27 11 2003 30 11 2003 21 11 2003 3 4 03 02 2004 27112003 6 40 06 01 2004 21 11 2003 10 4 10 01 2004 27112003j 0 0 06 01 2004 Lorsqu un abonnement est effectu un mail ticket de paiement est envoy au commer ant et au client avec une mention pr cisant le montant et la date un prochain pr l vement mention pr cis e sur le mail envoy au dient Prochain pr l vement le xx xx xxxx d un montant de xx xx Eur pour toute r clamation adressez vous votre commer ant mention pr cis e sur le mail envoy au commer ant Prochain pr l vement le xx xx xxxx d un montant de xx xx Eur Pour touter siliation de cet abonnement veuillez rappeler la r f rence PAY BOX xxxxxxx Attention En cas
40. ent sera pr lev de fa on cyclique suivant une fr quence choisie pr alablement par le commer ant La gestion de l abonnement sur Paybox System est une gestion de base elle ne pr voit que des cas simples d abonnements bas s sur la reconduction mensuelle de paiement d une m me somme sur une p riode souhait e initialement par le commer ant Ces param tres ne peuvent pas par la suite tre modifi s Malgr sa simplicit le syst me offre une souplesse de param trage permettant notamment avec la gestion des diff r s un large ventail de d clenchement dela premi re reconduction de l abonnement Pour g rer cette option uniquement disponible pour le produit Paybox System il faudra en faire la demande aupr s de notre service commercial et technique et de modifier le contenu de la variable PBX_ CMD comme expliqu ci dessous Il PARAMETRAGE La gestion de l abonnement s effectue via diff rentes sous variables devant tre ins r es la fin de votre r f rence commande pr cis e dans la variable PBX CMD La taille des variables doit tre respect e et le nom de celles ci est fixe et en majuscule montant des prochains pr l vements en centimes 0 montant identique au f l BS_2M ONT paiement initial pr cis dans PBX_TOTAL 10chiffres IBS NBPAIE nombrede pr l vements 0 toujours 2 chiffres IBS FREQ fr quence des pr l vements en mois 2 chiffres jour du mois auquel le pr l
41. ersion 3 41 Page 6 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 PBX_TOTAL M ontant total de l achat en centimes sans virgule ni point Es EN obligatoire Code monnaie dela transaction suivant la norme ISO 4217 code num rique PBX_DEVISE Par exemple 3 chiffres f obligatoire gt 2 00 978 pour l euro 840 pour le dollar US 952 pour le CFA PBX_CMD Votrer f rence commande 1 250 obligatoire caract res A dresse email de l acheteur porteur de carte 6 80 PBX_PORTEUR EE obligatoire gt 2 00 Les caract res et doivent tre pr sents Variables renvoy es par Paybox montant r f rence commande 3 150 PBX_RETOUR num ro de transaction num ro d abonnement et num ro obligatoire gt 2 00 caract res d autorisation voir page 14 PBX_IDENTIFIANT Identifiant PAYBOX fourni par PAYBOX SERVICES au moment 1 9 obligatoire gt 2 00 de votreinscription chiffres Page de retour de Paybox vers votre site apr s paiement accept jusqu 150 PBX_EFFECTUE voir page 131 EE facultatif gt 2 00 Page de retour de Paybox vers votre site apr s paiement refus jusqu 150 PBX_REFUSE voir page 131 do facultatif gt 2 00 Page de retour de Paybox vers votre site apr s paiement annul jusqu 150 gt PBX_ANNULE voir page 131 radare facultatif gt 2 00 Nom du fichier local quand la variable PBX_MODE est jusqu 150 REX ORT document e avec la valeur 3
42. ficher la page erreur 404 not found bug in dynamic linker le fichier sp cifi est introuvable CGIWrap Error Script Execution Failed et autres il vous faut v rifier tous les points pr c dents IV LANCEMENT DU MODULEV2 CGI Une fois le module install il vous faut l ex cuter partir dela page de votre site qui pr c de la page de paiement Paybox System Le lancement du module devra tre accompagn de diff rentes variables l ex cution pouvant tre effectu e sous diff rents modes Il n y a aucune restriction sur le langage utilis pour l appel de ce module vous pouvez sans souci utiliser l HTML l ASP le PHP le PERL a Les diff rentes variables Pour pouvoir assurer un paiement sur le serveur PAYBOX le modulev2 cgi a besoin de r cup rer les informations n cessaires la r alisation du paiement et la gestion des liens entre l acheteur le commer ant et le site PA YBOX SERVICES Ces donn es sont stock es dans les variables suivantes dont le nom est fixe et en majuscule version nom variable description taille type du module Mode de r cup ration des informations de 1 4 chiffres parmi 1 4 f FREMQRE les valeurs 1 2 3 ou 4 chiffres OO ES PBX_SITE Num ro de site TPE donn par la banque voir page 421 PEN RANG ne de rang machine donn par la banque voir page PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE V
43. fichier txt identifiant de mon site PBX_SITE 1999888 PBX_RANG 99 PBX_IDENTIFIANT 2 PBX_TOTAL 1500 PBX_DEVISE 978 PBX_CMD ma reference 123456 PBX_PORTEUR client test com PBX_RETOUR montant M ref R auto A trans T url deretour PBX_EFFECTUE http www commerce fr merci html PBX_REFUSE http www commerce fr regret html PBX_ANNULE http www commerce fr regret html Etant donn que les variables telles que PBX_TOTAL PBX_CMD ou PBX_PORTEUR ont des valeurs diff rentes pour chaque paiement si vous souhaitez les inclure dans le fichier local il sera n cessaire de cr er un fichier pour chaque tentative de paiement Attention en PHP il faudra utiliser la fonction shell_exec plut t que exec pour l appel du modulev2 cgi d Lancement par mode ligne de commande Ce mode permet d utiliser le modulev2 cgi comme un programme normal non CGI appel lui m me par un programme CGI Les param tres devront tre sp cifi s sur la ligne de commande comme les arguments du programme et la variable PBX_MODE devra contenir le chiffre 4 module2 cgi PBX_M ODE 4 PBX_SITE 1999888 PBX_RANG 99PBX_IDENTIFIANT 2 PBX_TOTAL 1500 Ce syst me requiert l utilisation d un programme CGI interm diaire fourni ou d velopp par le responsable du site commer ant Ce programme devra r cup rer par ses propres moyens les informations n cessaires au modulev2 cgi
44. hoisi par d faut Ce mode permet de cr er la page interm diaire Paybox par d faut savoir le texte connexion en cours sur le serveur de paiement s curis et le bouton Paybox il faudra cliquer dessus pour passer la page de paiement L appel du modulev2 cgi se fera depuis la derni re page de votre site Ce mode permet galement d afficher la page interm diaire Paybox par d faut comme le mode A La seule diff rence est que l appa de la page de paiement se fait automatiquement il est inutile de cliquer sur le bouton Paybox PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 22 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Ce mode permet de g rer votre propre page interm diaire L appel du module devra se faire dans l avant derni re page de votre site Le module g n rera uniquement une partie de la page interm diaire Paybox savoir le formulaire lt orm name Paybox A ction https tpeweb paybox com cgi MY pagepaiement cgi Method Post gt lt NPUT TYPE hidden NAME PBX DATA VALUE VA4OITE C9Q9CAN gt AN PUT TYPE idden NAME BX_ LANGUE VALUE FRA gt lt NPUT TYPE SUBMIT VALUE PAYBOX gt lt Form gt Ainsi lors de la cr ation de la derni re page de votre site Vous aurez dans le source ce formulaire permettant d appeler la page de paiement avec les variables PBX DATA et les autres Variables Vous pourrez
45. ien vouloir revenir sur notre formulaire pour la resaisir SI Termin ei Poste de travail Voici la liste des erreurs et leur signification signification erreur de lecture des param tres via stdin m thode POST erreur r ception http erreur d allocation m moire Pas assez de m moire disponible sur le serveur commerce erreur de lecture des param tres QUERY_STRING ou CONTENT LENGTH erreur http PBX_RETOUR PBX_ANNULE PBX_REFUSE ou PBX_EFFECTUE sont trop longs lt 150 caract res erreur ouverture de fichier si PBX_M ODE contient 3 fichier local inexistant non trouv ou erreur d acc s erreur de format du fichier si PBX_MODE contient 3 fichier local mal form vide ou ligne mal format e II manque une variable obligatoire PBX_SITE PBX_RANG PBX_ IDENTIFIANT PBX TOTAL PBX CMD a une des variables num riques contient un caract re non num rique site rang identifiant montant devise PBX_SITE contient un num ro de site qui ne fait pas exactement 7 caract res PBX_RAN G contient un num ro de rang qui ne fait pas exactement 2 caract res PBX_TOTAL fait plus de 10 ou moins de 3 caract res num ri ques PBX_LANGUE ou PBX_DEVISE contient un code que ne fait pas exactement 3 caract res PBX_CMD est vide ou contient une r f rence dont la longueur d passe 250 caract res Non utilis Non utilis PBX_PORTEUR ne contient pas une adresse email valide PBX_CLE ne contient pas une cl mot
46. la possibilit de revenir sur le site commer ant par l interm diaire de 3 urls Le commer ant pourra g rer de fa on automatique la validation de ses bons de commandes suivant le r sultat dela transaction par l interm diaire d une 4 me url nomm e url http a Les 3 urls de retour sur le site commer ant Le retour de Paybox System vers le site marchand peut se faire sur 3 adresses urls diff rentes selon si le paiement est accept refus ou annul Ces 3 urls peuvent tre enregistr es par d faut dans la base de donn es Paybox elles sont alors pr ciser dans la fiche d inscription remise par le commer ant Elles peuvent galement tre g r es de fa on dynamique par le commer ant en utilisant les 3 variables suivantes PBX_EFFECTUE PBX_REFUSE PBX_ANNULE Ces urls sont appel es d s que le dient clique sur le bouton retour boutique de la page r capitulative du paiement phase d affichage du ticket de paiement ou de la page indiquant que la transaction n a pas t autoris e Vous avez la possibilit de choisir un retour imm diat vous pouvez pr ciser cette option dans la fiche d inscription ou aupr s de notre support technique Dans ce cas l le ticket r capitulatif n est pas affich et le client est redirig directement versle site du commer ant PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 13 sur 45 t l 04 68 85 79
47. le d errelin ees 23 d Personnalisation dela page de paiement 26 Personnalisation du ticket de paiement eebe gieren EP de ee 26 f Test de disponibilit des serveurs de paiement 27 VII LA PAGE DE PRESELECTION DU MOYEN DE PAIEMENT 28 a For age des typeet moyen de paiements 29 OPTION GESTION DES ABONNEMENTS nu rerrrnrnerrnnrnenennnenernenenenennnnnenennnnenennse 31 Le PRESENTATION ee EE SE EE ea Ee 31 I SRARAMETRAGE mn nent en C NOA nn TEN Ded eee d 31 CODES REPONSES DU CENTRE D AUTORISATION rennes 36 LES CODES REPONSES DU CENTRE D AUTORISATION nee 36 a R seau carte bancaire A merican Express et Diners 36 b R S C XA EE 37 T RMIINEO Cartes pr pay Eelere Anere Ehe 37 PARAMETRES DE TESTS tee ANESEC ANE 38 PROCEDURE ET PARAMETRES DE TEST 38 LE BACK OFFICE COMMER ANT ee ecccc ccecccccccrcccsoe000cocec00000000000000000000000e000000000000000e000000000000000000000000000000000000000000000000000000000000000e 39 LE BACK OFFICE COMMERCANT een 39 INSCRIPTION AUPRES DE PAYBOX SERVICES essesccoresosssesseececoccoossoessseceecocoessosssseceecceoessosssseseeeecoesoosssssessceecesoosssssssseesees 42 INSCRIPTION AUPRES DE PAY BOX SERVICES 42 ASSISTANCE EE 43 LEASSISTANGES TS in er A PR EE 43 GLOSSAIRE gedreet 44 l E GLOSSA RE EE 44 PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 2 sur 44 t l 04 68 85 79 90 fax
48. ossible 6 R solution du host impossible 7 Connexion impossible avec le host 22 HTTP Page non atteinte 3 HTTP M thode post en erreur 35 connexion SSL en erreur error 42 Callback annul e 43 Erreur interne 44 Erreur interne 45 Erreur d interface 47 Trop deredirection 51 Certificat SSL distant incorrecte The remote peer s SSL certificate wasn t ok 52 Leserveur r pond rien 2 53 Moteur de cryptographie SSL non trouv 27 54 Probl me d initialisation du moteur de cryptographie SSL 2 55 Envoie de donn es en erreur 2 56 R ception de donn es en erreur 57 Erreur interne 58 Probl me avec le certificat local 2 59 Impossible d utiliser le chiffrement SSL indiqu Cette url n a aucun lien direct avec les trois autres elle est g r de fa on compl tement ind pendante et peut tre appel e sur les ports TCP 80 443 HTTPS 8080 8081 8082 8083 8084 ou 8085 PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 16 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Page paiement _ Page ticket Annuler Valider e URL HTTP directe IB5_ANNULE 1BS_ RETOUR IB5_RETOUR Page erreur si auto Ok alors Ges Num ro Autorisation renseign Cavar Geier IBS_EFFECTUE 3 essais l DG RETOUR IBS_REFUSE DG RETOUR Le client ne voit pas l appel de l url http elle ne p
49. ou cr dit d pass ne pas honorer date de validit dela carte d pass e 7 conserver la carte conditions sp ciales 5 codeconfidentiel erron 5 CH LD On m cr 2 transaction invalide ransaction non permise ce porteur 3 montantinvalide ransaction interdite au terminal num ro de porteur invalide 9 suspicion de fraude metteur de carte inconnu approuver apr s identification du porteur carte absente du fichier l accepteur de carte doit contacter l acqu reur KA annulation client d passe la limite du montant de retrait WwW 9 r p ter la transaction ult rieurement r ponse erron e erreur dans le domaine r ponse non parvenue ou re ue trop tard serveur 24 mise jour defichier non support e 5 nombred essais code confidentiel d pass 5 impossible delocaliser l enregistrement dans le 76 porteur d j en opposition ancien fichier enregistrement conserv enregistrement dupliqu ancien enregistrement z 4 eg piq eg arr t momentan du syst me remplac erreur en edit sur champ de mise jour 7 Ra p J 91 metteur de cartes inaccessible fichier 7 6 N O OO O1 U1 Un UUIUI A P J Aje cr r gles de s curit non respect es 2 2 2 je Q 28 acc s interdit au fichier 4 emande dupliqu e 9 mise jour defichier impossible auvais fonctionnement du syst me 30 o h ance de la temporisation de surveillance lobale PAYBOX SERVICES
50. page et il sera redirig directement vers la page de paiement PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELN E Version 3 41 Page 28 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 a For age des type et moyen de paiements Vous pouvez directement partir des variables PBX TYPEPAIEMENT amp PBX_ TYPECARTE privil gi s un type de paiement ou de carte par rapport un autre Le tableau suivant indique la r action de la page de pr s lection en fonction des informations que vous fournissez ces deux variables Pour les types de carte CB VISA EUROCARD_MASTERCARD et E_CARD le comportement de la page de pr selection est identique PBX_TYPEPAIEMENT PBX_TYPECARTE CARTE EK Page de pr s lection CARTE DR Choix du type de cartes CB Pas d affichage de pr s lection redirection d affichage de eu e redirection page de paiement Pas d affichage de pr s lection redirection page de paiement Pas d affichage de pr s lection redirection page de paiement Pas d affichage de pr s lection redirection page de paiement Pas d affichage de pr s lection redirection page de paiement SYMPASS C Choixdutypedecartes CB SYMPASS SYMPASS AMEX Pas d affichage de pr s lection redirection as d affichage de GE redirection page de paiement la page de directe vers l la page de directe vers l
51. r X25 ee Pp SMTP Mail PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 4 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Il LES MODULES DISPONIBLES Le module CGI fourni par PAYBOX SERVICES est en libre t l chargement sur le site http Wwww paybox com Le module est disponible pour les syst mes d exploitation suivants Windows NT 9x 2000 XP x Unix SCO Intel Sun Solaris Linux Intel Free BSD Mac OS X x Aix IBM Nous pouvons galement r aliser sur demande un portage vers d autres syst mes d exploitation I INSTALLATION DU MODULEV2CGl 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 II 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
52. re choix le nom des variables montant maref auto trans abonnement paiement carte idtrans pays erreur validite PPPSet sgn A l appel des urls de PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELN E Version 3 41 Page 17 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 retour PBX_EFFECTUE PBX_REFUSE PBX_ANNULE et l url http directe ces variables seront concat n es la fin des urls Si par exemple votre url http et votre variable PBX_RETOUR sont http www commercefr cgi verif_pmt asp PBX_RETOUR ref RitransT auto A tarif M abonnements pays Y erreur E A l appel des urls de retour PBX_EFFECTUE PBX_REFUSE PBX ANNULE et l url http directe ces Variables seront concat n es la fin de la mani re suivante http www commercefr cgi verif_pmt asp ref abc12 amp trans 71256 amp auto 30258 amp tarif 2000 amp abonnement 354 341 amp pays FRA amp erreur 00000 Il vous faudra alors v rifier imp rativement le num ro d autorisation si ce num ro existe dans l exemple pr c dent il est gale 30258 cela signifie que le paiement est accept Pour le cas d un paiement refus ce num ro est inexistant exemple ci dessous Vous pouvez galement utiliser pour cela la variableE http www commercefr COU verif_pmt asp ref abc12 amp trans 71256 amp tarif 20008 amp pays FRA amp erreur 00105 Par ailleurs un num ro d autorisation compos d
53. tion dela balise META HTTP EQUIV pour Internet Explorer b Lavalidation des bons de commandes avec l url http Cette url est enregistr e dans notre base de donn es elle ne peut donc tre g r e dynamiquement comme les 3 urls pr c dentes L avantage de cette url est qu elle est appel e de serveur serveur d s que le client valide son paiement que ce dernier soit autoris ou refus PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 14 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Cela permet ainsi de valider automatiquement le bon de commande correspondant m me si le client coupe la connexion ou d cide de ne pas revenir sur la boutique car cet appa ne transite pas par le navigateur du porteur Il n y a aucune restriction au niveau du langage de votre script que ce soit de l ASP du PHP ou du PERL Par contre votre script cgi ne doit pas faire de re direction et doit g n rer une page HTML vide Si une erreur se produit lors de l appel de votre url un mail warning vous sera envoy sur la m me adresse mail o vous recevez vos tickets de paiements Par exemple si votre URL d appel est http www commerce fr coi verif pmt asp ref abc12 amp trans 1256 amp auto 30258 amp tarif 2000 amp abonnement 354 3418 pays FRA amp erreur 00000 vous recevrez l email d erreur suivant Sujet de l email PAYBOX WARNING Corps du message WARN
54. 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 LA TOUR 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 email un double du ticket de paiement au commerce Il sera possible pour le commer ant de g rer de fa on automati que 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 cale ci suivant le protocole CBPR CB2A version 5 1 et 5 2 au centre de t l collecte bancaire du commer ant afin queles transactions soient trait es Une fois la t l collecte effectu e le commer ant recevra un ticket de compte rendu par e mail Ticket Paiement E mail d E SERVEUR x WEB DU F ii COMMERCANT CA A PM SE ER jus CO E WAT Dr S Ce ON RELA Ge Die N SER RUDE Aro LEGENDE Navigateur Web du Client pe HTTP a a HTTPS 55L gt Protocoles bancaires CBSA et CBPR su
55. vement sera effectu 0 le m me jour que le 4 IBS QUAND paiement initial SEN nombre de jours d attente avant le d clenchement du d but de l abonnement pas e IBS DELAIS pr sente imm diatement SE PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELN E Version 3 41 Page 31 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Les autres informations pour le paiement via le produit Paybox System ne changent pas La devise est pass e par la variable PBX_DEVISE et le montant du premier r glement qui peut tre diff rent des pr l vements de l abonnement est pass dans la variablePBX TOTAL exemples d abonnement PBX_SITE 1999888 PBX_RANG 99 PBX_IDENTIFIANT 2 PBX TOTAL 1500 PBX_ DEVISE 978 Si le paiement initial 15 euros soit 1500 centimes est effectu le 28 novembre par exemple le premier pr l vement aura lieu le 03 d cembre car la prise en compte de l abonnement se fait 5 jours plus tard vialBS DELAIS Tous les pr l vements sont d un montant de 5 euros soit 500 centimes IBS_2M ONT r alis s le 28 IBS QUAND de tous les mois IBS FREQ jusqu une demande de r siliation IBS NBPAIE de votre part ou un rejet du centre d autorisation si la carte bancaire est arriv e expiration PBX_SITE 1999888 PBX_RANG 99 PBX_IDENTIFIANT 2 PBX TOTAL 2000 PBX_ DEVISE 978 Si le paiement initial 20 euros est effectu le 28 novembre par exemple le premier pr l v
56. ype d erreur et afficher le message correspondant Ainsi vous aurez la possibilit de rediriger le dient vers une url de votre choix expliquant plus en d tails le motif de l erreur PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 23 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Par exemple supposons que votre script soit PBX_ERREUR http www commerce fr cgi bin message er cO Si le client saisit mal son adresse email envoy e Paybox via la variable PBX_PORTEUR au lieu d avoir le type de message suivant BER Fichier Edition Affichage Favoris Outils 2 Liens gl Pr c dente gt D A A Rechercher Favoris gt Adresse http ffuww commerce fricg binimodule cg DK PAYBOX INPUT ERROR code 16 el Termin 3 Internet Vous pourrez lui afficher votre propre message comme par exemple PAYBOX SERVICES Centre Espace Sud Route d Elne 66200 LA TOUR BAS ELNE Version 3 41 Page 24 sur 44 t l 04 68 85 79 90 fax 04 68 85 79 99 Z PAYBOX Microsoft Internet Explorer lol x Fichier Edition Affichage Favoris Outils 2 Liens Ei lt Pr c dente gt 3 B Rechercher Favoris OK Adresse http Luana commerce fr cgi binfmessage_err cai NUMERR 16 e Une erreur s est produite lors de votre tentative de paiement Votre adresse email est incorrecte Merci de b
Download Pdf Manuals
Related Search