Manuel d`installation et Paramétrage
Contents
1. des tiers sans autorisation Paybox Remote MPI Version 6 0 27 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 7 A Paybox Remote MPI Version 6 0 28 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 7 A Paybox Remote MPI Version 6 0 29 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 1743 PARes the element Purchase currency has not the same value as the one in the PAReq PARes the element Purchase exponent has not the same value as the one in the PAReq 1753 Signature SignedInfo Reference URI has a bad format 1803 Error the element errorCode is not valid 1754 Signature SignedInfo Reference DigestValue not found 1901 PATransRegq the element PATransRegq is not found 1902 PATransReg the element version is not valid 1903 PATransReg the element Merchant name is not valid 1904 PATransReg the element Merchant country is not valid 7 A Paybox Remote MPI Version 6 0 30 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 7 A Paybox2. 1 INTRODUCTION 5 2 OBJET DU DOCUMENT 6 3 PRESENTATION DE LA SOLUTION PAYBOX REMOTE MPI 7 3 1 LE MPI ET 3 D SECURE 7 3 2 LISTE DES MOYENS DE PAIEMENT 8 3 3 SECURITE 9 4 PROTOCOLE D ECHANGE 10 4 1 APPEL 10 4 2 REPONSE 11 5 CINEMATIQUE D UN PAIEMENT 3 D SECURE AVEC PAYBOX DIRECT 12 6 SUPPORT ASSISTANCE CONTACT 15 6 1 ACCES 15 6 2 FONCTIONS 15 6 3 PROCEDURE D INSCRIPTION 16 7 ENVIRONNEMENT DE TESTS 17 8 DICTIONNAIRE DE DONNEES 18 8 1 VARIABLES D APPEL PAYBOX REMOTE MPI 19 8 2 VARIABLES REPONSES PAYBOX REMOTE MPI 21 9 ANNEXES 24 9 1 CODES ERREUR 24 9 2 URL D APPEL ET ADRESSES IP 35 9 3 GLOSSAIRE 36 Paybox Remote MPI Version 6 01 4 Manuel d int gration Date 05 06 2043 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 1 INTRODUCTION Paybox Point Transaction Systems a d velopp et exploite sa propre plateforme pour assurer l interface entre diff rentes sources de paiements et de services moyen d acquisition et les destinations op rateurs financiers bancaires partenaires m tiers Banques amp Op rateurs Financiers Serveurs d autorisation Serveurs de t l collecte AGREMENTS PAIEMENTS T l param trages MULTI CANAL lz MULTI SERVICES PCI Paiements Alternatifs Paybox Powered by VeriFone l CONTRATS E
3. 3 D Secure 2 Paybox redirige l internaute sur la page d authentification de la banque mettrice de la carte sur laquelle il doit saisir un code personnel pour s authentifier Les r gles dict es par VISA et Mastercard concernant le transfert de responsabilit ou bien Garantie sont bas es sur le r sultat de ces changes Paybox restitue syst matiquement pour chaque paiement le r sultat de ces changes Pour plus d informations consultez notre fiche d information Ref 4 lt Fiche pr sentation 3 D Secure gt 9 3 2 Encodage URL url encod Tous les caract res ne sont pas autoris s dans les URL voir la d finition de URL ci dessous L encodage URL permet de transformer certains caract res sp ciaux afin que les donn es puissent tre transmises Exemple lt gt devient lt 21 gt lt gt devient lt 40 gt Des fonctions sont disponibles dans la plupart des langages afin de faire la conversion urlencode et urldecode peuvent tre utilis es en PHP par exemple y Paybox Remote MPI Version 6 0 36 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 9 3 3 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 ordinateur un autre selon le mod le client serveur 9
4. L adresse IP entrante est l adresse sur laquelle le syst me d information du Marchand va se connecter pour r aliser la transaction L adresse IP sortante est l adresse avec laquelle le syst me d information du Marchand verra arriver les flux de retour en fin de transaction appels de URL HTTP par exemple Il est important que ces adresses entrantes et sortantes soient autoris es dans les ventuels filtres sur les adresses IP param tr s sur les infrastructures h bergeant les syst mes d information du Marchand PLATE FORME ADRESSE ENTRANTE ADRESSE SORTANTE Pr production 195 101 99 73 194 2 160 66 Secours 9 195 225 7146 Paybox Remote MPI Version 6 0 35 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 9 3 Glossaire 9 3 1 3 D Secure Le protocole 3 D SECURE a t mis en place par VISA et MASTERCARD pour r pondre la probl matique de r pudiation Si le titulaire d une carte bancaire conteste un achat r alis sur Internet le marchand qui utilise le service 3 D Secure a alors les moyens de prouver que le porteur de la carte est bien l acheteur Le protocole 3 D Secure se concr tise par une phase d authentification du porteur de la carte avant le paiement en cas d chec de l authentification du porteur le paiement n est pas effectu La banque mettrice de la carte
5. Remote MPI Version 6 0 31 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 7 A Paybox Remote MPI Version 6 0 32 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 5127 An error occured during the validation of the xml signature parse and validate of it Paybox Remote MPI Version 6 0 33 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 5144 Authentication was not successfull 10000 Unspecified error occured 5145 Error Getting VEReq out of transaction cache 5146 Received status U 5147 Received an Error message instead of a PARes Tableau 3 Codes r ponses du MPI 7 A Paybox Remote MPI Version 6 0 34 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 9 2 URL d appel et Adresses IP ae Pour utiliser les services PAYBOX Remote MPI PLATE FORME URL D ACCES Pr production https preprod tpeweb paybox com cgi RemoteMPI cgi https tpeweb paybox com cgi RemoteMPI cgi Secours __ https tpeweb1 paybox com cgi RemoteMPI cgi
6. VARIABLE QUESTION REPONSE RESUME x mm Montara ands anor O aa CVVCode Cryptogramme visuel IdMerchant 9969 Identifiant commer ant fourni par Paybox Identifiant de session unique URL de retour serveur serveur SE URL de retour depuis le navigateur du client IdSession URLHttpDirect URLRetour 3DCAVV _ gt x Valeur re ue des ACS 3DCAVVALGO Identifiant de l algorithme ayant servi l identification du porteur sur l ACS 3DECI E Commerce Indicator 3DENROLLED fo Etat de l enr lement du porteur x Xx 3DERROR Erreur renvoy e par le MPI C 6 5 O Sin dors tation D X maa 9 0 X Identifiant de contexte Paybox wa a ein Tableau 1 Liste des variables PAYBOX Remote MPI gt x x x X y A Paybox Remote MPI Version 6 0 18 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 8 1 Variables d appel PAYBOX Remote MPI 8 1 1 Amount Format Num rique Obligatoire Montant total de la transaction en centimes sans virgule ni point Vous devez obligatoirement d finir le m me montant pour la demande d authentification Remote MPI et pour la demande d autorisation Paybox Direct Exemple pour 19 9
7. aussi r cup rer le contenu de la variable ID3D en retour de RemoteMPI et transmettre cette variable dans la requ te Paybox Direct D L appel Paybox Direct doit tre fait imm diatement apr s le retour du MPI Pass un d lai de 5 minutes l authentification sera consid r e expir e et Paybox n effectuera pas la demande d autorisation en mode 3 D Secure Dans le cas d un mauvais passage de param tres au CGI seuls les champs IdSession StatusPBX et Check sont renvoy s lorsque les v rifications des param tres et notamment de l IdMerchant sont probantes Paybox Remote MPI Version 6 0 11 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 5 CINEMATIQUE D UN PAIEMENT 3 D SECURE AVEC PA DIRECT Acqu reur Directory Server Commer ant PAYBOX Banque du ACS Banque du commer ant porteur Internaute Acheteur a Q e c S 2 o s 9 L lt Paiement Paybox Remote MPI Version 6 0 Manuel d int gration Date 28 08 2013 12 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation ETAPE IMPACT DESCRIPTION COMMERCANT L acheteur passe une commande sur le site Web du commer ant L acheteur saisit ses informations carte PAN date d expiration cr
8. des tiers ou toute communication des tiers est interdite sans accord pr alable de Paybox Point Transaction Systems Si vous d couvrez une erreur dans cette documentation vous pouvez nous envoyer un email aux adresses mail ci dessous en d crivant l erreur ou le probl me aussi pr cis ment que possible Merci de pr ciser la r f rence du document et le num ro de page INFORMATION Pour tout renseignement nos Equipes restent disposition des Commer ants et Int grateurs du lundi au vendredi de 9H 18H Service Commercial E mail contact paybox com T l phone 33 0 1 61 37 05 70 ASSISTANCE Pour tout renseignement ou assistance l installation et l utilisation de nos produits nos Equipes restent disposition des Commer ants et Int grateurs du lundi au vendredi de 9H 12H30 et 14H 18H30 17H30 le vendredi Support Technique amp Fonctionnel E mail support paybox com T l phone 33 0 4 68 85 79 90 Pour tout contact aupr s de nos services il faut IMPERATIVEMENT communiquer les identifiants Paybox e num ro de SITE 7 chiffres e num ro de RANG 2 chiffres e num ro d identifiant PAYBOX 1 9 chiffres y Paybox Remote MPI Version 6 01 3 Manuel d int gration Date 05 06 2043 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation TABLE DES MATIERES
9. effectu via le produit PAYBOX Direct STATUSPBX DESCRIPTION Envoy dans le cas d un incident propre aux traitements PAYBOX Erreur Paybox L authentification du porteur a chou et la demande d autorisation n est pas effectuer faut recommencer la demande d authentification Envoy apr s la proc dure d authentification indiquant que le paiement Autorisation faire pourra tre r alis apr s une demande d autorisation Envoy apr s la proc dure d authentification indiquant que le paiement Autorisation ne pas faire ne pourra pas tre r alis avec succ s et qu une demande d autorisation n est pas effectuer car l authentification du porteur a chou Envoy lorsqu il n y a pas eu de retour du porteur apr s la demande Timeout d authentification au del de 5 minutes 8 2 3 ID3D Format jusqu 20 chiffres Identifiant de contexte PAYBOX contentant les donn es d authentification retourn es par le MPI Ce contexte d authentification est stock pendant une dur e de 5 minutes Au dela les applications de PAYBOX consid reront que la phase d authentification du porteur est non valide car en timeout Exemple 9900000000012 y Paybox Remote MPI Version 6 0 21 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 8 2 4 Check Format jusqu 256 caract res Sig
10. les Directory Serveurs VISA et MASTERCARD que la carte du porteur fait partie du programme 3 D Secure porteur dit lt enrdl gt Les messages sont le VEReq Verify Enrollment Request et le VERes Verify Enrollment Response 2 Si la carte fait partie du programme 3 D Secure un deuxi me change redirige le porteur vers le site d authentification de la banque mettrice de la carte Les messages sont le PAReq Payer Authentication Request et le PARes Payer Authentication Response Le r sultat de ces changes permettra ou non de poursuivre le paiement avec un appel au service PAYBOX DIRECT La conception du module PAYBOX Remote MPI a t pr vue pour r pondre a 2 crit res Rester fid le aux sp cifications VISA et MASTERCARD Les donn es en r ponse sont celles fournies par le MPI et retourn es au format d fini dans les sp cifications VISA et MASTERCARD Facilit l ad quation avec les interfaces PAYBOX DIRECT existantes Les donn es 3 D Secure n cessaires a la demande d autorisation sont stock es dans un contexte PAYBOX Un unique identifiant de contexte retourn par PAYBOX la fin de la session 3 D Secure est r introduit au niveau des interfaces PAYBOX DIRECT existantes et permet de r cup rer toutes les informations d authentification 3 D Secure du paiement en cours Cet identifiant de contexte ne concerne que les donn es d authentification 3 D Secure Il reste tout de m me n cessaire de
11. met au point un moyen d authentification du porteur et se rend responsable en cas d impay On parle de transfert de responsabilit de la banque du commer ant vers la banque du porteur de la carte est important pour le commer ant de v rifier avant l activation du service 3 D Secure que le contrat qu il d tient aupr s de sa banque est bien de type VADS Vente A Distance S curis e un simple contrat de type VAD ne permet aucun recours en cas d impay Paybox est une plate forme technique entre le commer ant et la banque aupr s de laquelle il a souscrit un contrat La demande d activation du service 3 D Secure peut maner aussi bien du commer ant que de sa banque qui en cas de fraude av r e peut exiger la mise en place du service Paybox est alors tenu d activer le service et den avertir la banque et le commer ant Une fois le service 3 D Secure activ tous les paiements ne b n ficient pas forc ment du transfert de responsabilit Le Back Office commer ant permet une visualisation de l tat des paiements 3 D Secure dans la colonne Garantie de l onglet journal Un d tail d crivant le r sultat de l authentification du porteur est galement pr sent sous la mention Statut Porteur 3 D Secure Le protocole 3 D Secure se d compose en 2 temps 1 Paybox v rifie si la carte du porteur fait partie du programme 3 D Secure aupr s de VISA ou Mastercard on dit alors que le porteur est inscrit au programme
12. renseigner en plus les param tres obligatoires et existants du service PAYBOX DIRECT cf Ref 1 ManuellntegrationPayboxDirect_V6 00_FR pdf y Paybox Remote MPI Version 6 0 7 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 3 2 Liste des moyens de paiement ae Ci dessous une liste compl te des moyens de paiement accept s par Paybox MOYEN DE PAIEMENT TYPE COMMENTAIRE MAESTRO Carte de d bit BANCONTACT Carte de d bit Carte locale belge MISTERCASH 3 D Secure obligatoire E CARTE BLEUE Carte de cr dit virtuelle Op r e par VISA France dynamique SOFINCO Carte de financement Carte de financement Cartes SURCOUF KANGOUROU FNAC CYRILLUS PRINTEMPS FINAREF CONFORAMA WEXPRY KADEOS Carte cadeau pr pay e 1EURO COM Financement en ligne Paiement CtoB et transfert LEETCHI Cagnotte en ligne 7 4 Paybox Remote MPI Version 6 0 8 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation MAXICHEQUE Ch ques cadeau Carte cadeau pr pay e ONEY Financement en ligne PAYBUTTON ING Paiement compte compte Paiement compte compte iDEAL 3 3 S curit 3 3 1 Identification N cessite un compte bancaire commer ant chez ING Belgique N cessite
13. 0 e 0000001990 Equivalent Paybox Direct MONTANT 8 1 2 CCExpDate Format Date MMAA Obligatoire Date de fin de validit de la carte Exemple 1213 d cembre 2013 Equivalent Paybox Direct DATEVAL 6 1 3 CCNumber Format 19 caract res Obligatoire Num ro de carte du porteur client sans espace Exemple 1111222233334444 Equivalent Paybox Direct PORTEUR 8 1 4 Currency Format 3 chiffres Obligatoire Code monnaie de la transaction suivant la norme ISO 4217 code num rique Exemples e Euro 978 e 5 Dollar 840 e CFA 952 Avant d effectuer un paiement en devises assurez vous que votre banque et que votre contrat l autorisent Equivalent Paybox Direct DEVISE 7 A Paybox Remote MPI Version 6 0 19 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 8 1 5 CVVCode Format 3 ou 4 caract res Obligatoire pour les questions de type 1 3 4 12 Cryptogramme visuel situ au dos de la carte bancaire Remarque Les cartes AMERICAN EXPRESS ont sur leur recto un CIN Card Identification Number sur 4 chiffres Exemple 123 Equivalent Paybox Direct CVV 8 1 6 ldMerchant Format Num rique Obligatoire Identifiant du commer ant fourni par Paybox lors de la souscription Exemple 2 8 1 7 ldSession Format jusqu 250 caract res Obligatoire Ident
14. 3 4 HTTP HTTP HyperText Transport Protocol est le protocole de base du Web utilis pour transf rer des documents hypertextes comme une page Web entre un serveur et un navigateur sur un poste Client 9 3 5 IP adresse IP L adresse IP IP pour Internet Protocol est l adresse unique d un ordinateur connect sur un r seau donn r seau local ou World Wide Web 9 3 6 SSL Le protocole SSL Secure Sockets Layer permet la transmission s curis e de donn es par exemple de formulaires ou pages HTML sur le Web et peut donc servir des transactions financi res en ligne n cessitant l utilisation d une carte de cr dit Un pirate qui lt couterait gt sur cette connexion ne pourrait pas d chiffrer les informations qui y circulent 9 3 7 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 Exemple http www maboutique com site bienvenue html Paybox Remote MPI Version 6 0 37 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation
15. Internet Marchand Les clients acheteurs sont redirig s automatiquement sur les pages de paiement multilingues h berg es par PAYBOX Ces pages sont personnalisables pour les harmoniser avec l identit graphique du site Marchand Paybox System r pond aux normes de s curit des paiements par carte sur les sites d e commerce en affichant une page SSL 128 bits et en utilisant le protocole 3DSecure si option souscrite PAYBOX DIRECT Paybox Direct assure le traitement des paiements de fa on transparente pour les clients acheteurs L application de vente du Marchand doit collecter les informations sensibles telles que le n de carte et les transmet Paybox via un dialogue s curis de serveur serveur Paybox Direct est galement utilis pour valider les encaissements des transactions pr alablement autoris es via Paybox system assurer des remboursements et annulations de serveur serveur PAYBOX DIRECT Plus Cette solution permet un commer ant de confier Paybox le stockage d une partie du n de carte d un client Paybox Direct Plus est particuli rement adapt aux process de d bits r currents et facilit s de paiement Les strat gies d achat en 1 clic sont galement couvertes PAYBOX TRAITEMENT PAR LOT Cette solution assure un dialogue par changes de fichiers structur s en mode off line entre le Commer ant et Paybox L application de vente du Marchand doit collecter les informations sensibles telles q
16. PAYBOX REMOTE MPI y l MANUEL D INTEGRATION f s AXX VERSION 6 01 05 06 2014 Da VeriFone HISTORIQUE DES MODIFICATIONS DATE VERSION DESCRIPTION AUTEUR 28 08 2013 Le Version initiale apr s refonte F MORNAND 05 06 2014 Changement de charte graphique REFERENCES DOCUMENTATIONS La plupart des documentations r f renc es ci dessous sont t l chargeables sur le site Web Paybox www paybox com REF DOCUMENT DESCRIPTION Ref 1 ManuellntegrationPayboxDirect_V6 02_FR pdf Manuel d int gration de la solution Paybox Direct Ref 2 ParametresTestPaybox_V6 01_FR pdf Manuel d crivant les environnements et param tres de test pr production Ref 3 ManuellntegrationPayboxSystem_V6 01_FR pdf Manuel d int gration de la solution Paybox System Ref 4 GUIDE_UTILISATEUR_BACK_OFFICE_COMME Manuel Utilisateur du Back Office RCANT_PAYBOX doc Commergant Ref 5 PAYBOX Fiche pr sentation 3DSecure pdf Fiche de pr sentation 3 D Secure int r t pour le commer ant et liste de questions r ponses y Paybox Remote MPI Version 6 01 2 Manuel d int gration Date 05 06 2043 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation AVERTISSEMENT Ce document est la propri t exclusive de Paybox Point Transaction Systems Toute reproduction int grale ou partielle toute utilisation par
17. T PROFILS MONETIQUES __ REPORTING HISTORISATION Partenaires M tiers Cartes cadeau amp pr pay es Fid lit Services valeur ajout e FRAUD MANAGEMENT GESTION DES PROFILS UTILISATEURS SERVICES II s agit d une plateforme multi canal et multi services gt Multi canal la plateforme Paybox accepte diff rents syst mes d acc s autant physiques paiement de proximit que distants VAD E Commerce Site web marchand Terminal de Paiement Electronique ou ligne de caisse d un magasin ou d une enseigne Automate de distribution T l phone mobile ou PDA Centre d appels centre de saisie serveur vocal interactif gt Multi services la plateforme Paybox g re une multitude de moyens de paiement e cartes bancaires e cartes privatives e cartes de cr dit mais elle g re galement de nombreux services et applications m tiers e 165 cartes cadeaux e les cartes de fid lit e la gestion de flotte e la r servation de v hicules f Paybox Remote MPI Version 6 0 5 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 2 OBJET DU DOCUMENT Dans le domaine de la VAD et du E Commerce Paybox propose plusieurs solutions avec chacune des interfaces techniques sp cifiques gt PAYBOX SYSTEM Paybox System s interface avec le site
18. age de l authentification par l metteur e e e e U Authentification n a pas pu tre r alis e pour raison technique 8 2 12 3DXID Format jusqu 28 caract res R f rence provenant du MPI Exemple 1111222233334444 Paybox Remote MPI Version 6 0 Manuel d int gration Date 28 08 2013 pa Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 9 ANNEXES 9 1 Codes erreur 9 1 1 Codes erreur du programme Remote MPI Le CGI v rifie l ensemble des param tres envoy s et affiche un num ro d erreur le cas ch ant Voir tableau ci dessous Ce message d erreur est sans rapport avec un retour en erreur du MPI I n y a pas de v rification sur la validit des URLs URLRetour et URLHttpDirect SIGNIFICATION Erreur acc s au fichier de configuration interne Paybox Erreur absence num ro de porteur CCNumber Erreur type date expiration Erreur taille num ro de porteur 402 403 Erreur de taille du XID re u du MPI 410 Erreur absence de la r f rence marchand re ue du MPI 411 Erreur de type de la r f rence marchand 412 Erreur de type du code erreur Tableau 2 Codes r ponses du programme Remote MPI Paybox Remote MPI Version 6 0 24 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisatio
19. anque Pour les autres moyens de paiements le commer ant peut contacter le service commercial qui lui indiquera la proc dure suivre en fonction du des moyen de paiement souhait s Paybox Remote MPI Version 6 0 16 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 7 ENVIRONNEMENT DE TESTS Avant de commencer effectuer des paiements sur le site en production Paybox recommande au Commer ant de v rifier l int gration correcte des solutions Paybox Pour cela Paybox met a disposition des commer ants une plateforme de pr production ainsi que des comptes et des param tres de tests enti rement destin s la r alisation de tests Toutes les informations relatives cet environnement de tests sont pr cis es dans la documentation Ref1 ParametresTestPaybox_V6 01_FR pdf accessible en t l chargement ici hitp www1 paybox com espace integrateur documentation manuels 7 Paybox Remote MPI Version 6 0 17 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 8 DICTIONNAIRE DE DONNEES L ensemble des variables Paybox Direct est r sum e dans ce tableau Le d tail de chaque variable format contenu exemples est donn dans les pages qui suivent
20. appel via un formulaire HTML lt html gt lt body gt lt form action https preprod tpeweb paybox com cgi RemoteMPI cgi method post gt lt input name IdMerchant value 109518543 type hidden gt lt input name IdSession value DoC001 type hidden gt lt input name Amount value 1000 type hidden gt lt input name Currency value 978 type hidden gt lt input name CCNumber value 1111222233334444 type hidden gt lt input name CCExpDate value 1014 type hidden gt lt input name CVVCode value 123 type hidden gt lt input name URLRetour value https maboutique com retour php type hidden gt lt input name URLHttpDirect value https maboutique com retourDirect php type hidden gt lt input type submit gt lt form gt lt body gt lt html gt 7 A Paybox Remote MPI Version 6 0 10 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 4 2 R ponse Les donn es de retour se d composent en 2 ensembles Les donn es utiles l int gration o ID3D o StatusPBX o Check Les donn es 3 D Secure en sortie du MPI pr sentes titre informatif Si la variable StatusPBX a la valeur Autorisation faire vous pouvez mettre une demande d autorisation avec Paybox Direct Pour faire r f rence l authentification 3D Secure vous devez
21. ifiant unique de la requ te permettant d viter les confusions au niveau des r ponses en cas de questions multiples et simultan es Chaque appel doit avoir un num ro de question unique pour un commer ant donn Exemple Session001 8 1 8 URLHttpDirect Format jusqu 250 caract res URL de retour de serveur serveur Si l URL n est pas pr sente PAYBOX utilisera celle param tr e sur la fiche site du commerce Exemple http maboutique com retourMPI php 8 1 9 URLRetour Format jusqu a 250 caract res URL de retour depuis le navigateur du client Si l URL n est pas pr sente PAYBOX utilisera celle param tr e sur la fiche site du commerce quivalent PBX_EFFECTUE y Paybox Remote MPI Version 6 0 20 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 8 2 Variables r ponses Paybox Remote MPI 8 2 1 ldSession Format jusqu 250 caract res Identifiant unique de la requ te permettant d viter les confusions au niveau des r ponses en cas de questions multiples et simultan es Chaque appel doit avoir un num ro de question unique pour un commer ant donn Exemple Session001 8 2 2 StatusPBX Format Alphanum rique Statut de la demande d authentification voir la liste des valeurs possibles dans le tableau ci apr s II conditionne l appel en autorisation
22. n 9 1 2 Codes erreur du MPI _ Ces codes sont les codes erreur qui peuvent se pr senter dans la variable 3DERROR SIGNIFICATION AuthReq received is invalid Ot Merchant is not known Merchant is not active 103 invalid referrer An error occured during processing Currency is not supported Transaction not found Brand is not supported 108 The validation post to the merchant failed 1300 the HTTP return code is not found 1301 the HTTP return code is not valid 1302 the received message contains no XML 1303 not possible to import the xml in JDOM 1304 incorrect root element 1307 the attibuut id is not defined for Extension 1306 the attibuut id is not defined for 1310 the element Extension is not correct 1311 the element version is not found 1312 the version of the ThreeDSecureMessage is too old 1313 the attribute critical is defined for Extension with value true 1308 the attibuut id and critical are not defined for Extension 1309 the attibuut critical is not defined for Extension A 1305 the element message is not defined Paybox Remote MPI Version 6 0 25 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 7 A Paybox Remote MPI Version 6 0 26 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu
23. nature lectronique de PAYBOX sur l ensemble des donn es pass es en param tre Voir aussi Ref 3 ManuellntegrationPayboxSystem_V6 00_FR pdf pour les details sur le calcul de la signature 8 2 5 3DCAVV Format 28 caract res Valeur re ue des ACS URL encod 8 2 6 3DCAVVALGO Format jusqu 64 caract res Identifiant de l algorithme ayant servi l identification du porteur sur l ACS Exemple 0000000001 8 2 7 3DECI Format 2 chiffres E Commerce Indicator Permet de connaitre le niveau de s curisation de la transaction 8 2 8 3DENROLLED Format 1 caract re tat sur l enr lement du Porteur au programme 3DS Valeurs possibles e Y Carte Porteur enr l e 9 N Carte Porteur non enr l e e U Erreur 8 2 9 3DERROR Format jusqu 6 caract res Num ro d erreur renvoy nativement par le MPI Voir aussi 9 1 2 Codes erreur du MPI 7 Paybox Remote MPI Version 6 0 22 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 8 2 10 3DSIGNVAL Format 1 caract re G n r par le MPI il indique le statut de la v rification de la signature du porteur Y N Valeurs possibles Y ou N 8 2 11 3DSTATUS Format 1 caract re Statut de la demande d authentification Y N A U Valeurs possibles Y Porteur authentifi N Porteur non authentifi For
24. rreur d acc s au MPI 2 Erreur pendant la transmission du VEReq VERes Pour les cas 1 et 2 L identifiant de contexte ID3D n est pas renseign Une demande d autorisation non 3 D Secure peut tout de m me tre effectu e en appelant les interfaces PAYBOX Direct sans le param tre ID3D 3 Le porteur n est pas enrdl L identifiant de contexte ID3D est renseign Une demande d autorisation non 3 D Secure peut tout de m me tre effectu e en appelant les interfaces PAYBOX Direct avec le param tre ID3D Les tapes 6 9 ne sont pas pr sentes dans la cin matique Le porteur est alors redirig vers une page du site Web du commer ant Paybox Remote MPI Version 6 0 13 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation A Paybox Remote MPI Manuel d int gration chez PAYBOX pendant 5 minutes sous l identifiant ID3D S L identifiant de contexte ID3D est donc renseigner lors de l appe aux interfaces PAYBOX Direct en plus des param tres existants A partir de cette tape les actions sont totalement d synchronis es des pr c dentes Demande d autorisation faite par PAYBOX SERVICES aupr s de l acqu reur Restitution de l tat de la demande d autorisation dans la m me session de connexion que l tape 10 Version 6 0 14 Date 28 08 2013 Point Tran
25. saction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 6 SUPPORT ASSISTANCE CONTACT 6 1 Acc s INFORMATION Pour tout renseignement nos Equipes restent disposition des Commer ants et Int grateurs du lundi au vendredi de 9H 18H Service Commercial e mail contact paybox com T l phone 33 0 1 61 37 05 70 ASSISTANCE Pour tout renseignement ou assistance l installation et a l utilisation de nos produits nos Equipes restent disposition des Commer ants et Int grateurs du lundi au vendredi de 9H 12H30 et 14H 18H30 17H30 le vendredi Support Technique amp Fonctionnel e mail support paybox com T l phone 33 0 4 68 85 79 90 Pour tout contact aupr s de nos services il faut IMPERATIVEMENT communiquer les identifiants Paybox e num ro de SITE 7 chiffres e num ro de RANG 2 chiffres e num ro d IDENTIFIANT Paybox 1 9 chiffres 6 2 Fonctions Les fonctions du support sont e Support l int gration et maintenance aupr s des clients qui le sollicitent e Surveillance des processus e Analyses conjointes avec les diff rentes quipes R amp D Exploitation R seau pour r soudre d ventuels probl mes Paybox Remote MPI Version 6 0 15 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers
26. sans autorisation 6 3 Proc dure d inscription Pour s abonner aux services Paybox le client doit contacter le Service Commercial de Paybox voir coordonn es ci dessus ou prendre contact avec nous via le formulaire pr sent en rubrique lt Contact gt sur le site Paybox www paybox com ou bien envoyer un e mail contact paybox com Il sera envoy au Commer ant 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 des param tres utiles aux services Paybox Au pr alable le commer ant devra contacter sa banque pour demander louverture d un contrat de VAD VPC sur son compte bancaire normal Les modalit s du contrat VAD VPC varient selon les banques La banque remettra alors au Commer ant un num ro de SITE 7 chiffres et un num ro de RANG 2 ou 3 chiffres ces num ros serviront d identification aupr s de Paybox 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 le Commer ant souhaite accepter des paiements dans une monnaie autre que l Euro il faut le pr ciser lors de l ouverture du contrat VAD VPC aupr s de la b
27. ue le n de carte et les transmet Paybox via un dialogue s curis de serveur serveur Traitement Par Lot est galement utilis pour valider les encaissements des transactions pr alablement autoris es via Paybox System mais galement assurer des remboursements et annulations Le but de ce document est de d crire comment vient s ajouter 3 D Secure pour le service PAYBOX DIRECT La cin matique 3 D Secure met en place une phase d authentification du porteur pr alable la demande d autorisation et le cas ch ant renseigne la demande d autorisation avec le r sultat de l authentification 3 D Secure A Paybox Remote MPI Version 6 0 6 Manuel d int gration Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 3 PRESENTATION DE LA SOLUTION PAYBOX REMOTE MPI 3 1 Le MPI et 3 D Secure Le MPI Merchant Plug In est un composant install sur les serveurs de PAYBOX Il permet l authentification des 3 intervenants de la transaction Commergant Client Acheteur Banques travers un ensemble de dialogues dans le cadre du programme 3 D Secure C est le m me composant qui est int gr au service PAYBOX System et qui offre le service 3 D Secure par le biais d un navigateur Ce dialogue est r alis selon des sp cifications VISA et MASTERCARD et se d compose en 2 changes 1 Un premier change v rifie sur
28. un compte bancaire commer ant aux Pays Bas chez ABN AMPO ou ING NL Un site Marchand est r f renc aupr s des serveurs de Paybox par plusieurs l ments e Le num ro de site e Le num ro de rang e Un identifiant Ces l ments d identification sont fournis par Paybox lors de la confirmation de l inscription du commer ant l utilisation de nos services Ces informations sont obligatoires dans tous les messages que le Marchand enverra nos plateformes de paiement mais il est galement n cessaire de les fournir lors de tout contact avec les quipes du support Paybox Paybox Remote MPI Manuel d int gration Version 6 0 9 Date 28 08 2013 Point Transaction Systems Document confidentiel ne peut tre reproduit ou communiqu des tiers sans autorisation 4 PROTOCOLE D ECHANGE 4 1 Appel C est un CGI install sur les serveurs PAYBOX SERVICES qui donne l acc s au MPI de PAYBOX Ce CGI peut tre appel via les URL 9 https tpeweb paybox com cqi RemoteMPI cgi ou e https tpeweb1 paybox com cgi RemoteMPI cqgi En cas d indisponibilit d une URL vous pouvez vous connecter la seconde Pour r aliser l authentification porteur il faut rediriger le client sur une de ces URL en envoyant les param tres par la m thode POST La liste des param tres est d taill e dans le paragraphe Erreur Source du renvoi introuvable Erreur Source du renvoi introuvable Exemple d
29. yptogramme visuel sur le site Web du commer ant Le commer ant redirige l acheteur vers une URL de PAYBOX en vue de son authentification 3 D Secure Demande de v rification de l enr lement du porteur aupr s des Directories Servers de Visa et MasterCard R cup ration de l tat sur l enr lement du porteur et de l URL de redirection du porteur vers sa banque 5 ter En cas de non enr lement du porteur au programme 3 D Secure ce dernier est redirig vers une page du site Web du commercant Etape pr sente uniquement en cas de non enrdlement du porteur et les tapes 6 a 9 ne sont pas pr sentes dans la cin matique Redirection du porteur vers sa banque en vue de son authentification R cup ration de l tat sur l authentification du porteur par sa banque Notification appel serveur serveur sur l tat de l authentification du porteur et sur la suite donner pour la demande d autorisation Si le porteur n est pas authentifi la demande d autorisation n est pas faire aupr s de la banque acqu reur Quel que soit l tat de l authentification du porteur ce dernier est redirig vers une page du site Web du commer ant Appel du service Web PAYBOX Direct pour la demande d autorisation aupr s de la banque du commer ant Les informations sur l tat de l authentification du porteur sont stock es 5 bis Cette tape se produit uniquement dans les 3 cas de figure ci dessous 1 E
Download Pdf Manuals
Related Search