Download Support Payline

Guide d’intégration 1EURO.COM
Payline
Guide d’intégration 1EURO.COM
Produit Payline
MONEXT
04/11/2011
Version 1.0
Page 2 / 15
Sommaire
1.
2.
3.
4.
Introduction
3
1.1.
Objet du document ...................................................................................................................... 3
1.2.
Public visé 3
1.3.
Contenu du document ................................................................................................................. 3
1.4.
Liste des documents de référence .............................................................................................. 4
1.5.
Avertissement .............................................................................................................................. 4
1.6.
Contact commercial ..................................................................................................................... 4
1.7.
Contacts techniques .................................................................................................................... 5
1.8.
Historique des révisions............................................................................................................... 5
1EURO.COM : un nouveau standard de paiement.......................................................................... 6
2.1
Qu’est-ce que 1EURO.COM ?..................................................................................................... 6
2.2
Comment ça marche ? ................................................................................................................ 6
2.3
Payline, 1EURO.COM et vous..................................................................................................... 6
Processus d’intégration pas à pas ................................................................................................... 7
3.1
Pré-requis 7
3.2
En Homologation : Comment utiliser 1EURO.COM ? ................................................................. 8
3.3
En Production : Créer un compte 1EURO.COM ....................................................................... 13
Annexes
4.1
15
Code retour et message Payline pour 1EURO.COM ................................................................ 15
Guide d’intégration 1EURO.COM
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.
2
Guide d’intégration 1EURO.COM
MONEXT
Produit Payline
04/11/2011
Version 1.0
Page 3 / 15
1. Introduction
1.1. Objet du document
Ce document décrit la procédure d’intégration du moyen de paiement 1EURO.COM via Payline
dans votre application de vente.
1.2. Public visé
Ce document est destiné aux commerçants et intégrateurs qui souhaitent proposer le moyen de
paiement 1EURO.COM à leurs clients via Payline.
1.3. Contenu du document
Le chapitre « 1EURO.COM, 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 à pas » décrit les étapes que vous devez effectuer pour
intégrer 1EURO.COM via Payline dans votre application de vente à 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 1EURO.COM.
Guide d’intégration 1EURO.COM
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.
3
Guide d’intégration 1EURO.COM
Produit Payline
MONEXT
04/11/2011
Version 1.0
Page 4 / 15
1.4. Liste des documents de référence
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.
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. Contact commercial
Pour toute question sur nos offres
Mail : [email protected]
Guide d’intégration 1EURO.COM
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.
4
Guide d’intégration 1EURO.COM
Produit Payline
MONEXT
04/11/2011
Version 1.0
Page 5 / 15
1.7. Contacts techniques
Vous avez besoin d’aide, de conseil ou vous souhaitez simplement nous poser une question.
Contactez l’Assistance Payline par :
[email protected]
Email :
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).
1.8. Historique des révisions
Le tableau ci-dessous liste les dernières modifications effectuées sur ce document.
Date
Version
04/11/11
1.0
Modifications
Livraison version initiale
Guide d’intégration 1EURO.COM
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.
5
Guide d’intégration 1EURO.COM
MONEXT
Produit Payline
04/11/2011
Version 1.0
Page 6 / 15
2. 1EURO.COM : un nouveau standard de paiement
Ce chapitre présente le nouveau moyen de paiement 1EURO.COM, son fonctionnement et son
mode d’intégration dans Payline.
2.1 Qu’est-ce que 1EURO.COM ?
Développé par Cofidis, le moyen de paiement 1EURO.COM repose sur le principe du crédit
renouvelable. Une somme d’argent est mise à la disposition de l’acheteur, il peut la dépenser en
ligne via 1EURO.COM.
C’est une solution alternative au paiement par carte de crédit sur Internet.
2.2 Comment ça marche ?
Lorsqu’un acheteur paye avec le moyen de paiement 1EURO.COM, la somme d’argent mise à sa
disposition est débitée du montant de son achat. Son crédit se renouvelle au fur et à mesure des
remboursements et est réutilisable.
2.3 Payline, 1EURO.COM et vous
Payline est connecté avec Cofidis pour l’acceptation des paiments via 1EURO.COM.
Le commerçant doit créer un compte 1EURO.COM auprès de Cofidis, pour ensuite créer et
configurer le moyen de paiement 1EURO.COM au sein de son compte Payline.
Payline se charge de se connecter à l’interface Cofidis afin que l’acheteur puisse exécuter son
paiement, et que les fonds soient reversés au commerçant.
Guide d’intégration 1EURO.COM
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.
6
Guide d’intégration 1EURO.COM
Produit Payline
MONEXT
04/11/2011
Version 1.0
Page 7 / 15
3. Processus d’intégration pas à pas
Ce chapitre explique comment intégrer rapidement 1EURO.COM via Payline dans votre application
de vente. Nous vous recommandons de réaliser chaque étape afin de garantir une bonne intégration
de 1EURO.COM dans Payline.
Il 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, à la différence de la production, en environnement
d’homologation, la création d’un compte 1EURO.COM auprès de Cofidis n’est pas requise, un
compte 1EURO.COM de test est mis à votre disposition comme le précise le paragraphe « 3.2.1
ETAPE 1 : Création du moyen de paiement 1EURO.COM sur Payline ».
3.1 Pré-requis
3.1.1
Bancaire
Vous avez souscrit un compte commerçant 1EURO.COM auprès de Cofidis.
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 1EURO.COM.
3.1.3
Payline
Vous devez communiquer à l’équipe support Payline votre identifiant commerçant 1EURO.COM,
ainsi que le certificat de sécurité qui vous a été communiqué par Cofidis.
Guide d’intégration 1EURO.COM
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.
7
Guide d’intégration 1EURO.COM
Produit Payline
MONEXT
04/11/2011
Version 1.0
Page 8 / 15
3.2 En Homologation : Comment utiliser 1EURO.COM ?
3.2.1
ETAPE 1 : Création du moyen de paiement 1EURO.COM sur Payline
Afin de créer un contrat 1EURO.COM 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 :
Ecran de création de moyen de paiement 1/2:
Sélectionnez votre point de vente puis le type de moyen de paiement 1EURO.COM comme cidessous.
Cliquez ensuite sur le bouton « Suivant ».
Guide d’intégration 1EURO.COM
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.
8
Guide d’intégration 1EURO.COM
Produit Payline
MONEXT
04/11/2011
Version 1.0
Page 9 / 15
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 la valeur 032877637877777 pour le champ ID Commerçant
1euro.com. Il s’agit d’un compte de test utilisable uniquement dans l’environnement d’homologation.
Cliquer sur le bouton « Sauvegarder » pour finaliser la création du moyen de paiement.
3.2.2
ETAPE 2 : Utilisation du moyen de paiement 1EURO.COM sur Payline :
Les fonctions monétiques disponibles sont :
–
autorisation + validation « code action 101 »
L’appel de l’interface de paiement web se fait via notre web service doWebPayment. Le résultat d’un
paiement web est connu en appelant notre web service getWebPaymentDetails ».
Guide d’intégration 1EURO.COM
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.
9
Guide d’intégration 1EURO.COM
Produit Payline
MONEXT
04/11/2011
Version 1.0
Page 10 / 15
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 1EURO.COM se fait exclusivement en paiement immédiat. Pour cela, renseignez les
champs « payment.Action » à 101, « payment.Mode » à CPT et « payment.ContractNumber » avec
le numéro de votre contrat 1EURO.COM dans Payline.
Payline réalise une demande d’autorisation auprès de Cofidis 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 (token) 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.
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 1EURO.COM en plus d’autres
moyens de paiement (par exemple CB) sur cette session de paiement web, la page s’affichera
comme suit :
L’acheteur sélectionne le moyen de paiement 1EURO.COM et clique sur le bouton « Valider ».
Guide d’intégration 1EURO.COM
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.
10
Guide d’intégration 1EURO.COM
MONEXT
Produit Payline
04/11/2011
Version 1.0
Page 11 / 15
L’acheteur est alors redirigé sur l’interface web de 1EURO.COM, où il peut s’identifier ou créer un
compte :
Il sélectionne ensuite les modalités de son paiement.
Une fois le paiement validé sur l’interface 1EURO.Com, l’acheteur est redirigé vers la page de
confirmation de paiement Payline.
Guide d’intégration 1EURO.COM
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.
11
Guide d’intégration 1EURO.COM
Produit Payline
MONEXT
3.2.4
04/11/2011
Version 1.0
Page 12 / 15
ETAPE 4 : L’utilisation du Centre administration, par le commerçant
Le commerçant pourra visualiser ces transactions 1EURO.COM dans l’onglet « Transactions de
paiement » puis « Rechercher des transactions ».
Recherche des transactions
Dans l’écran de recherche avancée, accessible via le bouton « plus de critères », le moyen de
paiement 1EURO.COM apparait dans le bloc «Commerce » , si le commerçant possède ce moyen
de paiement pour le point de vente considéré.
Guide d’intégration 1EURO.COM
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.
12
Guide d’intégration 1EURO.COM
Produit Payline
MONEXT
04/11/2011
Version 1.0
Page 13 / 15
Liste des transactions
La colonne MdP permet d’identifier le moyen de paiement utilisé pour affectuer la transaction.
Détail d’une transaction
-
Sur le détail d’une transaction 1EURO.COM, l’encart Données 1euro.com.se présente comme
suit :
3.3
3.3.1
En Production : Créer un compte 1EURO.COM
Votre inscription sur 1EURO.COM
Cette étape vous permet de créer un compte 1EURO.COM chez Cofidis. Cette démarche est
réalisation en ligne via le site http://www.jeveuxjeclique.com/. Suivez les instructions qui vous y sont
données.
Guide d’intégration 1EURO.COM
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.
13
Guide d’intégration 1EURO.COM
Produit Payline
MONEXT
04/11/2011
Version 1.0
Page 14 / 15
A la fin du processus d’inscription, vous devez disposer de :
votre identifiant commerçant 1EURO.COM. Il permet votre identification lors des échanges
entre Payline et 1EURO.COM. Celui-ci vous sera demandé lors de votre création de contrat
1EURO.COM sur Payline (étape 2).
Un certificat de sécurité pour la connexion à l’API de 1EURO.COM. Ce certificat doit
également être communiqué à Payline.
3.3.2
Configuration sur Payline : du moyen de paiement 1EURO.COM
La procédure de configuration en production est identique à celle d’homologation. Vous devez en
plus communiquer au support Payline ([email protected]) votre certificat de sécurité.
3.3.3
Validez votre intégration
Cette étape vous permet de contrôler que votre intégration est correcte.
Réalisez un paiement complet avec votre contrat Payline 1EURO.COM.
Consultez le centre d’administration commerçant et validez le bon enregistrement de vos
transactions de paiement.
Guide d’intégration 1EURO.COM
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.
14
Guide d’intégration 1EURO.COM
04/11/2011
Version 1.0
Page 15 / 15
Produit Payline
MONEXT
4. Annexes
4.1
Code retour et message Payline pour 1EURO.COM
Le tableau ci-dessous permet de recenser l’ensemble des codes et messages de retour Payline
pour 1EURO.COM ainsi que leur destinataire.
Code Résultat
Message
Acteur visé
11001
Unknown merchant
Merchant
11002
A problem occurred during the auth
Merchant
11003
Missing data - invalid transaction
Merchant
11004
Impossible operation
Merchant
11005
Wrong data
Merchant
11006
Validity date of the card exceeded
Merchant
11007
Operation not allowed
Merchant
11008
Expired card
Merchant
11009
Account is currently treated by Co
Merchant
11010
Account is currently treated by Co
Merchant
11011
Insufficient disposable
Merchant
11012
Refusal of granting : max amount e
Merchant
11013
Account number unknown
Merchant
11014
Account not financable
Merchant
11015
Failure of the recording of the op
Merchant
11016
Cofidis server unavailable
Merchant
11017
Technical problem on Atos platform
Merchant
Guide d’intégration 1EURO.COM
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.
15