PAYLINE-Guide d`integration de iDEAL-FR
Contents
1. 1 Objet du document Ce document d crit la proc dure d int gration du moyen de paiement iDEAL via Payline dans votre application de vente 1 2 Public vis Ce document est destin aux commer ants et int grateurs qui souhaitent int grer le moyen de paiement iDEAL dans Payline afin d obtenir des paiements 1 3 Contenu du document Le chapitre iDEAL un nouveau standard de paiement pr sente une d finition de ce moyen de paiement mais aussi son fonctionnement et la mani re dont il s interface avec Payline Le chapitre Processus d int gration pas a pas d crit les tapes que vous devez effectuer pour int grer iDEAL via Payline dans votre application de vente a distance et tester le bon fonctionnement de l application Le chapitre Annexes liste l ensemble des codes et messages qui sont utilis s lors d une demande de paiement par iDEAL 1 4 Liste des documents de reference La documentation suivante est disponible sur notre site internet section documentation www payline com Guide d int gration Conditions g n rales d utilisation Fiche produit Manuel utilisateur du centre d administration Manuel d utilisation du TPEV La documentation li e l utilisation des cartes est disponible sur simple demande aupr s de notre assistance technique Payline Page 4 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des t2. Cet identifiant est un num ro de test iDEAL utilisable exclusivement en homologation Informations Bancaires iDEAL Acqu reur ABN AMRO kel Avant de cr er votre contrat iDEAL IDEAL veuillez vous connecter l URL suivante https sbnamro ideal payment de ideal logon_aab do Proc dez ensuite une A nouvelle inscription en indiquant Payline dans le champ EE Une fois votre identifiant commer ant re u par mail Nombre de 9 chiffres veuillez le renseigner dans le champ Identifiant commer ant les Page 8 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des tiers sans accord pr alable crit est illicite Version du mod le DocStd_50 Payline Con u pour vendre Cliquer sur le bouton Sauvegarder pour finaliser la cr ation du moyen de paiement Vos moyens de paiements Votre moyen de paiement a bien t enregistr Crit res de recherche Point de vente Tous Lel Libell WI Terme exact N contrat WI Terme exact Statut V Act T Inactif Rechercher Annuler Reset Nouveau moyen de paiement Plus de crit res gt gt 3 2 2 ETAPE 2 Utilisation du moyen de paiement IDEAL sur Payline Les fonctions mon tiques disponibles sont autorisation validation code action 101 Afin d effectuer un paiement web vous utiliserez nos web services doWeb
3. Payline Con u pour vendre Manuel d utilisation du Moyen de Paiement IDEAL Version 1 B Payline Page 1 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des tiers sans accord pr alable crit est illicite Version du mod le DocStd_50 Payline Con u pour vendre Page des volutions Le tableau ci dessous liste les derni res modifications effectu es sur ce document Date Version Modifications 22 01 10 1 0 Livraison version initiale 24 07 12 1 A Mise aux couleurs 27 01 14 1 B Mise niveau iDEAL v3 Page 2 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des tiers sans accord pr alable crit est illicite Version du mod le DocStd_50 Paylin Con u pour vendre Sommaire 1 INTRODUCTION a nn a sm im nn nn dainadaina dania 4 ALT Objet guder See enee leede 4 12 PUDDING VISCO E 4 1 3 Contenu du TT 4 1 4 Liste des documents de reference ss 4 15 Avertissement sssensseseeneneneneneneeneneeneneeneneenenenenennenesnnsnsene 5 L Gontaclsiechniguesg sde EEN 5 2 IDEAL UN NOUVEAU STANDARD DE PAIEMENT eeeeeeeeeeeeeeeeees 6 2 1 Qu est ce gW iDEAL E 6 2 2 Comment a marche weiscsssccsissscascscesecviseescoscsvonsovsssesesosesseco
4. Payment en indiquant un code action 101 autorisation validation et getWebPaymentDetails 3 2 3 ETAPE 3 Utilisation des web services avec IDEAL sur Payline Pour utiliser iDEAL dans Payline vous b n ficiez des fonctions de paiement suivantes doWebPayment getWebPaymentdetails Le web service doWebPayment La fonction doWebPayment permet d initialiser une transaction de paiement web avant de rediriger votre client sur les pages de paiement Payline Le paiement iDEAL se fait exclusivement en paiement imm diat Pour cela renseignez les champs payment Action 101 payment Mode CPT payment ContractNumber et payment selectedContract avec le num ro de contrat iDEAL Payline r alise une demande d autorisation aupr s de l acqu reur et dans le cas d un accord valide automatiquement le paiement Le web service getWebPaymentdetails Pour r aliser une demande de r sultat de la transaction de paiement Payline met votre disposition ce web service Vous devez transmettre le jeton d authentification d livr par Payline lors de la demande d initialisation r sultat de la fonction doWebPayment pour obtenir un r sultat d taill du paiement Page 9 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des tiers sans accord pr alable crit est illicite Versi d le DocStd
5. _50 Payline Con u pour vendre 3 2 4 ETAPE 4 Les Page web de paiement Le moyen de paiement est disponible via l interface Web Ecran de choix du moyen de paiement Si le commer ant propose iDEAL sur cette session de paiement web la page s affichera comme ci contre ty mom Payline Vous tes sur un serveur de paiement s curis par SSL toute s r nit Ne de commande Commande 14124 Total payer 11 00 EUR B n ficiaire Commerce PAYLINE Je s lectionne mon moyen de paiement A 0 Adresse J annule mon paiement SE ue MECHER Ledoux P le d activit d Aix en Provence 13593 Aix en Provence amp paiement s curis par Payline Payline L acheteur s lectionne le moyen de paiement iDEAL et clique sur le bouton JE VALIDE ce moyen de paiement L acheteur s lectionne sa banque et appuie sur le bouton JE VALIDE mon paiement Payline Veuillez renseigner vos donn es de paiement A Vous tes sur un serveur de paiement s curis par a Vous pouvez payer en toute s r nit Banque Choix de la banque N de commande e Commande 14124 Seege 11 00 EUR B n ficiaire Commerce PAYLINE Adresse 260 rue Claude Nicolas Ledoux P le d activit d Aix en Provence 13593 Aix en Provence J annule mon paiement amp paiement s curis par Payline Payline L acheteur est alors redirig sur le site de sa banque sur lequel
6. administration center Page 15 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des tiers sans accord pr alable crit est illicite Version du mod le DocStd_50 by MONEXT Payline Con u pour vendre Code R sultat Message court Message long Acteur vis 05305 Invalid URL Ideal field error See more details in Merchant payline administration center 05400 AcquirerlD unknown Ideal error relating to ID See more details Merchant in payline administration center 05401 MerchantID unknown Ideal error relating to ID See more details Merchant in payline administration center 05402 IssuerlD unknown Ideal error relating to ID See more details Merchant in payline administration center 05403 SubID unknown Ideal error relating to ID See more details Merchant in payline administration center 05404 MerchantID not active Ideal error relating to ID See more details Merchant in payline administration center 05405 Transaction does not exist Ideal transaction error See more details in Merchant payline administration center 05406 Transaction already submitted Ideal transaction error See more details in Merchant payline administration center 05407 Bank account number not 11 Ideal account number error See more Merchant proof details in payline administration center 05408 Se
7. e comment int grer rapidement iDEAL via Payline dans votre application de vente Nous vous recommandons de r aliser chaque tape afin de garantir une bonne int gration d iDEAL dans Payline ll est indispensable de r aliser des demandes de paiement dans l environnement d homologation Payline avant de passer en production Il fonctionne exactement comme le site de production Payline except qu aucun paiement n est envoy aux acqu reurs N anmoins a la diff rence de la production en environnement d homologation la cr ation d un compte iDEAL n est pas requise un compte IDEAL de test est mis votre disposition comme le pr cise le paragraphe 3 2 1 ETAPE 1 Cr ation du moyen de paiement IDEAL sur Payline 3 1 Pr requis 3 1 1 Bancaire Vous poss dez un compte bancaire commer ant dans l une des banques iDEAL ING Bank N V Rabobank Nederland ou Fortis Bank Vous avez souscrit au moyen de paiement IDEAL aupr s d une des banques cit ci dessous 3 1 2 Commercial Vous avez d clar votre soci t au registre du commerce poss dez un n de SIRET et une adresse email valide Vous avez souscrit au produit Payline avec l option IDEAL 3 1 3 Payline Vous devez communiquer l quipe support Payline le num ro de contrat IDEAL Page 7 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des t
8. ez jamais votre mot de passe a quelqu un d autre Pour des raisons de s curit votre mot de passe doit contenir au minimum 8 caract res constitu s d une combinaison de majuscules de minuscules de chiffres et de caract res sp ciaux comme Par exemple Jean pierre09 est un mot de passe conforme Password confirmation confirmer votre mot de passe Password confirmation Mandatory Fields Cliquez sur Submit pour finaliser votre inscription Page 13 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des tiers sans accord pr alable crit est illicite Version du mod le DocStd_50 P li by MONEXT Con u pour vendre A la fin du processus d inscription vous recevrez un email contenant a votre identifiant commer ant iDEAL I permet votre identification lors des changes entre Payline et iDEAL Celui ci vous sera demand lors de votre cr ation de contrat Ideal sur Payline tape 2 Une adresse laquelle vous devez vous rendre pour compl ter votre inscription aupr s d iDEAL 3 3 2 Configuration sur Payline du moyen de paiement iDEAL Vous devez contacter nos services support Payline support payline com afin de lui communiquer votre contrat iDEAL et de fournir la fiche de renseignement commer ant Notre support Payline va cr er le moyen de paiement sur l envi
9. iers ou toute communication des tiers sans accord pr alable crit est illicite Versi d le DocStd_50 P li by MONEXT Con u pour vendre 1 5 Avertissement Ce document est la propri t exclusive de Monext Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des tiers sans accord pr alable crit de Monext est illicite 1 6 Contacts techniques Vous avez besoin d aide de conseil ou vous souhaitez simplement nous poser une question Contactez l Assistance Payline par support payline com Si vous d couvrez une erreur dans cette documentation vous pouvez nous envoyez un email 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 sa date indiqu e sur la premi re page du document et le s num ro s de page s Page 5 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des tiers sans accord pr alable crit est illicite Version du mod le DocStd_50 2 1 2 2 2 3 Payline Con u pour vendre IDEAL un nouveau standard de paiement Ce chapitre pr sente le nouveau moyen de paiement iDEAL son fonctionnement et son mode d int gration dans Payline Qu est ce Ou IDEAL 3 D velopp en octobre 2005 par un groupement de banque n erlandaise iDEAL a t cr pour r aliser des vire
10. iers sans accord pr alable crit est illicite Versi d le DocStd_50 Payline Con u pour vendre 3 2 En Homologation Comment utiliser IDEAL 3 2 1 ETAPE 1 Cr ation du moyen de paiement IDEAL sur Payline Afin de cr er un contrat iDEAL sur Payline en homologation rendez vous sur le centre d administration dans l onglet Configuration puis Vos moyens de paiement Un cran de recherche s affiche cliquez sur le bouton Nouveau moyen de paiement Ecran de recherche de moyen de paiement Vos moyens de paiements Crit res de recherche Point de vente Tous Libell V Teme saq N contrat V Terme saa Rechercher Annuler Reset Plus de crit res gt gt Ecran de cr ation de moyen de paiement 1 2 S lectionnez votre point de vente puis le type de moyen de paiement iDEAL comme ci dessous Cliquez ensuite sur le bouton Suivant Cr ation d un nouveau moyen de paiement Etape 1 2 Les champs marqu s d un a sont obligatoires Renseignez ici les informations du contrat pour ce moyen de paiement Information moyen de paiement a Point de vente Commerce PAYLINE y Type de moyen de paiement IDEAL lel ee Ecran de cr ation de moyen de paiement 2 2 Renseigner un libell un num ro de contrat de votre choix puis s lectionner votre devise Cliquez sur le statut Actif et renseigner l identifiant iDEAL avec le num ro suivant 008050150
11. il doit s authentifier pour ex cuter son paiement d s que l acheteur a termin il re oit un ticket de paiement Page 10 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des tiers sans accord pr alable crit est illicite Version du mod le DocStd_50 by MONEXT Payline Con u pour vendre 3 2 5 ETAPE 5 L utilisation du Centre administration par le commer ant Le commer ant pourra visualiser ces transactions IDEAL dans l onglet Transactions de paiement puis Rechercher des transactions Recherche des transactions Dans la partie plus de crit res on fait apparaitre le moyen de paiement iDEAL si le Rechercher des Transactions A Le nombre de transactions remont es est limit aux 500 les plus r centes EE el Se Pre pie 1e Les transactions de plus d un an ne sont pas visibles sur cet cran ASHE LE ce Re s ee Er Date et heure Transactions d aujourd hui Transactions d hier Transactions de ces 7 derniers jours Transactions du a h mau h m Toutes T Recherche dans les archives transaction effectude avant le 27 02 13 Commerce Point de vente Y Contrat VAD L Moyen de paiement F ce 7 IDEAL E paypal Cl AMEX ONE CLICK CT Amex Transaction Type
12. lected currency not Ideal currency error See more details in Merchant supported payline administration center 05409 Maximum amount exceeded Merchant Detailed record states the Ideal account number error See more maximum amount details in payline administration center 05410 Amount too low Detailed Merchant record states the minimum Ideal account number error See more amount details in payline administration center 05411 Please adjust expiration period Merchant See suggested expiration Ideal account number error See more period details in payline administration center Page 16 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des tiers sans accord pr alable crit est illicite Version du mod le DocStd_50
13. ments en ligne avec garantie de paiement ce qui offre davantage de s curit aux acheteurs et aux commer ants sur Internet en mati re de paiement en ligne C est une solution alternative au paiement par carte de cr dit sur Internet Comment a marche Lorsqu un acheteur paye avec le moyen de paiement iDEAL il r alise tout simplement un virement de son compte bancaire vers le compte du commer ant L acheteur et le commer ant doivent tre membre d une des banques l initiative d iDEAL ING Bank N V Rabobank Nederland et Fortis Bank Lors du paiement l acheteur s authentifie aupr s de sa banque et valide ou non le paiement d clench par le marchant Payline iDEAL et vous Payline est inscrit aupres du systeme de banque iDEAL comme Plateforme de solution de paiement PSP Cette option vous permet de b n ficier d une seule configuration sur Payline certificats mots de passe etc Le commer ant doit cr er un compte aupr s d une banque adh rente au moyen de paiement IDEAL Payline se charge de se connecter l interface iDEAL afin que l acheteur puisse ex cuter son paiement Page 6 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des tiers sans accord pr alable crit est illicite Versi d le DocStd_50 Payline Con u pour vendre 3 Processus d int gration pas pas Ce chapitre expliqu
14. ministration center 05003 Mandatory value missing Ideal unreadable XML See more details Merchant in payline administration center 05100 Failure in system Ideal system failure See more details in Merchant payline administration center 05101 System busy Try again later Ideal new requests are no longer being Merchant accepted but requests already submitted will be dealt with until a certain time See more details in payline administration center 05102 Unavailable due to Ideal system maintenance See more Merchant maintenance details in payline administration center 05200 Authentication error Ideal incorrect authentication See more Merchant details in payline administration center 05201 Authentication method not Ideal incorrect authentication methods Merchant supported See more details in payline administration center 05202 Invalid electronic signature Ideal expired certificates See more details Merchant in payline administration center 05300 iDEAL version number invalid Ideal field error See more details in Merchant payline administration center 05301 Value contains non permitted Ideal field error See more details in Merchant character payline administration center 05302 Value too long Ideal field error See more details in Merchant payline administration center 05303 Value too short Ideal field error See more details in Merchant payline administration center 05304 Invalid date time Ideal field error See more details in Merchant payline
15. ns suivantes URL d authentification metteur Num ro de compte de l acheteur s Nom de l acheteur Ville de l acheteur IDEAL URL d authentification metteur abnamro tes IBAN de l acheteur BIC de l metteur Nom de l acheteur Page 12 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des tiers sans accord pr alable crit est illicite Version du mod le DocStd_50 Payline Con u pour vendre 3 3 En Production Cr er un compte iDEAL 3 3 1 Votre inscription sur iDEAL Cette tape vous permet de cr er un compte iDEAL dans l environnement de production n cessaire pour l int gration de ce moyen de paiement dans Payline Suivez pas a pas les indications suivantes A l aide de votre navigateur Internet allez l adresse https acquirer ideal bank nl fortis com ideal registrationinit do Cr ez votre compte commer ant iDEAL en remplissant le formulaire suivant O O Registration Apply here for iDEAL User name E mail address Password User name nom de l utilisateur E mail adresss adresse email Cette adresse de messagerie sera utilis e comme identifiant utilisateur par iDEAL Password Mot de passe utilisateur Pour bien prot ger votre compte choisissez un mot de passe facile a m moriser pour vous mais difficile a trouver par un autre Ne communiqu
16. rdasnsevedessucsade loseavosorscos cobensooaesssesosesonsorsevesesvavooseosses 6 2 3 Payline IDEAL et VOUS nusuri EEES 6 3 PROCESSUS D INTEGRATION PAS A PAS seen 7 3 1 PREF UU 7 3 1 1 BANCAIRE Peat Fates nn deh aude ca cTieg Coes oa IT eines rate ee rE Nae eats esate ete 7 oie e lr EI H 3 1 3 DE HE EE H 3 2 En Homologation Comment utiliser IDEAL sense 8 3 2 1 TAPE 1 Cr ation du moyen de paiement IDEAL sur Payline 00 0 0 ceeeeceeseeseseeeeeeeeseeeeeteeseees 8 3 2 2 ETAPE 2 Utilisation du moyen de paiement IDEAL sur Payline 9 3 2 3 ETAPE3 Utilisation des web services avec IDEAL Sur Payline 20 00 ec eeeseseesesseeeeeneeaeereneeaeers 9 3 2 4 ETAPE 4 Les Page web de paiement ss 10 3 2 5 ETAPE 5 L utilisation du Centre administration par le commer ant 11 3 3 En Production Cr er un compte iDEAL esesesesssescsescsescscscsescseecsesesescseseseseseeesesesesesesesesesesesesesesesesesesse 13 3 3 1 Votre inscription sur IDEAL inner 13 3 3 2 Configuration sur Payline du moyen de paiement IDEAL 14 3 3 3 Validez votre int gration ie hele alone Mee RR dee E 14 4 TIN ER PE RP RP ER SR PR SP SE a aada 15 Page 3 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des tiers sans accord pr alable crit est illicite Version du mod le DocStd_50 Payline Con u pour vendre 1 Introduction 1
17. ronnement d homologation et vous fournira le num ro de contrat associ a ce moyen de paiement Ce num ro de contrat vous permettra d effectuer les paiements 3 3 3 Validez votre int gration Cette tape vous permet de contr ler que votre int gration est correcte Obtenez une transaction de paiement accord e avec le num ro de contrat iDEAL Payline Consultez le centre d administration commer ant et validez le bon enregistrement de vos transactions de paiement Page 14 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des tiers sans accord pr alable crit est illicite Vers d le DocStd_50 4 Annexes Code retour et message Payline pour iDEAL Payline Con u pour vendre Le tableau ci dessous permet de recenser l ensemble des codes et messages de retour Payline pour iDEAL ainsi que leur destinataire Les codes et messages suivants seront renvoy s par l objet R sultat Message court Message long Code R sultat Acteur vis 05000 Received XML not valid Ideal invalid XML See more details in Merchant payline administration center 05001 Encoding type not UTF 8 Ideal incorrect encoding See more details Merchant in payline administration center 05002 XML version number invalid Ideal invalid XML version See more Merchant details in payline ad
18. transaction Tous kel ID transaction MW Terme exact R f rence commande V Terme saq N autorisation Code retour 97 Transactions accept es V Transactions refuses IBAN BIC M dia de la wanssction Tous el Etat3DS Tous kel Montant compris entre et Devises Euro 978 e Adresse IP E Transactions pour la cr ation mise 3 jour de portefeuilles Rechercher Annuler Reset Page 11 16 Ce document est la propri t exclusive de MONEXT Toute reproduction int grale ou partielle toute utilisation par des tiers ou toute communication des tiers sans accord pr alable crit est illicite Version du mod le DocStd_50 Payline Con u pour vendre Liste des transactions La colonne MdP s enrichit du moyen de paiement iDEAL et la colonne N Carte devient N Carte N Compte permet l identification d une transaction iDEAL Rechercher des Transactions R sultats de la recherche it Transactions du 22 01 2014 00 00 zu 22 01 2014 23 59 ID commer ant 70159860788139 Monext Moyen de paiement IDEAL x Rappel des crit res T e ebe Faken 2 3DSecure Total 1 1 transaction s ID Ref cmd Date trans Montant Point de Vente Donn e porteur 3D 0030000023364107 Paiement_IDEAL_01 22 01 2014 17 52 23 1 50 EUR Non Export options SI Modifier les crit res Nouvelle recherche D tail d une transaction Sur le d tail d une transaction l encart iDEAL s ajoute Il contient les informatio
Download Pdf Manuals
Related Search