Home

le manuel d`installation

1. La saisie des informations compl mentaires email nom pr nom etc 2 nom_du_marchand Microsoft Internet Explorer Exh er Edtion Afkhege Favoris lt x 2 D y Favoris 42 nom du _ marchand Ch que bancaire fran ais Virement sur notre compte Merci de choisir un type de paiement Carte bencaire af Pr l vement sur votre compte Mandat Postal Mandat Postal International Formule number One 7 jour s 7 00 EUR puis formule number TWO 2 mois 15 00 EUR CB uniquement D couverte 1 jour s 39 00 EUR puis Gold 1 mois 10 00 EUR CB uniquement S lectionnez votre Formule d Abonnement Gold 1 mots 10 00 EUR Formule number TWO 2 mois 15 00 EUR Pr nom Les champs munis d un sont obligstoses Oui je confirme ma commande M thode GET plus simple lt A HREF htips www h2epayment com prod ecom_menu php NumSite votre num _ site amp Password votre mot_de passe crypt en MD5 gt ACCES PAIEMENT lt A gt M thode POST plus discr te Cr ez une page HTML sur votre site et ins rez un code de ce type lt FORM name goPaymentProcessor method POST action https www h2epayment com prod ecom_menu php gt lt input type hidden name NumSite value votre_num_site gt lt input type hidden name Password value votre_mot_de_passe_crypt _en_MD5 gt lt input type submit name submitButton value ACCES PAIEMENT gt HAPPYDOO Ecom D
2. d cide d arr ter l abonnement via le site marchand votre serveur doit appeler l URL suivante pour arr ter l abonnement de notre cot et viter un renouvellement automatique de son abonnement httos www h2epayment com backoffice tools stop php ou http www h2epayment com backoffice tools stop php Avec les param tres suivants Nom du ue Description param tre 3 Correspond votre identifiant marchand donn par H2EPAYMENT NumSite an l ouverture du compte code num rique 935xxxx Password Mot de passe associ au NumSite crypt par la fonction MD5 orderiD Correspond votre num ro de commande unique IDUsager Correspond au num ro qui r f rence l Usager facultatif Permet de sp cifier si le marchand veut arr ter imm diatement l abonnement ou juste stopper le renouvellement UnsubType 2 valeurs possibles STOP_RENEVW Arr t des renouvellements STOP_ NOW Arr t imm diat de l abonnement Cette cha ne est construite partir des valeurs des champs NumSite orderlD UnsubType de la requ te envoy e et d une cha ne suppl mentaire Phrase cl que le Signature marchand d finit dans les param tres de son site Voir explications ci dessous md5 NumSite orderlD UnsubType PhraseCI Pour des raisons de s curit la signature est obligatoire sur cette URL Votre site doit donc poss der une phrase Cl renseign e sur le Backoffice Cette cha ne est construite partir des champs
3. ALPHA ISO code de la langue du client Cf annexe Si la langue est inconnue ou non fournie nous prendrons la langue de l usager utilis e lors de son achat OU Nom du PA Description param tre HAPPYDOO Ecom Doc d int gration 30 06 2009 21 25 PAYID R f rence unique de H2EPAYMENT permettant d identifier la transaction ALPHA ISO code de la langue du client Cf annexe Si la langue est inconnue ou non fournie nous prendrons la langue de l usager utilis e lors de son achat La page est alors g n r e au format HTML en reprenant les coordonn es du Marchand et son logo s il est stock sur le serveur H2EPAYMENT HAPPYDOO Ecom Doc d int gration 30 06 2009 22 25 11 Gestion des abonnements Cette partie est d di e la gestion d abonnement disponible si vous avez enregistr votre site en tant que gestion d abonnement dans le Backoffice 11 1 Renouvellement Dans le cas d une transaction de type abonnement et si le mode de r abonnement automatique est activ H2EPAYMENT g re automatiquement le renouvellement l ch ance sauf bien entendu si l abonn a arr t son abonnement Les traitements du jour J sont trait s 23H00 EST c est dire Heure de New York A l issue de ce renouvellement comme pour le paiement initial votre URL retour automatique est appel e 11 2 Synchronisation des arr ts d abonnements 11 2 1 D sabonnement sur le site Marchand Si l abonn
4. Cha ne de processus de paiement Voil ci dessous la cha ne de paiement en fonction du mode de paiement s lectionn 8 1 Paiement par carte bancaire 4 nom du marchand Microsol Internet Explorer D G ar maintenant at chuer la tran acton cris par prote AH A ia f at al f aus prouve l tat d la g BELL t una platlorme d pement lotalement ind pendante du ate diteur Le dte dib ur ghin FAO er le MIBINQUr SEVEN de cohmazion g curg Marchand nom du manthanrd Formule d Abonnement Formule number ne Cartes de cr dit VS Sg Votre ID vous sera communiqu par email accept es k apr s vabdaten du paimant Total payer 7 00 TUR Type Abonnement Nom du Porteur hium ro d carte 42005 Date d spiration H 3 amani d 15 00 EUR mmaa 01 iy 2005 Ce walak ii mon urgu au 2ga 2005 ET Lens M a Tach Code de v rilicatian CYC Aide Retapez ce code vizuel de contr le ENT Arda Ei Eara awer Le marque un champ obligent Qu je confirme ma commande Hitema L usager est invit saisir le titulaire de la carte pr rempli automatiquement son num ro de carte la date de validit le Cryptogramme visuel CVC ou CVV un code visuel de contr le pour limiter la Fraude Une fois valid nous appliquons nos r gles anti fraude puis nous contactons le serveur bancaire pour effectuer le paiement En retour du serveur bancaire l analyse est faite
5. NumSite orderlD UnsubType ainsi que d une cha ne suppl mentaire phrase cl que le marchand d finit dans le param trage de son site Pour g n rer la signature il suffit de concat ner les champs ci dessus Signature NumSite orderlD UnsubType PhraseCl Exemple NumSite 9351234 HAPPYDOO Ecom Doc d int gration 30 06 2009 23 25 orderlD 18864 UnsubType STOP RENEW PhraseCIl tulipe Cha ne crypter en md5 935123418864STOP RENEWiulipe soit 4a15ffd0773f28cc9bb7bee836e198b7 11 2 2 D sabonnement sur le site H2EPAYMENT Si l abonn d cide d arr ter l abonnement via le site H2EPAYMENT notre serveur appelera votre URL retour automatique HAPPYDOO Ecom Doc d int gration 30 06 2009 24 25 12 Annexes 12 1 Annexe codes devises Nous utilisons la codification bancaire ISO sur 3 lettres Devise Code utiis Euro EUR Dollar US Dollar Canadien Franc Suisse Livre Grande Bretagne Couronne Danoise DKK Dollar Hong Kong Dollar N o Z landais Dollar Singapour Couronne Su doise R al Br silien 12 2 Annexe codes langues Nous utilisons la codification ISO 639 sur 2 caract res HAPPYDOO Aleman o e Italien Portugais nl N erlandais Ecom Doc d int gration 30 06 2009 25725
6. PAYID 1111111 STATUS OK NCSTATUS payment ok NCERROR NCERRORPLUS gt HAPPYDOO Ecom Doc d int gration 30 06 2009 20 25 Avec orderlD Votre r f rence de commande initiale PAYID La r f rence du paiement H2EPAYMENT STATUS le r sultat de la requ te Pouvant prendre les valeurs OK 05 Erreur etc 10 3 Edition de la facture Client Cette fonction permet de requ rir par une simple URL dynamique depuis le site Marchand ou dans un email de confirmation envoy l acheteur une page HTML fournie par le serveur H2EPAYMENT sous la forme d une facture Client mise au nom du marchand D Facture Ac quitt e Micresont Internet Laplerer Rodarte LE l avons Facture Reference mairo WNN Oue 2006 0608 50674 KOLN ALLEMAGNE Description de La commande TITEL DER GROS CHUREN ANZAHL DER BESTELLTEN BROSCHUREN hargazre Ardenre t tons de egemen Total Hees Taxes 1 50 EUR sde Bancare en igne ELA TVA 0e EUR Factme Acquitt e Total TT L EUR Frais de port bachus 10 3 1 Appel de facture L URL vers laquelle la requ te est faite est https www h2epayment com misc factureUsager php Vous pouvez acc der la facture de 2 fa ons diff rentes Les param tres a transmettre Nom du param tre NumSite Correspond votre identifiant marchand donn par H2EPAYMENT l ouverture du compte code num rique 935xxxx orderlD Correspond votre num ro de commande unique
7. acheteur de ses coordonn es cartes bancaires avec code CVC CVV2 ou RIB pour le pr l vement sur une page s curis e SSL certificat 1024 bits RSA 3 Contr le anti fraude et si OK appel de notre serveur sur le serveur bancaire pour demande d autorisation syst matique et en temps r el Selon les options le paiement pourra tre simultan la demande d autorisation ou diff r cf point 6 4 Analyse de la r ponse bancaire et appel serveur serveur du serveur marchand pour validation de la commande avec la r ponse bancaire OK REFUS ceci tant transparent pour l acheteur HAPPYDOO Ecom Doc d int gration 30 06 2009 2 25 4bis Envoi d un email l acheteur syst matique pour lui fournir son ticket de paiement Envoi d un email au webmaster optionnel selon les param tres du site pour lui annoncer qu un paiement vient d avoir lieu Envoi d un email l acheteur optionnel selon les param tres du site et exclusivement pour les abonnements pour lui fournir les informations sur l abonnement qu il vient de souscrire 5 Redirection sur le serveur marchand pour affichage du r sultat de la commande par H2EPAYMENT avec une page contenant un lien de retour manuel vers le site marchand processus internes aux diff rents serveurs concern s Marchand pages HTML vues par l acheteur Ei Serveur d autorisation Carte HAPPYDOO Ecom Doc d int gration 30 06 2009 3725 3 Enregistrement de votre s
8. le montant en retour par rapport au montant initial Devise dans laquelle la transaction a t effectu e li e au Amount Code de statut de paiement 00 Si paiement accept et Vente r alis e mode vente imm diate ou Op ration SAL TransStatus AA Si autorisation OK mais pas de vente imm diate 05 Si refus de l autorisation WT Si paiement en attente paiement offline en attente de r ception Envoy seulement si l v nement est associ un abonnement cr ation suppression renouvellement HAPPYDOO Ecom Doc d int gration 30 06 2009 17725 DateDebut Date effective de d but de l abonnement Date de fin d abonnement volue en cas de DateFin renouvellement Code de statut de l abonnement AboStatus O Open Ouverture de l abonnement R Renew Renouvellement C Close Fermeture de l abonnement Le r sultat de cet appel n est pas fourni au visiteur du site il ne sert donc logiquement qu a permettre au marchand de valider la commande initiale en fonction des r ponses fournies par H2EPAYMENT et ventuellement envoyer un mail au visiteur acheteur pour lui confirmer l tat de sa commande ou lui envoyer des codes d acc s Le retour r el se fera par les URL de Retour d crites dans le chapitre suivant HAPPYDOO Ecom Doc d int gration 30 06 2009 18 25 10 Administration des commandes existantes 10 1 Statut d un paiement Cette fonction permet de requ rir automatiquement
9. tres que vous avez d finis en configurant votre compte ou nous recevons des param tres erron s Erreurs les plus courantes Libell retourn Raison possible Param tre NumSite obligatoire Le param tre NumSite n a pas t re u par l application Param tre NumSite incorrect Le NumSite doit tre un num rique Param tre Password obligatoire Le param tre Password n a pas t re u par l application Param tre Password au format invalide Le Password doit tre crypt en MD5 Param tre Email au format invalide L email doit avoir un format correct xxxx xxxx xx Param tre Operation invalide Ce param tre doit tre RES SAL ou NumSite ronn Le NumSite fourni n a pas t trouv dans notre syst me Password ronn Le Password fourni ne correspond pas celui pr sent dans notre syst me D sol ce site n appartient pas l enseigne H2EPAYMENT Votre site n est pas rattach l enseigne H2EPAYMENT Param tre Amount requis pour un site de vente Le param tre Amount n a pas t re u par l application alors que le site de produits g re une vente de produit Param tre orderlD non compatible avec un site Le param tre orderlD a t re u par l application alors que le site g re des de gestion d abonnements abonnements ce param tre est donc refus Param tre Amount non compatible avec un site Le param tre Amount a t re u par l application alors que le site g re des de gestion d abonnemen
10. vement iii 14 25 8 3 Paiement par ch que mandat postal virement rrenen e ee 15 25 8 4 Appel serveur marchand Validation Commande 15 25 8 5 Retour au site Marchand Confirmation de fin de commande 16 25 9 Url retour AUTOMATIQUE sssssiscssssssssnsnsransssnnssnnnsseen en ares ns nn ones sons ramara a EMAN anaia ERENER 17 25 10 Administration des commandes existantes is ssnsnnrirrcrrennnnnnnnennnnnee 19 25 10 1 Statut d un paiement iii 19 25 10 1 1 Initier une demande de statut iii 19 25 10 1 2 R p ns la requ te PP n aav ii A T 19 25 10 2 Administration des paiements 19 25 10 2 1 Initier une transaction d administration iii 20 25 10 22 R ponse la requ te summer manner 20 25 10 3 Edition de la facture Client iiiiieeiceneeeeceeseeneeeeneereeeene 21 25 103 1 Appel d factur rena s a eae Ea AAE a A ESKE dents 21 25 11 Gestion des abonnements aasunnnnnnnnennnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nnnm nnmnnn nnnm nnmnnn 23 25 ea Eea m EOE ELEA EE EE E EE E E E E T el A E 23 25 11 2 Synchronisation des arr ts d abonnements 23 25 11 2 1 D sabonnement sur le site Marchand 23 25 11 2 2 D sabonnement sur le site H2EPAYMENT ii iii neue 24 25 12 ANNEXCS 51 E e Due range ou Poe lung ue De dou AE EEEE oh g o ed an dede rat ge que dote noce EE E SEEE 25 25 1 Introduct
11. LDC LL ER payment www h2epayment com Doc d int gration Version V1 10 Table des mati res 1 Introduction in nasnsmnsmnennnnnnnnnnnnnnnnnnnnnnnnmann nan nnnn nee nee nnmnnn nnmnnn nnmnnn nnn 1 25 2 Pr sentation dot oanederanneete se petotod D ten crcnda rat auan te 10 lue 18 han ecr ones tac r diva ci rence 2 25 3 Enregistrement de votre site nn nnnrnnnnnnnsnnnsennne nee eme nnmnnn nnmnnn nnna 4 25 3 1 Faites votre premier test de paiement 4 25 4 Integration dans votre application nnnnrnnrnnenneenneennenneeneeenneenee 5 25 1 M thode express aan nine nina ennui 5 25 4 2 M thode volu e iii iiiieeceerceeereneeeceneeeeeee mecs eeeeee DEEE EEEE EE EnEn nne 6 25 4 3 Liste des param tres disponibles ss 6 25 44 gt Si gnat re ee 8 25 5 Simuler un paiement en teSti aannsnnnnnnnnnnennnnnnnnnnnnn nnn nnnnnnnn nenn n nnmnnn nnnm n mnnn nnnm mnane 9 25 6 R solution des probl mes de base iisnnsnisisnnnnnmmnennnnnmneeennnmnneeennmmnnnnnnnnnns 10 25 7 Comment passer d un compte de test un compte de production 12 25 1 URL deteste tisse ne ele Dee Mr da en Tee a 2 EEE en 12 25 8 Cha ne de processus de paiement iissssnisisnnrnnnemnennnnnmenennnnnnneeennnnnnennnnnnes 13 25 8 1 Paiement par carte bancaire 13 25 8 2 Paiement par pr l
12. SAS DES RFD Signature Cette cha ne est construite partir des valeurs des champs orderlD PAYID Amount NumSite Operation de la requ te et d une cha ne suppl mentaire Phrase cl que le marchand d finit dans les param tres de son site Signature NumSite et Password sont utilis pour identifier le marchand La commande originale peut tre identifi e par orderlD la r f rence originale du marchand ou PAYID la r f rence de H2EPAYMENT retourn e pour le paiement Amount idem nouveau paiement n cessaire seulement si le montant de la transaction est diff rent du montant de la transaction originale Le syst me v rifie que le montant d une remise n est pas trop grand compar au montant de l autorisation originale ou que celui d un remboursement ne d passe pas le montant initialement pr lev Operation code qui identifie l op ration requise SAS pour la remise d une commande autoris e DES pour l annulation d une commande autoris e RFD pour une demande de remboursement valable pour les commandes qui ont t r ellement pay es et non simplement autoris es Et la Signature pour garantir l int grit des donn es Pour plus de d tail voir le chapitre int gration du connecteur volu signup php 10 2 2 R ponse la requ te En r ponse cette requ te H2EPAYMENT renvoie un document au format XML du type lt xml version 0 gt lt ncresponse orderlD 99999
13. aire 10 2 Administration des paiements Cette fonction permet de requ rir automatiquement depuis l application du marchand les transactions d administration disponibles via le module d administration de H2EPAYMENT La fonction d administration permet de requ rir des remises paiement ou d annuler des commandes autoris es Les requ tes de remise paiement ne sont utilis es que par les marchands qui ont configur leur abonnement pour effectuer HAPPYDOO Ecom Doc d int gration 30 06 2009 19 25 leurs paiements en 2 tapes autorisation puis remise ou qui ont utilis l option Operation RES 10 2 1 Initier une transaction d administration La proc dure et les contr les de s curit sont similaires ceux d une requ te pour une nouvelle commande L URL vers laquelle la requ te est faite est https www h2epayment com backoffice tools maintenance php La diff rence r side dans les param tres donn s Nom du param tre NumSite Correspond votre identifiant marchand donn par H2EPAYMENT l ouverture du compte code num rique 935xxxx Password Mot de passe associ au NumSite crypt en MD5 Correspond votre num ro de commande unique R f rence unique de H2EPAYMENT permettant d identifier la PAYID transaction Montant x 100 exemple 123 pour 1 23 Si diff rent de la transaction initiale doit tre inf rieur ou gal et bas sur la m me devise que la devise Inititiale Operation ____
14. ase 1 Saisie de vos informations bancaires Veuillez v riher ou modfer les informations suivantes Informations concernant votre banque Informations concernant le titulaire du compte Nom de l banque SLA Taulare CERTES Adresse 4 pus Adresse T Code postal qrp Code posta EL Ville vos Ville ete Informations concernant le compte d biter Code banque Code guichet Num ro de Compte Cl RIB S chiffres chiffres 11 ch fres ou lettres 2 chiffres Phase 2 Code de contr le et validation Retapez ce code visuel de contr le er t A 153439 hide Oui je confirme ma commande Rappel de la commande Marchand Formule d Abonnement G Votre ID vous sera comr iqu par email apr dat paiement Total payer 10 00 EUR Type Abonnement For Gold 10 00 EUR valable 1 m portbr de l date d encmssement de votre paiement odart de r shang Termin d intenet les coordonn es postales de sa banque pr remplies automatiquement si l usager a d j pay par pr l vement les coordonn es postales de son domicile pr remplies automatiquement si l usager a d j pay par pr l vement les informations RIB remplir dans tous les cas un code visuel de contr le pour limiter la Fraude Une fois valid nous appliquons nos r gles anti fraude puis nous affichons une demande d autorisation de pr l vement Nous invitons l usager imprimer remplir et nous envoyer ce document Un bouton en ba
15. cond abonnement x 100 exemple 123 pour 1 23 Description de la commande affich e lors du paiement et sur la facture peut comporter des balises HTML longueur libre Adresse de l usager 255 car max seconde partie Etat de l usager 50 car max Fax du client 19 car max Code de l affili apportant ce client ExtraFields Vide Param tres par d faut du marchand RES Autorisation seule SAL Vente directe imm diate Param tres personnalisables Ces param tres pourront tre pass s sous forme de tableau ex ExtraFields clef1 valeur1 amp ExtraFields clef2 valeur2 Ces infos seront retourn es dans les URLRetourAuto URLRetourOK URLRetourKO sous la forme clefi valeurti amp clef2 valeur2 Ces infos n tant pas stock es en base de donn es elles ne pourront tre utilis es que pour les paiements Online CB HAPPYDOO Ecom Doc d int gration 30 06 2009 7 25 Param tre obligatoire si vous envoyez le param tre Signature DONNEES FACULTATIVES d apparence de la page de saisie BGCOLOR Couleur de fond BLTXTCOLOR Couleur de texte des Tables UTTONBGCOLOR Couleur de fond des Boutons UTTONTXTCOLOR Couleur de texte des Boutons FONTTYPE Police defaut Verdana LeftMenu Menu de gauche permettant de rappeler la charte graphique du marchand Menu de droite permettant de rappeler la charte FC ENT graphique du marchand IMPORTANT _AREACOLOR Couleur de fond pour les zones imp
16. depuis l application du marchand le statut d un paiement 10 1 1 initier une demande de statut L URL vers laquelle la requ te est faite est https www h2epayment com backoffice tools status php Nom du param tre Correspond votre identifiant marchand donn par H2EPAYMENT l ouverture du compte code num rique 935xxxx NumsSite Password Mot de passe associ au NumSite crypt en MD5 Correspond votre num ro de commande unique R f rence unique de H2EPAYMENT permettant d identifier la PAYID transaction NumSite et Password sont utilis pour identifier le marchand La commande originale peut tre identifi e par orderlD la r f rence originale du marchand ou PAYID la r f rence de H2EPAYMENT retourn e pour le paiement 10 1 2 R ponse la requ te En r ponse cette requ te H2EPAYMENT renvoie un document au format XML du type lt xml version 0 gt PAYID 1111111 STATUS OK NCSTATUS payment ok NCERROR NCERRORPLUS gt Avec orderlD Votre r f rence de commande initiale PAYID La r f rence du paiement H2EPAYMENT STATUS le r sultat de la requ te Pouvant prendre les valeurs OK paiement r ussi AA demande d autorisation r ussie 05 Erreur etc Les champs NCSTATUS NCERROR et NCERRORPLUS donnent des d tails sur l ventuel refus de paiement Ces messages sont g n r s soit par notre syst me anti fraude soit par la plateforme banc
17. ion Ce document vous explique le fonctionnement et la proc dure d installation de la solution de paiement ECOM de H2EPAYMENT sur votre site marchand Lexique H2EPAYMENT Nom du syst me de paiement ECOM Solution de paiement o la saisie des informations critiques est confi e H2EPAYMENT Webmaster Propri taire du site marchand Usager Utilisateur final le porteur de la carte bancaire L acheteur d un produit ou d un abonnement sur un site marchand BackOffice outil d administration disponible cette adresse https www h2epayment com backoffice HAPPYDOO Ecom Doc d int gration 30 06 2009 1 25 2 Pr sentation La solution ECOM est fond e sur une m canique o la saisie des informations de paiement critiques N de carte bancaire ou de compte pour le pr l vement est effectu e sur le serveur s curis de H2EPAYMENT Serveur Cr ation du d autorisation anier d achat Page saisie CB SSL AntiFraude Carte Validation Analyse r ponse commande Et envoi d email Confirmation fin Page confirmation de commande de paiement Exemple de processus de paiement avec panier d achat chez le marchand et paiement par carte bancaire de l usager L gende 1 Appel par le site Marchand d une URL sur notre serveur www h2epayment com pour initialiser le processus de paiement avec passage de variables concernant la commande la session utilisateur le look la s curit 2 Saisie par l
18. ires la suite de votre URL en suivant la notation normalis e clef1 val1 amp clef2 val2 Cette URL est appel e syst matiquement quand un paiement est r ussi un paiement est chou une demande d autorisation est r ussie ou chou e selon votre configuration de site De plus pour les sites qui g rent des abonnements quand un renouvellement a r ussi nouveau paiement r ussi un renouvellement a chou nouveau paiement chou l abonnement arrive expiration date de fin atteinte Lors d un renouvellement chou ou r ussi si un paiement est tent carte bancaire valide un seul appel de l URL retour auto sera effectu avec les param tres de paiements et d abonnements Nom du param tre Envoy syst matiquement Correspond votre identifiant marchand donn par H2EPAYMENT l ouverture du compte code num rique Correspond votre num ro de commande IDUsager R f rence unique de l Usager Email Email de l usager Variable de Session du site marchand si fournie au MerchantSession ou nom que d part vous avez d fini dans le Param tre envoy uniquement lors d un paiement BackOffice online Pour un paiement offline ou un renouvellement ce param tre n est pas envoy Envoy seulement si l v nement est associ un paiement OK en erreur ou renouvellement Montant x 100 exemple 123 pour 1 23 Permet un contr le votre niveau sur
19. ite Avec votre navigateur Internet allez l adresse suivante https www h2epayment com backoffice e Cliquez sur Nouveau Webmaster e Remplissez le formulaire et cliquez sur Enregistrer Remarque lors de votre enregistrement Si vous avez un site d abonnements et souhaitez que la gestion des formules soit r alis e par H2EPAYMENT n oubliez pas de renseigner vos formules d abonnements libell s montants dur es etc amp Votre compte restera en mode test paiement simul sur serveur non connect au r seau bancaire tant que vous n aurez pas retourn le contrat sign par fax 33 556122316 et que vous n aurez pas demand l activation en production de votre site 3 1 Faites votre premier test de paiement Avec votre navigateur Internet allez l adresse suivante https www h2epayment com backoffice testpayecom php Cette adresse est aussi accessible via l outil de gestion https www h2epayment com backoffice dans le menu de gauche lien Test site Cette page simule la requ te http faite par votre application D s que votre compte est activ vous pouvez utiliser ce formulaire pour faire un test de paiement et vous assurer que votre compte est correctement configur e Remplissez le manuellement avec vos propres donn es votre NumSite votre Mot de passe en clair une r f rence unique OrderlD un montant multipli par 100 Amount le code ISO de la devise e Laissez les champs option
20. ndiquer les modalit s de paiement ordre et adresse du ch que nos informations RIB pour un virement etc amp mail obligatoire Une fois le paiement r ellement effectu En cas de paiement fructueux Un email est envoy l usager pour lui confirmer l achat pour un abonnement nous envoyons alors les codes d acc s la zone membre du site marchand mail optionnel Dans tous les cas H2EPAYMENT appelle l URL retour automatique en HTTP ou HTTPS en GET ou POST selon votre param trage pour que le webmaster puisse mettre jour sa base de donn e appel optionnel 8 4 Appel serveur marchand Validation Commande L URL de retour automatique param tr e dans l administration H2EPAYMENT pour le site marchand est appel e apr s l analyse du r sultat de la transaction et quelque soit ce r sultat Pour plus de d tails veuillez consulter le chapitre URL Retour Automatique ci dessous HAPPYDOO Ecom Doc d int gration 30 06 2009 15 25 Le r sultat de cet appel n est pas fourni au visiteur du site il ne sert donc logiquement qu a permettre au marchand de valider la commande initiale en fonction des r ponses fournies par H2EPAYMENT et ventuellement envoyer un mail au visiteur acheteur pour lui confirmer l tat de sa commande ou lui envoyer des codes d acc s Le retour r el se fera par les URL de Retour d critent dans le chapitre suivant 8 5 Retour au site Marchand Confirmation de fin de c
21. nels vides pour l instant e Cliquez sur Go Vous devriez recevoir comme r ponse une page de saisie de carte bancaire permettant de finaliser la transaction Vous pouvez saisir des infos r elles de carte bancaire votre site tant en test aucun d bit ne sera effectu sur votre carte En validant le formulaire de saisie des infos bancaires vous arrivez sur la page r sultat qui vous indique si le paiement s est bien pass ou non Vous pouvez consulter votre nouveau paiement dans le module d administration de H2EPAYMENT e Allez https www h2epayment com backoffice e Connectez vous entrez votre NumSite et votre mot de passe e Cliquez sur Paiements dans le menu de gauche e Entrez vos crit res de s lection et visualisez vos paiements HAPPYDOO Ecom Doc d int gration 30 06 2009 4 25 4 Integration dans votre application Deux m thodes vous sont propos es pour int grer notre solution La m thode expresse pour uneint gration simple et rapide la m thode volu e pour int gration personnalis e 4 1 M thode expresse Cette m thode est destin e aux webmasters qui souhaitent que H2EPAYMENT g re la totalit des choix de l usager Elle n est disponible que pour les sites de gestion d abonnements et si les formules ont t saisies sur notre BackOffice Seront affich s La liste des formules d abonnements d apr s votre saisie dansle BackOffice Le choix des moyens de paiements
22. oc d int gration 30 06 2009 5 25 lt FORM gt 4 2 M thode volu e Cette m thode est destin e aux webmasters qui souhaitent g rer la totalit ou une partie des donn es n cessaire notre interface de paiement Elle doit tre utilis e pour les sites de vente de produits ou pour les sites de gestion d abonnement dont les formules ne sont pas renseign es sur notre BackOffice M thode POST fortement conseill e Cr ez une page HTML sur votre site et ins rez un code de ce type lt FORM name goPaymentProcessor method POST action https www h2epayment com prod ecom_menu php gt lt input type hidden name NumSite value votre numSite gt lt input type hidden name Password value votre mot de passe crypte en md5 gt lt input type hidden name orderlD value votre numero de commande ou formule gt lt input type hidden name Amount value montant en _centime gt lt input type hidden name Currency value devise gt lt input type hidden name Language value langue a _utiliser gt lt input type hidden name PaymentMethod value methode de paiement gt lt input type hidden name Signature value signature en md5 gt lt input type hidden name EMAIL value email_usager gt lt input type hidden name CustLastName value nom usager gt lt input type hidden name CustFirstName value prenom_usager gt lt input type hidden name CustAddressi value adre
23. ommande Une page de r sultat sera propos e par H2EPAYMENT pour avertir le client du r sultat de la transaction Cette page prendra alors le look indiqu dans les param tres pass s lors de l appel initial Elle contiendra un message indiquant le r sultat de la transaction et un lien pour retourner sur le site marchand Ce lien sera selon la valeur de TransStatus l un des liens enregistr s dans les param tres du site par le BackOffice URL_Retour_00 Retour pour les paiements accept s URL_Retour_ AA Retour pour les paiements en attente accept s mais dont la vente r elle est en attente de confirmation URL_Retour_05 Retour pour les paiements refus s Chacun des liens utilisant les URLS de retour sera accompagn des m mes param tres que ceux utilis s pour la Validation de commande en mode POST ou GET selon param trage HAPPYDOO Ecom Doc d int gration 30 06 2009 16 25 9 Url retour automatique L URL de retour automatique si elle est renseign e est appel e d s qu un v nement paiement ou abonnement se produit Vous pouvez renseigner et param trer cette URL dans le Backoffice H2EPAYMENT Pour tre au plus proche de la configuration de votre serveur vous pouvez d terminer la m thode GET POST le protocole HTTP ou HTTPS un user password Apache si vous protegez votre programme par un htaccess un format de sortie param tres de l URL ou en XML des donn es suppl menta
24. onses des acqu reurs CB sont simul es Vous pouvez simuler les diff rentes r ponses possibles accept refus en modifiant le CVC de la carte Tous les codes CVC retournent une r ponse de transaction OK hormis la liste suivante e CVC 500 Fonds insuffisants e CVC 501 Autorisation rejet e e CVC 502 Transaction invalide e CVC 503 Carte retenue conditions sp ciales e CVC 504 Paiement refus par la banque de l acquereur e CVC 505 num ro de marchand invalide e CVC 600 Carte vol e e CVC 601 Carte expir e e CVC 602 Pas dans la liste autoris e e CVC 603 Suspiscion de fraude e CVC 604 Tentative infructueuse r p t e e CVC 605 Carte retenue e CVC 606 Carte perdue e CVC 607 Carte vol e e CVC 700 Echec de communication e CVC 701 Une erreur technique est survenue merci de contacter la hotline Vous pouvez utiliser les cartes de test list es dans le tableau ci dessous Type de Carte Num ro Master Card 5431111111111111 Visa 111111111111111 American Express JCB 088000000000017 Attention ceci fonctionne partir du moment o le paiement aura pass les barri res anti fraudes de notre syst me carte valide non black list e HAPPYDOO Ecom Doc d int gration 30 06 2009 9 25 6 R solution des probl mes de base Des probl mes peuvent survenir du fait que les donn es que nous recevons de votre application ne correspondent pas aux param
25. ortantes 4 4 Signature Pour chaque commande le serveur du marchand g n re une cha ne de caract res unique hach e en appliquant l algorithme de Hashing MD5 d velopp par RSA Data Security Inc MD5 Message Digest Algorithm Si la Phrase Signature a t sp cifi e dans les param tres techniques du BackOffice H2EPAYMENT v rifie s il a re u une signature dans la requ te de paiement Si oui il v rifie si les donn es de la commande correspondent bien la signature unique En cas d chec du contr le le message d erreur suivant est affich Signature inconnue Ce contr le permet de s assurer de l exactitude et l int grit de la commande pour emp cher par exemple une modification du prix par un usager malveillant Cette cha ne est construite partir des champs orderlD amount Currency NumSite Operation du paiement ainsi que d une cha ne suppl mentaire phrase cl que le marchand d finit dans le param trage de son site Pour g n rer la signature il suffit de concat ner les champs ci dessus Signature orderlD amount currency NumSite Operation PhraseCl Exemple orderlD 18864 amount 1799 currency EUR NumSite 9351234 Operation SAL PhraseCIl tulipe Cha ne crypter en md5 188641799EUR9351234SAl tulipe soit bOb75989b0e006b62633401814939f09 HAPPYDOO Ecom Doc d int gration 30 06 2009 8 25 5 Simuler un paiement en test Dans l environnement de Test les r p
26. s de cette page lui permet de retourner vers le site marchand L url de retour peut varier selon votre param trage dans le BackOffice Un email est envoy au webmaster pour lui confirmer le paiement mail optionnel HAPPYDOO Ecom Doc d int gration 30 06 2009 Une fois le pr l vement effectu En cas de paiement fructueux Un email est envoy l usager pour lui confirmer l achat pour un abonnement nous envoyons alors les codes d acc s la zone membre du site marchand mail optionnel Dans tous les cas H2EPAYMENT appelle l URL retour automatique en HTTP ou HTTPS en GET ou POST selon votre param trage pour que le webmaster puisse mettre jour sa base de donn e appel optionnel 8 3 Paiement par ch que mandat postal virement F Paiement par ch que Microsoft Internet Explorer EEK Pher Edtion Affchoge Favoris Qut s 2 p Nr A x m i R glement par ch que Marchand Formule d Abonnement Votre ID Total payer 10 00 EUR Type Abonnement Nous appliquons nos r gles anti fraude puis nous affichons une page r capitulative lui indiquant qu il recevra par mail les modalit s de paiement Un bouton en bas de cette page lui permet de retourner vers le site marchand L url de retour peut varier selon votre param trage dans le BackOffice Un email est envoy au webmaster pour lui confirmer le paiement mail optionnel Un email est envoy l usager pour lui i
27. s ne disposez pas de votre propre VAD compte bancaire de Vente A Distance Type de carte facultatif utilis par l acheteur Ce code peut tre envoy seulement avec un PaymentMethod CB Si ce code n est pas envoy la liste des types de cartes possible sera propos e l acheteur Code possible V Visa E EurocardMastercard J JCB D Dinners A Amex Cette cha ne est construite partir des valeurs des champs orderlD Amount Currency NumSite Operation de la requ te de paiement et d une cha ne suppl mentaire Phrase cl que le marchand d finit dans les param tres de son site Voir explications ci dessous Email de l usager Nom de l usager 50 car max Pr nom de l usager 32 car max Adresse de l usager 255 car max premi re partie CustZIP ustCity ustCountry ustTel MerchantSession ubscriptionPeriod SubscriptionPeriod2 SubscriptionAmount2 OrderDetail ustAddress2 ustState ustFax Code Postal de l usager 30 car max Ville de l usager 64 car max Pays de l usager code ISO du pays sur 2 car T l phone de l usager 19 car max Variable de Session du site marchand restitu e au retour apr s paiement pour permettre une r cup ration du contexte session utilisateur sur le site du marchand Dur e de l abonnement 1 0 pour un mois 0 03 pour 3 jours Dur e de l abonnement qui suivra le premier 1 0 pour un mois 0 03 pour 3 jours Montant du se
28. sse usager gt lt input type hidden name CustZIP value code postal _usager gt lt input type hidden name CustCity value ville usager gt lt input type hidden name CustCountry value pays usager gt lt input type hidden name CustTel value telephone usager gt lt input type submit name submitButton value ACCES PAIEMENT gt lt FORM gt 4 3 Liste des param tres disponibles DONNEES OBLIGATOIRES Nom du param tre Correspond votre identifiant marchand donn par NumSite H2EPAYMENT l ouverture du compte code num rique 935XXXX Password Mot de passe associ au NumSite crypt par la fonction MD5 DONNEES FACULTATIVES Nom du param tre lorderlD Correspond votre num ro de commande unique Amount Montant x 100 exemple 123 pour 1 23 ALPHA ISO code de la monnaie 3 car Currency CAD EUR USD GBP JPY AUD DKK HKD NZD SGD SEK CHF BRL HAPPYDOO Ecom Doc d int gration 30 06 2009 6 25 PaymentMethod MAIL ustLastName ustFirstName ALPHA ISO code de la langue du client Cf annexe Si la langue est inconnue nous utiliserons l anglais Moyen de paiement utilis par l acheteur PP paiement par compte pr pay e CB paiement par carte bancaire CQ pour un paiement par ch que VI pour un paiement par virement PR pour un paiement par pr l vement automatique Le code PP doit tre utilis pour du paiement CB si vou
29. sur le serveur H2EPAYMENT com et la base de transaction mise jour En cas de paiement fructueux Un ticket de paiement est envoy par mail l usager pour lui confirmer le d bit mail obligatoire Un email est envoy l usager pour lui confirmer l achat pour un abonnement nous envoyons alors les codes d acc s la zone membre du site marchand mail optionnel Un email est envoy au webmaster pour lui confirmer le paiement mail optionnel Dans tous les cas H2EPAYMENT appelle l URL retour automatique en HTTP ou HTTPS en GET ou POST selon votre param trage pour que le webmaster puisse mettre jour sa base de donn e appel optionnel Une page r capitulative est affich e l usager avec un bouton pour qu il retourne vers le site marchand L url de retour peut varier selon votre param trage dans le BackOffice HAPPYDOO Ecom Doc d int gration 30 06 2009 13 25 8 2 Paiement par pr l vement J Happydoo Microsoft Internet Explorer L usager est invit saisir Echier Eain Affichage Faos Qutis a Gal A g A 3 j J x p j Rechercher Favoris 4 Gr B S AD i Bij ptim R glement par pr l vement Vous allez mantenant effectuer la transaction s c sr protocole SSL la pr sence du cadenas PE tre mav tat de la connexon s curis e est une plateforme de paiement pendante du site diteur Le site diteur a ch us pr r serice de connexion s curis Ph
30. tique est survenue merci de Erreur syst me renouveler votre paiement ult rieurement Montant d cimal non accept Le montant fourni poss de un caract re refus par notre syst me La monnaie fournie ne correspond pas une devise g r e dans notre Monnaie non accept e P syst me Signature incorrecte La signature est incorrecte par rapport aux autres donn es fournies HAPPYDOO Ecom Doc d int gration 30 06 2009 10 25 PaymentType 01 re u alors que votre site est enregistr en gestion d abonnement PaymentType 02 re u alors que votre site est enregistr en vente de produit Infos compl mentares pour ce site introuvables Une formule avec un abonnement suivant ne peut tre pay que par Carte Bancaire Le champs SubscriptionPeriod est obligatoire pour un abonnement Le param tre PaymentType a t envoy 01 vente de produit alors que votre site g re des abonnements d apr s vos informations du BackOffice Le param tre PaymentType a t envoy 02 abonnement alors que votre site vend des produits d apr s vos informations du BackOffice Les donn es compl mentaires n cessaires pour utiliser cette interface sont manquantes dans notre base Vous tentez de payer un abonnement par un moyen de paiement diff rent de la carte bancaire Or la formule s lectionn e poss de une redirection vers une abonnement suivant Ce type de formule ne peut tre r gl e q
31. ts abonnements ce param tre est donc refus Vous demandez un moyen de paiement qui n a pas t autoris pour ce site Param tre PaymentMethod ronn pour votre site voir configuration dans le BackOffice Pas d abonnement trouv pour ce site de gestion Vous demandez au connecteur d afficher vos formules d abonnement or d abonnement vous n en n avez pas enregistr sur notre syst me via le BackOffice Les donn es compl mentaires n cessaires pour utiliser cette interface sont manquantes dans notre base Infos compl mentaires pour ce site introuvables Ce site n est plus g r par H2EPAYMENT Votre contrat ou votre site est arr t Ce site n est pas param tr pour faire de l ECOM Votre contrat ne vous autorise pas utiliser l interface ECOM Amount doit tre lt 800 euros Le montant de la transaction ne peut pas d passer 800 Euros Format d email incorrect L email doit avoir un format correct xxxx xxxx xx Vous semblez avoir d j un abonnement actif sur gt 7 We L adresse email fourni a d j un abonnement actif sur le m me site ce site avec l identifiant Impossible de generer un ID Une erreur interne a emp ch la g n ration de l IDUsager Ce site n est plus g r par H2EPAYMENT Votre contrat ou votre site est arr t Erreur de param tre ou session expir e merci de se La session utilisateur a expir ou un param tre est ronn renouveler votre paiement ult rieurement Une erreur cri
32. ue par carte bancaire Votre site est enregistr chez nous comme gestion d abonnement mais vous ne nous avez pas envoyez de champs SubscriptionPeriod HAPPYDOO Ecom Doc d int gration 30 06 2009 11 25 7 Comment passer d un compte de test un compte de production L activation de votre compte se fait en deux temps De notre c t d s votre inscription nous suivons votre dossier pour valider les t ches administratives et contractuelles Pendant ce temps vous pouvez int grer notre syst me de paiement D s que nos services ont valid votre dossier vous pouvez basculer votre compte en production C est vous qui basculez via le Backoffice quand bon vous semble Vous tes alors pr t encaisser des paiements 7 1 URL de test Attention ind pendemment de l activation de votre compte nous proposons nos marchands 2 urls d acc s notre plateforme e L URL de production https www h2epayment com prod ecom_ menu php si votre compte est activ les paiements sont r els si votre compte n est pas encore activ les paiements sont fictifs e L URL de test https www h2epayment com test ecom_menu php Utilisable tout moment pour simuler l appel notre platefrome avec des paiements fictifs Cette URL vous permet de tester la mise en place d une nouvelle page de paiement sans interrompre le fonctionnement de votre site HAPPYDOO Ecom Doc d int gration 30 06 2009 12 25 8

le manuel d`installation

Contents

Download Pdf Manuals

Related Search

Related Contents