Récapitulatif des étapes de l`installation
Contents
1. e 3 Preen P iement CIC P iement OBC PFP iement OBC Eemer LC ABN AMRO FRANCE Le paiement z untze des Banques CIC SERVICE SECURISE DE PAIEMENT INTERNET PAR CARTE BANCAIRE S curis par le protocole SSL Manuel d installation Document 2 2 EURO 27 INFORMATION Sp Tech 1 2 8 Octobre 2001 n EURO Service s curis de paiement Internet par carte bancaire INFORMATION Documentation technique TABLE DES MATIERES RECAPITULATIF DES ETAPES DE L INSTALLATION seeecececencncenueenueeneeencune 3 3 DETAIL DES ELEMENTS FOURNIS sek KREE ENEE ERKENNEN ENKEN ENKEN REENEN KENE 3 3 1 LIBRAIRIE DE PAIEMENT SECURISE VERSION 1 2 in 3 3 2 CLE DE SECURITE COMMERCANT WE 5 4 CONTENU DE LA LIBRAIRIE DE PAIEMENT see K NEEN ENKEN EN KENNEN ENKEN EN ENKEN 6 4 1 a Lenger IERT e CR E 6 4 2 FONCTION TESTMAQ EE 11 4 3 FONCTION LGEERRERPONGSEC MI 14 5 OPERATIONS A EFFECTUER DANS LES CGI OU ASP nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnne 15 5 1 OPERATIONS A EFFECTUER DANS LE CGI 1 OU Aepi 15 5 2 OPERATIONS A EFFECTUER DANS LE CGI 2 OU ASP Zi 15 E 1 TV TA d LC 16 GC CONTRAINTE E 16 6 2 URLS DU SERVEUR DE LA BANQUE EE 17 6 3 EXEMPLE DE FORMULAIRE GENERE PAR LA FONCTION CREERFORMULAIRECM 18 6 4 CODIFICATION INTERNATIONALE DES DEVISES ISO 4217 iii ieiieieececerreeeees 18 6 5 MESSAGES D ERREUR sieiececcecccccccenenecuenecenecececememeeemenemeneemene cac eemeeemeneem2. pour cela il doit imp rativement faire appel la fonction TestMAC prise en compte des aspects de s curisation des changes puis la fonction CreerReponseCM g n ration de l accus de r ception renvoyer au serveur de la banque Le CGI2 ou asp2 sera appel par le serveur de la banque avec la m thode GET ou POST et recevra un formulaire contenant les champs suivants notons que si vous travaillez en VIRTUAL HOSTING vous devez nous le pr ciser et dans ce cas vous devez utiliser la m thode POST Dans tous les cas il faut nous pr ciser que si vous tes en m thode POST pour que nous puissions correctement param trer nos bases e TPE TPE virtuel du commer ant ex 0123456 e date date de la commande ex 06 06 1999_a 17 30 42 e montant montant de la commande ex 10EUR 65 25USD e r f rence r f rence de la commande ex 000000000145 e MAC de fa on analogue au formulaire de demande de paiement l aller le formulaire de retour contient galement un champ MAC condens calcul partir des donn es plac es dans le formulaire garantissant l int grit des donn es re ues et permettant d authentifier son metteur ex d0f7e7d4748420395df1ff18e50f5984616058fdb Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 10 20 n EURO Service s curis de paiement Internet par carte bancaire ae INFORMATION
3. INFORMATION Documentation technique gt Erreur Host non d fini Cette erreur survient quand le syst me de paiement s curis ne parvient pas trouver le nom DNS de la machine sur laquelle il s ex cute V rifiez le param trage DNS de la machine gt Erreur M moire satur e Votre programme alloue de la m moire sans la lib rer et sature le syst me gt Votre commande a d j t traite Ce message signifie que vous essayez de passer une commande sur une r f rence de commande d j pass e gt La date de validit de votre commande est d pass e Ce message indique qu il y a un trop grand d calage entre la date envoy e par voire CGI ou asp1 et la date syst me du serveur de la banque Recommencez le test avec un formulaire mis jour V rifiez la date syst me de votre machine gt Votre paiement a t effectu Mais le commer ant n a pu tre inform car une erreur de communication est survenue Veuillez contacter directement le commer ant pour v rifier que votre commande sera bien prise en compte Ce message signifie que la phase aller du paiement s est bien d roul e mais que le CGI2 ne nous a pas renvoy un accus de r ception valide V rifiez que le contenu du message renvoy par le cgi2 ou asp2 correspond aux Sp cifications techniques cf CreerReponseCM Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation p
4. Prototype de la fonction TestMAC pour le syst me WINDOWS NT extern void WINAPI TestMAC char MAC char version char TPE char date char montant char reference char texte libre char code retour char cdr_ test gt Prototype de la fonction TestMAC pour le syst me MAC OS La fonction poss de deux param tres suppl mentaires en entr e e key file chemin absolu du fichier contenant la cl commer ant exemple Localdisk keys 0123456 key e hostname nom DNS de la machine sur laquelle est install e la librairie de paiement s curis extern void TestMAC int cdr_ test char MAC char version char TPE char date char montant char reference char texte libre char code retour char key file char host name Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 13 20 n EURO Service s curis de paiement Internet par carte bancaire ee INFORMATION Documentation technique 4 3 Fonction CreerReponseCM gt Pr sentation Cette fonction est utiliser dans le CGI2 ou asp2 apr s l appel la fonction TestMAC pour g n rer l accus de r ception de la confirmation de paiement Le CGI2 ou asp2 doit retourner un accus de r ception positif au serveur de paiement de la banque pour lui signifier qu il a bien re u le message de confirmation
5. le paiement par carte bancaire La fonction CreerFormulaireCM accepte en entr e les informations n cessaires au paiement et g n re en sortie le source HTML du formulaire de demande de paiement correspondant Vous noterez que dans le formulaire g n r deux champs ont t calcul s par la fonction elle m me s agit des champs date et MAC Le champ date est positionn avec la date et l heure courante du syst me selon le format JJ MM AAAA HHIMM SS Le champ MAC Message Authentication Code est calcul par un proc d de cryptographie il contient un condens des informations contenues dans le formulaire Il permet de contr ler que les donn es n ont pas t modifi es par l acheteur lors de la Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 6 20 n EURO Service s curis de paiement Internet par carte bancaire ee INFORMATION Documentation technique transmission entre le serveur du commer ant et celui de la banque int grit des donn es et d authentifier l metteur de la demande de paiement C est la raison pour laquelle le formulaire de la demande de paiement doit imp rativement tre g n r par la fonction CreerFormulaireCM gt Param tres en entr e e url banque URL du serveur de paiement s curis de la banque e version version du syst me de paiement de la banque version a
6. sortie en particulier tenir compte de la taille du champ texte libre Ce formulaire est ins r r dans la page HTML du serveur web du commer ant sur laquelle le commer ant veut proposer le paiement par carte bancaire l acheteur NB Si un probl me survient dans le calcul du champ MAC un message d erreur s affiche dans le champ cach MAC Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 8 20 n EURO Service s curis de paiement Internet par carte bancaire ee INFORMATION Documentation technique gt Prototype de la fonction CreerFormulaireCM pour les syst mes UNIX extern void CreerFormulaireCM char ur banque char version char TPE char montant char reference char texte libre char url retour char url retour ok char url retour _err char langue char code societe char texte bouton char formulaire gt Prototype de la fonction CreerFormulaireCM pour le syst me WINDOWS NT extern void WINAPI CreerFormulaireCM char url_banque char version char TPE char montant char reference char texte libre char url retour char url retour ok char url retour _err char langue char code societe char texte bouton char formulaire gt Prototype de la fonction CreerFormulaireCM pour le syst me MAC OS La fonction poss de
7. 0 n EURO Service s curis de paiement Internet par carte bancaire ee INFORMATION Documentation technique 3 2 Cl de s curit commer ant Une cl de s curit certifiant les donn es chang es entre le serveur du commer ant et le serveur de paiement s curis de la banque est attribu e par la banque chaque commer ant Cette cl associ e au TPE virtuel du commer ant est indispensable pour utiliser le service de paiement par carte bancaire s agit d un fichier texte comprenant 4 lignes non modifiables dont le nom est lt num ro TPE gt key exemple cl commer ant 0123456 key pour le TPE virtuel 0123456 La cl commer ant est utilisable sur une seule machine celle dont le nom DNS est renvoy par le petit utilitaire host ex cut sur cette m me machine Cette clef est utilis e lors de l appel des fonctions de la librairie de paiement Le param tre TPE des fonctions doit contenir le chemin d acc s complet disque local au fichier clef exemple home cybermut clef 0123456 key sous UNIX ou C lrepertoire clef0123456 key sous Windows Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 5 20 n EURO Service s curis de paiement Internet par carte bancaire s INFORMATION Documentation technique 4 Contenu de la librairie de paiement La librairie de paiement qui vous est fournie co
8. Documentation technique e texte libre zone de texte libre plac e dans la demande de paiement e code retour r sultat du paiement valeurs possibles payetest si la carte bancaire est accept e sur le serveur de test paiement si la carte bancaire est accept e sur le serveur de production Annulation si la carte bancaire est refus e La Query String recue est de la forme suivante TPE lt numero TPE amp date lt date amp montant lt montant amp reference lt reference amp MAC lt code MAC gt amp texte libre lt texte libre amp code retour lt code retour gt Exemple TPE 123456 7 amp date 09 2f10 2f1996 5fa 5f15 3a51 3a46 amp montant 10 2e 5 amp reference 00002348 amp MAC e4359a2ci8d86cif2e4b0e646016c202e89947b04 amp texte libre test amp code retour paiement La confirmation par fax peut tre mis en place C est une option payante 5F fax Cette confirmation ne remplace pas celle on line obligatoire Dans le cas d une confirmation par fax le commer ant sera inform du montant TTC de la transaction ainsi que du d tail de la commande correspondant au champ texte libre de la confirmation par requ te on line 4 2 Fonction TestMAC gt Pr sentation Cette fonction est utiliser dans le CGI2 ou asp2 pour s assurer qu il n y a pas eu de falsification des donn es contenues dans le message de confirmation du paiement re u gt Description Le message de confirmation re u comporte un co
9. ations transmises par votre commer ant ont une signature non valide Le niveau de s curit exig n est pas atteint Notre serveur n est pas en mesure de traiter la demande de paiement relative votre commande Le champ MAC g n r par le premier CGI n est pas valide ou n a pas pu tre calcul Veuillez afficher le source du formulaire g n r par la fonction CreerFormulaireCM et regarder le contenu du champs cach MAC gt Erreur Cl non trouv e V rifiez que la variable TPE est bien positionn e et pointe sur le chemin complet du fichier cl V rifiez que ce fichier est accessible en lecture gt Erreur Cl falsifi e V rifiez que le fichier cl n a pas t alt r durant le transfert par mail pas de lignes blanches pas de caract res sp ciaux Si vous avez re u plusieurs versions d une m me cl veillez utiliser la derni re version gt Erreur Host non autoris Vous essayez de faire fonctionner le syst me de paiement s curis sur une machine autre que celle sur laquelle il peut s ex cuter Le nom de machine inscrit dans la cl de s curit ne correspond pas au nom de machine renvoy par le programme host Une nouvelle cl de s curit doit tre g n r e pour cette machine Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 19 20 n EURO Service s curis de paiement Internet par carte bancaire
10. chiers libCM lib et libCM h Vous devez utiliser cette librairie de fonctions pour cr er les deux programmes d interface CGI1 ou asp1 g n ration du formulaire de la demande de paiement et CGI2 ou asp2 r ception de la confirmation du paiement A titre d information des exemples en C PHP Perl Cold Fusion ASP et Java de chacun des deux CGI ou ASP cr er vous sont fournis avec la librairie lls sont int gralement comment s et vous pr sentent de fa on pr cise la d marche suivre Vous pouvez utiliser ces exemples comme point de d part en les modifiant selon les sp cificit s de votre environnement et de votre application La nature du travail r aliser n cessite imp rativement des comp tences en programmation dans l un des langages de programmation suivant Cou C savoir cr er un petit programme CGI et le compiler en le liant la librairie fournie VisualBasic savoir utiliser l ActiveX fourni dans des pages ASP PHP savoir compiler 3 CGI en C sous UNIX savoir utiliser l ActiveX fourni sous Windows Herl savoir utiliser H2XS pour int grer la librairie de paiement dans Perl sous UNIX savoir installer Win32 API sous NT Cold Fusion Java savoir installer une librairie sous UNIX et savoir appeler les m thodes de la classe JlibCmMac fournie Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 4 2
11. ctuelle 1 2 e TPE Chemin complet du fichier clef correspondant au TPE virtuel du commer ant fourni par la banque ex home repertoire_clef 0123456 key sur MAC OS ne sp cifier que le num ro de TPE exemple 0123456 e montant montant TTC de la commande format de la fa on suivante un nombre entier un point d cimal optionnel un nombre entier optionnel sur 2 d cimales une devise sur 3 caract res alphab tiques majuscule selon codification internationale ISO 4217 cf annexes La devise doit imp rativement tre indiqu e ex 10EUR 65 25USD e reference r f rence de la commande cha ne alpha num rique A Z a z 0 9 unique sur 12 caract res maximum permettant d identifier la commande par exemple un num ro s quentiel incr ment chaque commande ex 000000000145 e texte libre param tre optionnel zone de texte libre 40 lignes de 80 caract res chacune il peut contenir une description sommaire de la commande e url retour URL de retour pour l acheteur retour sur la page d accueil de la boutique attention ne pas confondre avec l URL de confirmation des paiements sur laquelle sera plac e le CGI2 ou asp2 e url retour ok URL de retour pour l acheteur page de retour sur le site commer ant apr s un paiement accept attention ne pas confondre avec l URL de confirmation des paiements sur laquelle sera plac e le CGI2 ou asp2 e url retour err URL
12. de MAC qui a t calcul par le serveur de paiement de la banque L objet de la fonction TestMAC est de recalculer le code MAC associ au message et de le comparer celui transmis dans le message si les deux codes MAC sont identiques l information re ue est fiable int grit et authentification metteur La fonction TestMAC accepte en entr e le code MAC calcul par le serveur de paiement de la banque transmis dans le message ainsi que les donn es permettant de le recalculer Elle indique en sortie si le message re u est correct ou a t falsifi Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 11 20 n EURO Service s curis de paiement Internet par carte bancaire ee INFORMATION Documentation technique gt Param tres en entr e e MAC code calcul par le serveur de paiement de la banque et transmis dans le message de confirmation du paiement diff rent de celui de la phase aller ex d0f7e7d4748420395df1ff18e50f5984616058fdb e version version du syst me de paiement utilis version actuelle 1 2 e TPE Chemin complet du fichier clef correspondant au TPE virtuel du commer ant fourni par la banque ex home repertoire_clef 0123456 key sur MAC OS ne sp cifier que le num ro de TPE exemple 0123456 e date date de la commande ex 06 06 1996 a 17 30 42 e montant montant TTC de la commande fo
13. de retour pour l acheteur page de retour sur le site commer ant apr s un paiement refus attention ne pas confondre avec l URL de confirmation des paiements sur laquelle sera plac e le CGI2 ou asp2 Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 7 20 yA EURO s INFORMATION Service s curis de paiement Internet par carte bancaire e langue e code soci t e texte bouton Documentation technique langue dans laquelle les pages seront affich es sur le serveur de paiement de la banque valeurs possibles francais anglais allemand espagnol ou italien code usage interne uniquement non affich qui permet un commer ant d utiliser le m me TPE virtuel pour des sites diff rents param tres diff rents ex vetement phrase affich e sur le bouton de validation du formulaire de demande de paiement type submit ex Paiement par carte bancaire NB les param tres url retour url retour ok et url retour ert sont optionnels pointeurs NULL en langage C Dans ce cas de figure ce sont les param tres stock s sur le serveur de la banque qui seront utilis s gt Param tre en sortie e formulaire buffer contenant le source HTML du formulaire de demande de paiement La taille de ce buffer doit tre allou e avec une taille suffisante pour pouvoir y stocker le formulaire de
14. deux param tres suppl mentaires en entr e e key file chemin absolu du fichier contenant la cl commer ant ex u keys 0123456 key e hostname nom DNS de la machine sur laquelle est install e la librairie de paiement s curis ex WWW server com Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 9 20 n EURO Service s curis de paiement Internet par carte bancaire INFORMATION Documentation technique extern void CreerFormulaireCM char ur banque char version char TPE char montant char reference char texte libre char url retour char url retour ok char url retour _err char langue char code societe char texte bouton char key file char host name char formulaire Apr s avoir trait la demande de paiement le serveur de la banque informe directement le syst me informatique du commer ant du r sultat de la demande de paiement en mettant une requ te HTTP on line contenant le r sultat de la demande de paiement sur l URL de confirmation des paiements Cette URL correspond l URL du CGI2 ou asp2 URL que vous devez nous indiquer au moment de la mise en place du syst me Le CGI2 ou asp2 est charg de recevoir la requ te de confirmation du paiement d en extraire les diff rentes informations dont le r sultat du paiement et dv r pondre par un accus de r ception
15. du paiement et ce que la demande de paiement ait t pr c demment accept e ou refus e gt Description La fonction CreerReponseCM g n re la totalit du message d accus de r ception de la confirmation du paiement que le CGI2 ou asp2 doit retourner au serveur de paiement de la banque Le message d accus de r ception g n r est un document de type MIME text plain au format suivant Sur Windows NT Content type text plain lt CR gt lt LF gt Version 1 lt LF gt OK lt LF gt Autre Content type text plain lt LF gt lt LF gt Version 1 lt LF gt OK lt LF gt gt Param tres en entr e e phrase corps du message d accus de r ception Valeurs possibles Signification OK Le message de confirmation du paiement a t correctement re u et authentifi Autre Le message de confirmation du paiement n a pas t correctement authentifi gt Param tre en sortie e reponse buffer contenant le message d accus de r ception ent te et corps du message Ce buffer doit tre affich sur la sortie standard pour que le serveur de la banque re oive la r ponse gt Prototype de la fonction CreerReponseCM pour les syst mes UNIX et MAC OS extern void CreerReponseCM char phrase char reponse gt Prototype de la fonction CreerReponseCM pour le syst me WINDOWS NT extern void WINAPI CreerReponseCM char phrase char reponse Copyright Eu
16. eneececeeceeeeee 19 Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 2 20 ra EURO Service s curis de paiement Internet par carte bancaire a INFORMATION Documentation technique R capitulatif des tapes de l installation 3 D tail des l ments fournis Les diff rents l ments n cessaires la mise en place du paiement s curis vous sont fournis par E mail lors des diff rentes phases de l installation 3 1 Librairie de paiement s curis version 1 2 14 D veloppements achev s et tests valides 1 Renseignements commerciaux 3 Signature des contrats Agence CM ou CIC 2 Support commercialisation E 4 Transmission des contrats Correspondant r gional 5 Contrats 6 Contrats commer ants de licence 9 Envoi des l ments logiciels 8 Contrats commer ants 10 Envoi du nom de machine 9 Envoi d identifiant 11 Envoi cl de s curit 12 Envoi des l ments de CS 15 Demande d ouverture param trage du serveur en production 13 Confirmation de mise en test m 16 Confirmation d ouverture 16 Confirmation d ouverture en production en production La solution de paiement s curis par carte bancaire est diffus e sous la forme d un kit de d veloppement Ce kit de d veloppement permet de r aliser les 3 fonctionnalit s n cessaires pour r aliser l interfa age du serveur du commer ant avec le serveur de
17. ntient les 3 fonctions utiliser pour cr er vos deux CGI d interfa age avec le serveur de paiement s curis de la banque gt fonction CreerFormulaireCM utiliser dans CGI1 fonction VbCreerFormulaireCM utiliser dans ASP1 fonction JCreerFormulaireCM utiliser en Java gt fonction TestMAC utiliser dans CGI2 fonction VbTestMAC utiliser dans ASP2 fonction JTestMAC utiliser en Java gt fonction CreerReponseCM utiliser dans CGI2 fonction VbCreerReponseCM utiliser dans ASP2 fonction JCreerReponseCM utiliser en Java 4 1 Fonction CreerFormulaireCM gt Pr sentation Cette fonction est utiliser dans le CGI1 ou aspi pour g n rer le formulaire HTML de la demande de paiement gt Description Un certain nombre d informations relatives la commande sont n cessaires pour le traitement du paiement Il s agit des informations telles que le montant de la commande sa r f rence le num ro du TPE virtuel du commer ant etc Ces informations doivent tre associ es au bouton paiement par carte bancaire qui dirige l acheteur vers le serveur de paiement s curis de la banque Elles sont plac es dans un formulaire HTML en champ cach hidden La seule partie visible de ce formulaire est le bouton de validation submit paiement par carte bancaire Ce formulaire HTML est ins rer dans le site du commer ant pour proposer
18. on et payetest sur le serveur de test ou non Annulation Par contre il doit contenir autre chose si l int grit des donn es est alt r e Page 15 20 n EURO Service s curis de paiement Internet par carte bancaire s INFORMATION Documentation technique 6 Annexes 6 1 Contraintes gt sur la taille des champs version maxi 10 TPE maxi 10 date maxi 30 montant maxi 20 reference maxi 12 MAC maxi 50 url retour maxi 255 ri P LCOUE ok maxi 255 ri retour rr maxi 255 Joe maxi 20 code societe maxi 50 texte libre maxi 3200 uuencoded gt sur le contenu des champs Les champs version TPE date montant r f rence MAC url retour url retour_ ok url retour_err ne doivent contenir ni chr 10 ni chr 13 Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 16 20 n EURO Service s curis de paiement Internet par carte bancaire INFORMATION Documentation technique 6 2 URLs du serveur de la banque Ces URL sont celles que vous devez passez en param tre url banque dans la fonction CreerFormulaireCM gt URL detest Vous pourez valider vos d veloppements dans l environnement de test disponible l adresse suivante Solution Cyber MUT P iement https www creditmutuel fr telepaiement test paiement cql Solution P iement CIC https ssl paiement cic banques f
19. paiement s curis de la banque Il se pr sente sous la forme d une librairie de fonctions taille 50 Ko environ Cette librairie contient essentiellement des algorithmes assurant la s curit du syst me Pour cette raison elle vous est fournie sous forme compil e en fonction du type et de la version de votre syst me d exploitation les programmes sources ne vous sont pas fournis Le fichier de d finitions associ contenant les prototypes des fonctions pr sentes dans la librairie vous est galement fourni Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 3 20 n EURO Service s curis de paiement Internet par carte bancaire se INFORMATION Documentation technique La librairie de fonctions est disponible pour les syst mes d exploitation suivants gt Syst mes UNIX librairie de fonctions C fichiers libcm mac a et cm mac h gt Syst mes UNIX avec PHP librairie de fonctions C 3 CGI en C compiler gt Syst mes UNIX avec JAVA librairie native de fonctions classe d appel fichiers libjava cm mac so et JlibCmMac class v Syst me Windows NT DLL WINAPI fichiers CMSSL dII CMSSL Iib et CMSSL h El ments suppl mentaires fournis titre gracieux e ax_cmssl dil et lisezmoi win txt gt v Syst me MAC OS code fragment g n r avec le produit Code Warrior PRO3 fi
20. r alable Page 20 20
21. r test paiement cqli Solution P iement OBC https ssl paiement banque obc fr test paiement cql L acc s ces URL est prot g par un identifiant mot de passe gt URL de production Apr s avoir valid vos d veloppements vous pourrez vous adresser au serveur de production disponible l adresse suivante Solution Cyber MUT P iement https www creditmutuel fr telepaiement paiement cqi Solution P iement CIC https ssl paiement cic banques fr paiement cqgli Solution P iement OBC https ssl paiement banque obc fr paiement cagli Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 17 20 Za EURO Service s curis de paiement Internet par carte bancaire s INFORMATION Documentation technique 6 3 Exemple de formulaire g n r par la fonction CreerFormulaireCM lt form action https serveur_de la banque test paiement cgi method post target _top gt lt input type hidden name version value 1 2 gt lt input type hidden name TPE value 0123456 gt lt input type hidden name date value 04 11 1999 11 13 42 gt lt input type hidden name montant value 10 75EUR gt lt input type hidden name reference value 000001234 gt lt input type hidden name MAC value 05df8c76beff135f8aabe44eea07918d8b831dc1 gt lt input type hidden name url_retour value http www home fr gt lt inp
22. rmat de la fa on suivante un nombre entier un point d cimal optionnel un nombre entier optionnel une devise sur 3 caract res alphab tiques majuscule selon codification internationale ISO 4217 cf annexes ex 10EUR 65 25USD e reference r f rence de la commande cha ne alpha num rique A Z a z 0 9 unique permettant d identifier la commande ex 00000014500 Pour des raisons pratiques nous demandons une longueur de 12 caract res alphanum riques pour la r f rence e texte libre zone de texte libre fournie lors de la demande de paiement e code retour r sultat du paiement valeurs possibles payetest si la carte bancaire est accept e sur le serveur de test paiement si la carte bancaire est accept e sur le serveur de production Annulation si la carte bancaire est refus e gt Param tre en sortie e cdr test r sultat de l authentification valeurs possibles 1 si le message re u est authentifi 0 sinon Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 12 20 n EURO Service s curis de paiement Internet par carte bancaire INFORMATION Documentation technique gt Prototype de la fonction TestMAC pour les syst mes UNIX extern int TestMAC char MAC char version char TPE char date char montant char reference char texte libre char code retour gt
23. ro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 14 20 n EURO Service s curis de paiement Internet par carte bancaire INFORMATION Documentation technique 5 Op rations effectuer dans les CGI ou asp 5 1 Op rations effectuer dans le CGI 1 ou asp 1 Positionner la variable TPE syst mes Unix et Windows Cette variable doit indiquer le chemin complet de la cl de s curit R cup rer les variables passer la fonction CreerFormulaireCM Celles ci peuvent tre d duites d un identifiant ou d une r f rence pass en argument au CGI Lancer l appel CreerFormulaireCM Afficher le formulaire sur la sortie standard 5 2 Op rations effectuer dans le CGI 2 ou asp 2 gt Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Positionner la variable TPE syst mes Unix et Windows Cette variable doit indiquer le chemin complet de la cl de s curit R cup rer les variables envoy es par le serveur de la banque Selon la configuration souhait e ceux ci sont pass s avec la m thode GET ou POST Tester l int grit des donn es avec la fonction TestMAC G n rer et envoyer l accus de r ception avec la fonction CreerReponseCM NB L accus de r ception doit contenir le message OK que le paiement ait t accept paiement sur le serveur de producti
24. ut type hidden name url_retour_ok value http www home fr paiement_ok html gt lt input type hidden name url_retour_err value http www home fr paiement_err html gt lt input type hidden name lgue value francais gt lt input type hidden name societe value vetement gt lt input type hidden name texte libre value informations diverses gt lt input type submit value Paiement par carte bancaire gt lt form gt 6 4 Codification internationale des devises ISO 4217 DEVISE CODE ISO 4217 Livre Sterling Copyright Euro Information 25 10 2001 Ce document ne peut tre reproduit ou communiqu sans autorisation pr alable Page 18 20 n EURO Service s curis de paiement Internet par carte bancaire ee INFORMATION Documentation technique 6 5 Messages d erreur gt Le site de votre commer ant n a pas t identifi par notre serveur Nous ne sommes pas en mesure de traiter la demande de paiement relative votre commande Ce message signifie que les informations transmises par le CGI1 ou aspi ne sont pas reconnues par le serveur de la banque V rifiez que vous avez bien r pondu aux questions qui sont pos es dans le mail de fourniture de la cl V rifiez que les param tres suivants transmis par le CGI1 ou asp1 correspondent aux informations que vous nous avez envoy es par mail Num ro de TPE Code soci t importance de la casse Langue gt Les inform
Download Pdf Manuals
Related Search