Vous êtes sur la page 1sur 95

LEMON WAY

KIT dINTERFACE TECHNIQUE


Pour Webmaster

eCommerce

Applications mobiles

Wallets pour cagnottes

Marque blanche














Publication
Statut Valid
Diffusion Marques Blanches Lemon Way
Version 5.5
Rfrence LW - Kit Marque Blanche - Guide Intgration




Lemon Way SAS - Kit Marchand - Guide dintgration page 2/95

Liste de diffusion

Socit Destinataire
Lemon Way Sbastien Burlet CEO
Lemon Way Lydie Zhu Directrice des Systmes dInformation
Lemon Way Hicham Sadiki Chef de projet



Historique des versions

Version Date Rsum des modifications
1.0
Lydie Zhu
11/08/2011 Cration
1.1
Lydie Zhu
03/10/2011 Simplification cration de compte
1.2
Lydie Zhu
28/10/2011 Ajout dtails du kit
1.3
Lydie Zhu
02/11/2011 Modification processus webkit
1.4
Lydie Zhu
04/11/2011 Modification processus webkit
1.5
Lydie Zhu
08/11/2011 Finalisation processus de paiement direct
1.6
Lydie Zhu
09/07/2012
Finalisation :
-DirectKit avec inscription, demande et vrification denrollement
-Webkit standardise, avec paiement et enregistrement de carte bancaire
1.7
Lydie Zhu
11/07/2012 Modification processus webkit
1.8
Lydie Zhu
10/09/2012 Mise jour du directkit avec paiement
1.9
Gregory Jaen
24/09/2012 Ajout BackOffice Pro
2.0
Lydie Zhu
01/10/2012 Modification du Direct Kit avec lajout du check de code PDV
2.1
S.Burlet, CEO

02/10/2012 Validation complte.
2.2
G.Jaen
03/10/12 Ajout capture cran IPAD, ajout section cl marchand
2.3
S.Burlet
03/10/02 Validation.
2.4
G.Jaen
10/12/12 Mise jour section backoffice pro
2.5
S.Burlet
04/01/2013
Liens espace marchand professionnel
Explications du paiement mobile en magasin et distance
2.6
S.Burlet
17/01/2013 Module de paiement pour PRESTASHOP
2.7
S.Burlet
30/01/2013 Paiement par Carte Bancaire pour les sites de eCommerce, les sites de cadeau commun, etc.
2.8
L. Zhu
01/02/2013
Ajout en marque blanche des mthodes directkit suivantes : enregistrement et dsactivation de carte
bancaire, money-in, recherche des dtails dun paiement



Lemon Way SAS - Kit Marchand - Guide dintgration page 3/95

2.9
L. Zhu
11/02/2013 Ajout de mthodes dans la partie marque blanche
3.0
L.Zhu
18/02/2013
Ajouts de mthodes pour la partie marque blanche : ajout dIBAN, rcupration des dtails dun
wallet, maj des erreurs et sorties
3.1
L.Zhu
11/03/2013
Marque Blanche : Corrections mineures et ajout de la mthode webservice moneyInWebInit : une
mthode dinitialisation dacquisition carte web
3.2
L.Zhu
07/05/2013
Marque blanche uniquement
RegisterIBAN v1.1
3.3
L.Zhu
21/06/2013 GetMoneyInTransDetails v1.2
3.4
L. Zhu
01/07/2013
FastPay : nouvelle mthode de paiement rapide qui inclut cration de wallet, acquisition carte et
paiement
3.5
H.Sadiki/L. Zhu
02/07/2013
UploadFile : Methode dupload de KYC pour les clients

3.6
H.Sadiki/L. Zhu
15/07/2013
- Prcisions UploadFile
- Ajout de prcisions sur le format gnral des requtes
- GetKycStatus : Mthode de rcupration des modifications de status
- GetMoneyInIBANDetails: Mthode de rcupration des moneyIn par virement.
- Refund MoneyIn : remboursement dune acquisition carte
3.7
H.Sadiki/L. Zhu
22/07/2013 -GetBalances : Rcupre lensemble des soldes des wallets depuis une date UTC.
3.8
L.Zhu
22/08/2013 FastPay v 1.1
3.9
L. Zhu
27/08/2013 -Fix erreur de documentation MoneyOut
4.0
L. Zhu
28/08/2013 -FastPay v1.2 : possibilit de sauvegarder la carte bancaire
4.1
H.Sadiki
18/09/2013 -GetWalletDetails : Ajout en sortie des statuts de documents et IBAN
4.2
S.Burlet
24/09/2013
Relecture gnrale, revue des dfinitions, ajout dinformations concernant le paiement 3D Secure,
explication des fonctions de virement externe, de paiement entre wallets, de paiement direct avec la
mthode FastPay, informations concernant les IBAN, informations concernant la responsabilit du
client en termes de KYC, informations concernant le Rebill et les risques lis au changement de
descripteur et cas de toknisation de carte bancaire, information concernant les cots de virements
externes SEPA en monnaie non EUR.
Ajout de Wonderstars (LAB FT) et de lexistence dun BackOffice de gestion.
4.3
L.Zhu
26/09/2013 GetMoneyInTransDetails v1.3
4.4
H.Sadiki
04/10/2013 -GetWalletDetails : Ajout du type de document pour version 1.2
4.5
L. Zhu
17/10/2013
-RefundMoneyIn 1.1 : remboursement partiel de paiement par carte
-MoneyIn3DSInit et MoneyIn3DSConfirm : acquisition carte en 3DS direct, sans formulaire carte
-GetWalletDetails 1.3: Ajout des donnes des IBANs
4.6
H. Sadiki
21/10/2013 GetKycStatus 1.1
4.7
L. Zhu
31/10/2013 Ajout dinformations sur les diffrents comptes daccs aux APIs
4.8
L. Zhu
31/10/2013 -UpdateWalletDetails
4.9
L. Zhu
26/12/2013 RegisterWallet et UpdateWalletDetails : ajout de numro de tlphone de contact en entre
5.0
H. Sadiki / L. Zhu
08/01/2014
-autoCommission sur toutes les mthodes de moneyIn
-RefundMoneyIn : ajout de note informative et cas derreur
GetKycStatus 1.2
5.1
L. Zhu
29/01/2014 RefundMoneyIn 1.2 : correction des donnes en sortie
5.2
L. Zhu
27/02/2014
-MoneyIn3DInit 1.1 : par Atos
-Revue gnrale pour distinguer les fonctionnement par Atos ou Payline
-Prcision sur la gestion des commissions
5.3
L.Zhu
05/03/2014 MoneyInValidate : validation dun money-in pr-autoris



Lemon Way SAS - Kit Marchand - Guide dintgration page 4/95

5.4
H. Sadiki
04/04/2014
MoneyIn3DAuthenticate
CreateAmazonGift
5.5
L. Zhu
15/04/2014 Prcision sur la personnalisation des pages de paiement





Lemon Way SAS - Kit Marchand - Guide dintgration page 5/95

SOMMAIRE

1. INTRODUCTION ................................................................................................................. 8
1.1 A propos de ce document............................................................................................. 8
1.2 Dfinitions .................................................................................................................... 8
1.3 Prrequis ...................................................................................................................... 9
1.3.1 Comptes daccs lAPI ...................................................................................................................... 9
1.3.2 Wallet de la MARQUE BLANCHE ...................................................................................................... 10
1.4 Gestion des commissions .......................................................................................... 10
1.5 Mode diffr (par Atos uniquement) ........................................................................... 11
1.6 Support ...................................................................................................................... 11
1.7 Outil de gestion et de surveillance du CA et des paiements sur Internet .................... 11
1.8 Lutte contre la fraude et le blanchiment dargent (LAB-FT)......................................... 11
2. DIRECTKIT ....................................................................................................................... 12
2.1 Gnralits ................................................................................................................. 12
2.1.1 Requtes ............................................................................................................................................ 12
2.1.2 Rponses ........................................................................................................................................... 13
2.1.3 Erreurs ............................................................................................................................................... 13
2.2 FastPay : Paiement rapide sans besoin de gestion de wallet ..................................... 14
2.2.1 Cinmatique ....................................................................................................................................... 15
2.2.2 Requte.............................................................................................................................................. 15
2.2.3 Rponse ............................................................................................................................................. 20
2.2.4 Cas derreur ....................................................................................................................................... 22
2.3 RegisterWallet: Cration de wallet .............................................................................. 22
2.3.1 Cinmatique ....................................................................................................................................... 22
2.3.2 Requte.............................................................................................................................................. 22
2.3.3 Rponse ............................................................................................................................................. 24
2.3.4 Cas derreur ....................................................................................................................................... 24
2.4 UpdateWalletDetails: Mise jour dinformations de wallet .......................................... 24
2.4.1 Cinmatique ....................................................................................................................................... 24
2.4.2 Requte.............................................................................................................................................. 25
2.4.3 Rponse ............................................................................................................................................. 26
2.4.4 Cas derreur ....................................................................................................................................... 26
2.5 GetWalletDetails : Dtails dun wallet ......................................................................... 26
2.5.1 Cinmatique ....................................................................................................................................... 27
2.5.2 Requte.............................................................................................................................................. 27
2.5.3 Rponse ............................................................................................................................................. 27
2.5.4 Cas derreur ....................................................................................................................................... 33
2.6 MoneyIn : Crdit de wallet avec carte bancaire, sans 3D-Secure ............................... 33
2.6.1 Cinmatique ....................................................................................................................................... 33
2.6.2 Requte.............................................................................................................................................. 34
2.6.3 Rponse ............................................................................................................................................. 35
2.6.4 Cas derreur ....................................................................................................................................... 36
2.7 MoneyIn3DInit : Initialisation du crdit de wallet par CB 3D-Secure, en mode direct .. 36
2.7.1 Cinmatique ....................................................................................................................................... 36
2.7.2 Requte.............................................................................................................................................. 36
2.7.3 Rponse ............................................................................................................................................. 38
2.8 MoneyIn3DConfirm : Finalisation du crdit de wallet par 3DSecure, en mode direct .. 40
2.8.1 Cinmatique ....................................................................................................................................... 40
2.8.2 Requte.............................................................................................................................................. 40
2.8.3 Rponse ............................................................................................................................................. 42
2.8.4 Cas derreur ....................................................................................................................................... 42
2.9 MoneyInWebInit : Initialisation crdit de wallet par carte, en mode indirect ................ 43
2.9.1 Cinmatique ....................................................................................................................................... 43
2.9.2 Requte.............................................................................................................................................. 43
2.9.3 Rponse ............................................................................................................................................. 45



Lemon Way SAS - Kit Marchand - Guide dintgration page 6/95

2.9.4 Cas derreur ....................................................................................................................................... 45
2.10 RegisterCard : Enregistrement de carte bancaire ....................................................... 45
2.10.1 Cinmatique ....................................................................................................................................... 46
2.10.2 Requte.............................................................................................................................................. 46
2.10.3 Rponse ............................................................................................................................................. 47
2.10.4 Cas derreur ....................................................................................................................................... 47
2.11 UnregisterCard : Suppression de carte bancaire ........................................................ 47
2.11.1 Cinmatique ....................................................................................................................................... 47
2.11.2 Requte.............................................................................................................................................. 47
2.11.3 Rponse ............................................................................................................................................. 48
2.11.4 Cas derreur ....................................................................................................................................... 48
2.12 MoneyInWithCardId : Crdit de wallet avec carte bancaire pr-enregistre ................ 48
2.12.1 Cinmatique ....................................................................................................................................... 48
2.12.2 Requte.............................................................................................................................................. 49
2.12.3 Rponse ............................................................................................................................................. 50
2.12.4 Cas derreur ....................................................................................................................................... 50
2.13 MoneyInValidate : validation dun moneyIn ................................................................ 51
2.13.1 Cinmatique ....................................................................................................................................... 51
2.13.2 Requte.............................................................................................................................................. 51
2.13.3 Rponse ............................................................................................................................................. 51
2.13.4 Cas derreur ....................................................................................................................................... 52
2.14 SendPayment : Paiement entre wallets ...................................................................... 52
2.14.1 Cinmatique ....................................................................................................................................... 52
2.14.2 Requte.............................................................................................................................................. 53
2.14.3 Rponse ............................................................................................................................................. 53
2.14.4 Cas derreur ....................................................................................................................................... 54
2.15 RegisterIBAN : Enregistrement dIBAN ...................................................................... 54
2.15.1 Cinmatique ....................................................................................................................................... 54
2.15.2 Requte.............................................................................................................................................. 55
2.15.3 Rponse ............................................................................................................................................. 55
2.15.4 Cas derreur ....................................................................................................................................... 56
2.16 MoneyOut : Virement externe ..................................................................................... 56
2.16.1 Cinmatique ....................................................................................................................................... 56
2.16.2 Requte.............................................................................................................................................. 56
2.16.3 Rponse ............................................................................................................................................. 59
2.16.4 Cas derreur ....................................................................................................................................... 60
2.17 GetPaymentDetails : Rechercher un paiement ........................................................... 60
2.17.1 Cinmatique ....................................................................................................................................... 61
2.17.2 Requte.............................................................................................................................................. 61
2.17.3 Rponse ............................................................................................................................................. 61
2.17.4 Cas derreur ....................................................................................................................................... 62
2.18 GetMoneyInTransDetails : Rechercher un money-in .................................................. 63
2.18.1 Cinmatique ....................................................................................................................................... 63
2.18.2 Requte.............................................................................................................................................. 63
2.18.3 Rponse ............................................................................................................................................. 64
2.18.4 Cas derreur ....................................................................................................................................... 68
2.19 GetMoneyOutTransDetails : Rechercher un money-out ............................................. 68
2.19.1 Cinmatique ....................................................................................................................................... 68
2.19.2 Requte.............................................................................................................................................. 68
2.19.3 Rponse ............................................................................................................................................. 69
2.19.4 Cas derreur ....................................................................................................................................... 70
2.20 UploadFile : Upload dun justificatif ............................................................................. 70
2.20.1 Cinmatique ....................................................................................................................................... 70
2.20.2 Requte.............................................................................................................................................. 70
2.20.3 Rponse ............................................................................................................................................. 71
2.20.4 Cas derreur ....................................................................................................................................... 71
2.21 GetKycStatus: Recherche dutilisateurs, documents et IBAN modifi depuis une date72
2.21.1 Cinmatique ....................................................................................................................................... 72
2.21.2 Requte.............................................................................................................................................. 72
2.21.3 Rponse ............................................................................................................................................. 72



Lemon Way SAS - Kit Marchand - Guide dintgration page 7/95

2.21.4 Cas derreur ....................................................................................................................................... 76
2.22 GetMoneyInIBANDetails: Recherche de moneyIn par virement depuis une date ....... 76
2.22.1 Cinmatique ....................................................................................................................................... 76
2.22.2 Requte.............................................................................................................................................. 76
2.22.3 Rponse ............................................................................................................................................. 76
2.22.4 Cas derreur ....................................................................................................................................... 78
2.23 RefundMoneyIn : remboursement carte ..................................................................... 78
2.23.1 Cinmatique ....................................................................................................................................... 78
2.23.2 Requte.............................................................................................................................................. 78
2.23.3 Rponse ............................................................................................................................................. 80
2.23.4 Cas derreur ....................................................................................................................................... 81
2.24 GetBalances : Rcuprations de lensemble des soldes ............................................ 81
2.24.1 Cinmatique ....................................................................................................................................... 81
2.24.2 Requte.............................................................................................................................................. 82
2.24.3 Rponse ............................................................................................................................................. 82
2.24.4 Cas derreur ....................................................................................................................................... 83
2.25 MoneyIn3DAuthenticate: Savoir si lutilisateur fait lauthentification 3D Secure ....... 83
2.25.1 Cinmatique ....................................................................................................................................... 83
2.25.2 Requte.............................................................................................................................................. 83
2.25.3 Rponse ............................................................................................................................................. 84
2.25.4 Cas derreur ....................................................................................................................................... 85
2.26 CreateGiftCodeAmazon: Cration dun Chque-Cadeau Amazon.fr .......................... 85
2.26.1 Cinmatique ....................................................................................................................................... 85
2.26.2 Requte.............................................................................................................................................. 85
2.26.3 Rponse ............................................................................................................................................. 86
2.26.4 Cas derreur ....................................................................................................................................... 86
3. WEBKIT : .......................................................................................................................... 87
3.1 Gnralits ................................................................................................................. 87
3.1.1 Requtes ............................................................................................................................................ 87
3.1.2 Rponses ........................................................................................................................................... 87
3.1.3 Erreurs ............................................................................................................................................... 87
3.2 MoneyInWebFull : Rechargement de wallet par carte bancaire .................................. 88
3.3 MoneyInWebFinalize : Finalisation du crdit de wallet en mode indirect..................... 88
3.3.1 Cinmatique ....................................................................................................................................... 88
3.3.2 Requte.............................................................................................................................................. 89
3.3.3 Retour ................................................................................................................................................ 90
4. ANNEXE ........................................................................................................................... 92
4.1 Personnalisation de page de paiement ...................................................................... 92
4.1.1 Cas Payline ........................................................................................................................................ 92
4.1.2 Cas Atos ............................................................................................................................................. 92
4.1.3 Exemple de page de paiement ........................................................................................................... 93
4.2 Informations concernant le paiement 3D Secure ........................................................ 94
4.2.1 Exemple despace 3D Secure dune banque : ................................................................................... 95




Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 8/95


1. INTRODUCTION
1.1 A propos de ce document
Ce document prsente les diffrentes fonctionnalits offertes en marque blanche par Lemon
Way : la cration de wallets, lapprovisionnement de ces wallets, le paiement de wallet wallet,
le solde de wallet par virement bancaire.
Lusage tant le paiement de personne personne, le cadeau commun, la liste, la
cagnotte, etc.
La plateforme offre la possibilit de crer un compte de paiement pour les utilisateurs
rcolteurs qui effectuent une liste.
Le paiement seffectue ensuite partir dutilisateurs normaux qui utilisent leur carte pour
payer le teneur de la liste (listier).
Le teneur de la liste peut ensuite faire un virement vers sa banque lorsque sa rcolte est
termine.
La plateforme gre les comptes des listiers, les virements, les paiements par carte faits sur le
compte du listier.
Le listier peut galement approvisionner son propre compte avec sa carte bancaire.
En marque blanche, Lemon Way ne fait pas de communication directe avec les clients finaux
(listiers ou payeurs).

Lemon Way met disposition de la MARQUE BLANCHE :
- Un backoffice permettant de visualiser les oprations du systme et les clients
- Des webservices dans un DIRECTKIT
- Des pages web dans un WEBKIT
1.2 Dfinitions

MARQUE BLANCHE Site de e-Commerce ou de m-Commerce pouvant crer et
grer des wallets LEMON WAY, sous sa propre marque, ayant
pralablement contractualis avec Lemon Way.
CLIENT Personne possdant un wallet LEMON WAY en MARQUE
BLANCHE
WALLET La dfinition technique dun wallet est un compte technique
Certains comptes techniques correspondent des Comptes de
paiement au sens du Code Montaire et Financier
KIT LEMON WAY Dsigne lensemble des fonctionnalits et services mis
disposition des MARQUES BLANCHES
WEBKIT Dsigne les diffrentes pages web Lemon Way que les


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 9/95


MARQUES BLANCHES peuvent interroger ou sur lesquelles
ils peuvent rediriger leurs CLIENTS
DIRECTKIT Dsigne les diffrents webservices mis disposition des
MARQUES BLANCHES
BACKOFFICE Dsigne le site web de gestion mis disposition des
MARQUES BLANCHES
1.3 Prrequis
Un contrat de service avec une tarification adapte au volume, au taux de fraude et lactivit
du client, doit tre sign, pralablement la mise en place dun environnement de test.
- LEMON WAY demande la MARQUE BLANCHE de lui fournir la liste des IPs depuis
lesquelles la MARQUE BLANCHE se connectera au DIRECTKIT et au BACKOFFICE.
- LEMON WAY fournit la MARQUE BLANCHE 3 URLs lui permettant de se connecter
sur son environnement de test, dit SandBox :
o URL de DIRECTKIT
o URL de WEBKIT qui fournit une page de saisie de donnes carte
o URL du BACKOFFICE
Une fois limplmentation termine par la MARQUE BLANCHE, elle pourra demander le
passage en production, LEMON WAY enverra alors les URLs de production.
1.3.1 Comptes daccs lAPI
2 comptes daccs lAPI LEMON WAY sont fournis :
- Le login society (mot de passe par dfaut : 123456 ) quil est recommand de
donner aux dveloppeurs de la MARQUE BLANCHE : il possde tous les droits sur le
DIRECTKIT, mais des droits limits sur le BACKOFFICE
- Le login adminmb (mot de passe par dfaut : adminmb ) : il possde tous les
droits sur le DIRECTKIT et BACKOFFICE
Les mots de passe sont modifiables dans le menu Paramtres du BACKOFFICE :


Il est aussi possible dy crer des comptes daccs supplmentaires.



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 10/95


1.3.2 Wallet de la MARQUE BLANCHE
Un WALLET appartenant la MARQUE BLANCHE est aussi pr-cr. Il permettra la
MARQUE BLANCHE de recevoir des paiements ou des commissions, et LEMON WAY dy
prlever ses commissions.
Lidentifiant de ce WALLET est SC .
1.4 Gestion des commissions
Lemon Way prlve ses commissions automatiquement.
La MARQUE BLANCHE peut aussi demander se verser automatiquement des commissions,
chaque appel de crdit de wallet par carte de leurs CLIENTS par carte ou de dbit vers
compte bancaire de leurs CLIENTS.

Le versement des commissions automatiques se font dans cet ordre (ceci est le cas gnral, le
montant de la commission peut tre de 0) :

Pour un crdit de wallet CLIENT :
1. Crdit du wallet CLIENT du montant demand
2. Paiement de commission, du wallet CLIENT vers le wallet SC, du montant de la
commission automatique demande lors de la!!el "uniquement lors des crdits !ar
carte et non !ar virement#
$. Paiement de commission, du wallet SC vers Lemon %a&, de la commission d'inie
dans le contrat

Pour un d(it de wallet CLIENT vers com!te (ancaire
1. Paiement de commission, du wallet CLIENT vers le wallet SC, du montant de la
commission automatique demande lors de la!!el.
2. Paiement de commission, du wallet SC vers Lemon %a&, de la commission d'inie
dans le contrat
$. )(it du wallet CLIENT du montant demand, moins la commission automatique
demande !ar la *+,-.E /L+NC0E
Les oprations pourront chouer si le wallet SC ne possde pas un solde suffisant pour
sacquitter des commissions demandes par Lemon Way. Il conviendra donc la MARQUE
BLANCHE de :
Soit pr-crditer le wallet SC (par la mthode MoneyIn par carte, ou par virement)
Soit sassurer que les commissions quelle peroit automatiquement couvrent celles
demandes par Lemon Way



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 11/95


1.5 Mode diffr (par Atos uniquement)
Sur demande, le systme peut tre configur en mode de paiement diffr. Toutes les
demandes dalimentation de carte doivent alors tre valides dans un dlai de 3 ou 6 jours
selon la mthode utilise.
Dans le cas du mode diffr :
- Les diffrentes mthodes dalimentation de wallet restent inchanges
- Lors de leur excution, une demande dautorisation est faite mais nest pas encore
valide : la banque du porteur de la carte est informe du montant demand, et le
systme sassure que la carte est bien valide et que le montant est autoris
- Aprs lexcution, le wallet nest pas encore aliment
- Lorsque la MARQUE BLANCHE dcide de valider le paiement (et donc dalimenter le
wallet et de dbiter la carte), elle doit appeler MoneyInValidate. Si MoneyInValidate nest
pas appel avant expiration du dlai, le paiement est perdu et ne sera jamais valid.

Dlais selon la mthode dalimentation :
- MoneyInWebInit (paiement carte par formulaire de saisie de donnes carte Atos) : 6
jours
- MoneyIn (paiement carte direct sans 3DS) : 3 jours
- MoneyIn3DInit + MoneyIn3DConfirm (paiement carte direct avec 3DS) : 3 jours
1.6 Support
Un support technique est votre disposition pour lintgration, par Email, skype, et tlphone
fixe. Ces indications figurent sur votre contrat.
1.7 Outil de gestion et de surveillance du CA et des paiements sur
Internet
Un espace de gestion internet ddi vos paiements est disponible sur Internet, pour contrler
votre CA, avec vos environnements de test et de production. Des exports Excel sont
disponibles partir de ce BACKOFFICE Marque Blanche.
1.8 Lutte contre la fraude et le blanchiment dargent (LAB-FT)
Nous mettons votre disposition loutil Wonderstars, dont une documentation peut vous tre
envoye sur simple demande nos services.


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 12/95


2. DIRECTKIT
2.1 Gnralits
Les fonctionnalits suivantes sont disponibles :
- Cration de wallets
- Paiement entre wallets
- Rechargement de wallet par carte bancaire (CB, Visa, Mastercard), sans 3D Secure
- Rechargement par carte bancaire avec 3D Secure via pages web fournies
- Rechargement par carte bancaire avec 3D Secure sans pages web fournies
- Enregistrement de carte bancaire pour faciliter les crdits de wallet, sans 3D Secure
- Virement bancaire dun wallet vers le compte bancaire lui tant associ
- La rcupration des dtails des diffrents types de transactions (paiement, crdit,
virement)
Chaque fonctionnalit peut voluer indpendamment des autres. Afin de bnficier des
dernires mises jour des fonctionnalits, pensez utiliser la dernire version en renseignant
le numro de version dans le paramtre version en entre.
2.1.1 Requtes
Toutes les donnes doivent tre encodes en UTF-8, au format XML avec une enveloppe
SOAP :
<?xml version="1.0" encoding="utf-8"?><soap12:Envelope
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<MethodName xmlns="Service_mb">
<wlPass>string</wlPass>
<wlLogin>string</wlLogin>
<wlPDV>string</wlPDV>
<language> string </language>
<version> string </version>
<walletIp> string </walletIp>
<walletUa>string </walletUa>
</MethodName>
</soap12:Body>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 13/95


</soap12:Envelope>
MethodName : nom de la method

Toutes les requtes devront contenir les informations suivantes :

Element Description Requis Format Exemple
wlLogin Identifiant de connexion
de la marque blanche
Oui [1 : 50] car Pizza87
wlPass Cl fournie lors de la
cration de la marque
blanche
Oui [1 : 50] car aizohdeh78
language Langue dans laquelle
doit tre retourne la
rponse
Oui [2 : 3] car fr : Franais (par
dfaut)
version Version de la mthode.
La requte et la rponse
peuvent tre diffrents
pour une mme
mthode, selon la
version renseigne.
Oui [4] car 1.0 (par dfaut)
walletIp Adresse IP du client Oui car 91.222.286.32
walletUa User-agent du client Non car Mozilla/5.0 (Windows
NT 6.1; WOW64)

2.1.2 Rponses
Chaque rponse est retourne sous forme de chane de caractres:

<?xml version="1.0" encoding="utf-8" ?>
<String>Chane contenant la rponse XML</String>
2.1.3 Erreurs
En cas derreur, la structure du message est la suivante :
<?xml version="1.0" encoding="utf-8" ?>
<E>
<Error></Error>
<Code></Code>
<Msg></Msg>
<Prio></Prio>
</E>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 14/95


2.1.3.1 Tableau des tags XML
Element Description Type Exemple
Error Non utilis dans le kit
MARQUE BLANCHE
4N Non utilis dans le kit MARQUE BLANCHE
Code Code derreur 4N 120
Msg Message derreur String Format du numro de mobile non reconnu
Prio Priorit de lerreur N Non utilis dans le kit MARQUE BLANCHE
2.1.3.2 Cas derreur standard
Les erreurs suivantes sont susceptibles de se produire dans la plupart des mthodes les
mthodes.

Code Description
1
Erreur interne au systme
112
Marque blanche non reconnue
111
Solde insuffisant
123
Erreur inconnue du service dacquisition carte
134
Wallet non trouv
154
Wallet bloqu par scurit
166
Format de montant incorrect
141
Opration note comme invalide par le service dacquisition carte
141
Opration refuse par le service dacquisition carte
142
Erreur interne du service dacquisition carte
171
Erreur interne du systme de dbit de carte partenaire
217
Fraude suspecte par le service dacquisition carte
212
Erreur de format de donnes carte
221
Erreur de format de donnes IBAN
2$3
Format des donnes en entre incorrect
2.2 FastPay : Paiement rapide sans besoin de gestion de wallet
La mthode FastPay peut tre utilise pour les sites de e-Commerce qui ncessitent un
paiement par carte bancaire avec une intgration simple sous forme daller et de retour,
sans gestion de comptes de paiement via les Wallets.
Nous vous rappelons quil est interdit par Visa et Mastercard, si vous ntes pas habilit PCI-
DSS, de stocker les numros de carte bancaire sous quelque forme que ce soit. Merci de
vrifier vos bases de donnes et vos fichiers de logs, et de veiller cette rgle par mesure de
scurit et de lutte contre la fraude interne (utilisation de numros de cartes bancaires par vos
services techniques internes ou externaliss) et externe (hacking de votre serveur).
Si vous dsirez faire du rebill pour des offres dabonnement, nous vous proposons un
service de tokenisation de carte bancaire qui permet le rebill sans avoir mmoriser sur
votre systme informatique le numro de la carte bancaire de vos clients.


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 15/95


Les paiements collects par Lemon Way sont pays sur lIBAN (ex RIB) du marchand. Le
marchand dispose dune interface de contrle et de gestion de ses paiements, disponible sur
Internet, en plus de nos API.

Version Description
1.1

1.1
-Entre : pour les marques blanches nutilisant que cette mthode et
ne souhaitant pas grer un matelas pour les commissions
automatiques de LW, il est maintenant possible de demander le
prlvement automatique de cette commission sur le montant en
entre. Le montant crdit sera donc le montant en entre, moins la
commission prleve par Lemon Way
-Sortie : la rfrence du money-in li au paiement a t ajoute
1.2
-Entre : possibilit de sauvegarder la carte bancaire pour utilisation
ultrieur de MoneyInWithCardId
-Sortie : la rfrence de la carte sauvegarde
2.2.1 Cinmatique
Cette mthode ne ncessite quun seul point dintgration. Elle regroupe 3 fonctionnalits :
- La cration de wallet sil nexiste pas encore, avec comme identifiant lemail du client
- Le crdit du wallet par carte bancaire, sans 3D-Secure
- Le paiement dun wallet de destination
2.2.2 Requte
2.2.2.1 Version 1.0
La requte FastPay doit avoir la structure suivante :
<FastPay xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<clientMail>string</clientMail>
<clientTitle>string</clientTitle>
<clientFirstName>string</clientFirstName>
<clientLastName>string</clientLastName>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 16/95



<cardType>string</cardType>
<cardNumber>string</cardNumber>
<cardCrypto>string</cardCrypto>
<cardDate>string</cardDate>

<creditWallet>string</creditWallet>
<amount>string</amount>
<message>string</message>
</FastPay>


Element Description Requis Format Exemple
clientMail Adresse email du CLIENT Oui [6 :256] car adresse@domaine.co
m
clientTitle Civilit du CLIENT Non [1] car M : M.
F : Mme
U : Inconnu (dfaut)
clientFirstName Prnom du CLIENT Oui [1 :256] car Pierre
clientLastName Nom du CLIENT Oui [1 :256] car Dupont
cardType Type de carte bancaire Oui [1] car 0 : CB
1 : Visa
2 : Mastercard
cardNumber Numro 16 chiffres Oui [16] car 4972000011112222
cardCrypto Cryptogramme de la carte 3
chiffres
Oui [3] car 123
cardDate Date dexpiration de la carte Oui MM/yyyy 12/2013
creditWallet Identifiant du wallet crditer Oui [0 : 256] car taxi67
amount Montant du paiement Oui 2 dcimales 15.00
message Commentaire du paiement Non [0 :140] car Commande numro
245
2.2.2.2 Version 1.1
La requte FastPay doit avoir la structure suivante :
<FastPay xmlns=Service_mb>
<wlLogin>string</wlLogin>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 17/95


<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<clientMail>string</clientMail>
<clientTitle>string</clientTitle>
<clientFirstName>string</clientFirstName>
<clientLastName>string</clientLastName>

<cardType>string</cardType>
<cardNumber>string</cardNumber>
<cardCrypto>string</cardCrypto>
<cardDate>string</cardDate>

<creditWallet>string</creditWallet>
<amount>string</amount>
<message>string</message>
<autoCommission>string</autoCommission>
</FastPay>


Element Description Requis Format Exemple
clientMail Adresse email du CLIENT Oui [6 :256] car adresse@domaine.co
m
clientTitle Civilit du CLIENT Non [1] car M : M.
F : Mme
U : Inconnu (dfaut)
clientFirstName Prnom du CLIENT Oui [1 :256] car Pierre
clientLastName Nom du CLIENT Oui [1 :256] car Dupont
cardType Type de carte bancaire Oui [1] car
Ne pas
mettre
VISA !
0 : CB
1 : Visa
2 : Mastercard
cardNumber Numro de carte bancaire 16
chiffres
Oui [16] car 4972000011112222


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 18/95


cardCrypto Cryptogramme de la carte 3
chiffres
Oui [3] car 123
cardDate Date dexpiration de la carte Oui MM/yyyy 12/2013
creditWallet Identifiant du wallet crditer Oui [0 : 256] car taxi67
amount Montant du paiement Oui 2 dcimales 15.00
message Commentaire du paiement Non [0 :140] car Commande numro
245
autoCommissio
n
Indique si une commission doit
tre prleve directement sur
le montant total.
Si oui : [amount] sera prlev
sur la carte, et creditWallet
recevra [amount-la
commission automatique de
Lemon Way]
Oui [1] car 0 : non
1 : oui

2.2.2.1 Version 1.2
La requte FastPay doit avoir la structure suivante :
<FastPay xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<clientMail>string</clientMail>
<clientTitle>string</clientTitle>
<clientFirstName>string</clientFirstName>
<clientLastName>string</clientLastName>

<cardType>string</cardType>
<cardNumber>string</cardNumber>
<cardCrypto>string</cardCrypto>
<cardDate>string</cardDate>



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 19/95


<creditWallet>string</creditWallet>
<amount>string</amount>
<message>string</message>
<autoCommission>string</autoCommission>
<registerCard>string</registerCard>
</FastPay>


Element Description Requis Format Exemple
clientMail Adresse email du CLIENT Oui [6 :256] car adresse@domaine.co
m
clientTitle Civilit du CLIENT Non [1] car M : M.
F : Mme
U : Inconnu (dfaut)
clientFirstName Prnom du CLIENT Oui [1 :256] car Pierre
clientLastName Nom du CLIENT Oui [1 :256] car Dupont
cardType Type de carte bancaire Oui [1] car 0 : CB
1 : Visa
2 : Mastercard
cardNumber Numro 16 chiffres Oui [16] car 4972000011112222
cardCrypto Cryptogramme de la carte 3
chiffres
Oui [3] car 123
cardDate Date dexpiration de la carte Oui MM/yyyy 12/2013
creditWallet Identifiant du wallet crditer Oui [0 : 256] car taxi67
amount Montant du paiement Oui 2 dcimales 15.00
message Commentaire du paiement Non [0 :140] car Commande numro
245
autoCommissio
n
Indique si une commission doit
tre prleve directement sur
le montant total.
Si oui : [amount] sera prlev
sur la carte, et creditWallet
recevra [amount-la
commission automatique de
Lemon Way]
Oui [1] car 0 : non
1 : oui
registerCard Indique sil faut enregistrer la
carte et donner son identifiant
en sortie de lappel
Oui [1] car 0 : non
1 : oui


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 20/95


2.2.3 Rponse
2.2.3.1 Version 1.0
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
ID identifiant de la demande 255
DATE Date de la demande
10/09/2011 18:09:27
SEN Wallet dbiteur (email du
CLIENT dans ce cas)
Pizza56
REC Wallet bnficiaire pizza
DEB Montant dbiter 15.00
CRED Montant crditer 15.00
COM Commission 0.00
MSG Commentaire de la demande Commande numro 245
STATUS Non utilis dans le kit
MARQUE BLANCHE

2.2.3.2 Version 1.1
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<FROM_MONEYIN>string</FROM_MONEYIN>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 21/95


<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
ID identifiant du paiement 255
FROM_MONEYIN Identifiant du money-in
effectu (utile pour dventuels
remboursement)
367
DATE Date de la demande
10/09/2011 18:09:27
SEN Wallet dbiteur (email du
CLIENT dans ce cas)
Pizza56
REC Wallet bnficiaire pizza
DEB Montant dbiter 15.00
CRED Montant crditer 15.00
COM Commission 0.00
MSG Commentaire de la demande Commande numro 245
STATUS Non utilis dans le kit
MARQUE BLANCHE

2.2.3.1 Version 1.2
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<FROM_MONEYIN>string</FROM_MONEYIN>
<CARD_ID>string</CARD_ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
ID identifiant du paiement 255
FROM_MONEYIN Identifiant du money-in
effectu (utile pour dventuels
367


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 22/95


remboursement)
CARD_ID -Si la carte a t
sauvegarde : identifiant de la
carte sauvegarde
-Sinon : -1
32377
DATE Date de la demande
10/09/2011 18:09:27
SEN Wallet dbiteur (email du
CLIENT dans ce cas)
Pizza56
REC Wallet bnficiaire pizza
DEB Montant dbiter 15.00
CRED Montant crditer 15.00
COM Commission 0.00
MSG Commentaire de la demande Commande numro 245
STATUS Non utilis dans le kit
MARQUE BLANCHE

2.2.4 Cas derreur

Code Description
171
Autorisation refuse
2.3 RegisterWallet: Cration de wallet
Version Description
1.1
Sortie : ajout de lidentifiant unique du wallet, gnr par Lemon Way
2.3.1 Cinmatique
Avec la mthode RegisterWallet , le systme MARQUE BLANCHE demande Lemon Way
la cration dun wallet.
1. Lutilisateur saisit ses donnes
2. Lapplication appelle le webservice de Lemon Way
3. Lemon Way enregistre les donnes et cre le compte de paiement
4. Lapplication traite la rponse de Lemon Way et affiche un message de confirmation
2.3.2 Requte
La requte RegisterWallet doit avoir la structure suivante :
<RegisterWallet xmlns=Service_mb>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 23/95


<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<wallet>string</wallet>
<clientMail>string</clientMail>
<clientTitle>string</clientTitle>
<clientFirstName>string</clientFirstName>
<clientLastName>string</clientLastName>
<ctry>string</ctry>
<phoneNumber>string</phoneNumber>
</RegisterWallet>

Element Description Requis Format Exemple
wallet Identifiant du wallet
dans le systme en
marque blanche
Oui [1 :256] car 33612345678
clientMail Adresse email du
CLIENT. Doit tre
unique dans
lenvironnement de
la MARQUE
BLANCHE
Oui [6 :256] car adresse@domaine.com
clientTitle Civilit du CLIENT Non [1] car M : M.
F : Mme
U : Inconnu (dfaut)
clientFirstName Prnom du CLIENT Oui [1 :256] car Pierre
clientLastName Nom du CLIENT Oui [1 :256] car Dupont
ctry Pays du CLIENT, au
format ISO-3
Non [3] car FRA
phoneNumber Numro de
tlphone de
contact, en format
MSISDN : numro
international avec
code pays, sans le
+ ni 00
Non [6 :30] car 33672635263



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 24/95


2.3.3 Rponse
2.3.3.1 Version 1.0
< ?xml version="1.0" encoding="utf-8"?>
<WALLET>
<ID>string</ID>
</WALLET>

Element Description Exemple
ID Identifiant du wallet inscrit avec succs 33612345678
2.3.3.2 A partir de Version 1.1
< ?xml version="1.0" encoding="utf-8"?>
<WALLET>
<ID>string</ID>
<LWID>string</LWID>
</WALLET>

Element Description Exemple
ID Identifiant du wallet inscrit avec succs 33612345678
LWID Identifiant interne attribu par LEMON
WAY (identifiant affich dans le
BACKOFFICE)
2343
2.3.4 Cas derreur

Code Description
122
Wallet dj attribu un compte actif
213
Email dj utilis pour un autre compte actif
2.4 UpdateWalletDetails: Mise jour dinformations de wallet
Version Description
1.1

2.4.1 Cinmatique
Avec la mthode UpdateWalletDetails , le systme MARQUE BLANCHE demande Lemon
Way la mise jour dinformations lies un wallet CLIENT.
1. Lutilisateur saisit ses nouvelles donnes


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 25/95


2. Lapplication appelle le webservice de Lemon Way
3. Lemon Way enregistre les donnes lorsquelles existent
4. Lapplication traite la rponse de Lemon Way et affiche un message de confirmation

Pour ne pas modifier les donnes existantes dun champ, ne pas le renseigner.
2.4.2 Requte
La requte UpdateWalletDetails doit avoir la structure suivante :
<UpdateWalletDetails xmlns="Service_mb">
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<wallet>string</wallet>
<newEmail>string</newEmail>
<newTitle>string</newTitle>
<newFirstName>string</newFirstName>
<newLastName>string</newLastName>
<newCtry>string</newCtry>
<newIp>string</newIp>
<newPhoneNumber>string</newPhoneNumber>
</UpdateWalletDetails>

Element Description Requis Format Exemple
wallet Identifiant du wallet
dans le systme en
marque blanche
Oui [1 :256] car 33612345678
newMail Nouvelle adresse
email du CLIENT.
Doit tre unique
dans
lenvironnement de
la MARQUE
BLANCHE
Non [6 :256] car adresse@domaine.com
newTitle Civilit du CLIENT Non [1] car M : M.
F : Mme


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 26/95


U : Inconnu (dfaut)
newFirstName Prnom du CLIENT Non [1 :256] car Pierre
newLastName Nom du CLIENT Non [1 :256] car Dupont
newCtry Pays du CLIENT Non [3] car FRA
newIp Adresse IP du
CLIENT
Non car 91.222.286.32
newPhoneNum
ber
Numro de
tlphone de
contact, en format
MSISDN : numro
international avec
code pays, sans le
+ ni 00
Non [6 :30] car 33672635263
2.4.3 Rponse
2.4.3.1 Version 1.0
< ?xml version="1.0" encoding="utf-8"?>
<WALLET>
<ID>string</ID>
<LWID>string</LWID>
</WALLET>

Element Description Exemple
ID Identifiant du wallet mis jour avec
succs
33612345678
LWID Identifiant interne attribu par LEMON
WAY (identifiant affich dans le
BACKOFFICE)
2343
2.4.4 Cas derreur

Code Description
213
Email dj utilis pour un autre wallet actif
2.5 GetWalletDetails : Dtails dun wallet
Version Description
1.1
Ajout en sortie des statuts de tous les documents uploads et des
IBANs.
1.2
Ajout en sortie du type de document upload


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 27/95


1.$
Ajout pour les IBANs des donnes et des codes SWIFT
2.5.1 Cinmatique
Avec la mthode GetWalletDetails, la MARQUE BLANCHE peut vrifier les dtails dun
wallet de son systme : statut, solde, IBAN rattach, etc.
2.5.2 Requte
La requte GetWalletDetails doit avoir la structure suivante :
< GetWalletDetails xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<wallet>string</wallet>
</GetWalletDetails>

Element Description Requis Format Exemple
wallet Identifiant du wallet Oui [0 : 256] car 33612345678 ou
taxi67
2.5.3 Rponse
2.5.3.1 Version 1.0

< ?xml version="1.0" encoding="utf-8"?>
<WALLET>
<ID>string<ID>
<BAL>string</BAL>
<NAME>string<NAME>
<EMAIL>string<EMAIL>
<IBAN>
<S></S>
<IBAN>
<S>string<S>
</WALLET>




Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 28/95


Element Description Exemple
WALLET Correspond un wallet
ID Identifiant du wallet 33612345678 ou
taxi67
BAL Solde du wallet
23.90
NAME Nom et prnom Jean Dupont
EMAIL Email Jean.dupont@email.c
om
IBAN
Correspond lIBAN li au wallet

IBAN > S
Correspond au statut du dernier IBAN associ au
wallet:
0 : pas diban li au wallet
2 : en attente de vrification
5 : vrifi, approuv, utilisable
8 : dsactiv
9 : rejet
2
S Statut du wallet :
5 : enregistr (statut donn aprs cration)
6 : documents envoys
12 : ferm
5
2.5.3.2 Version 1.1

< ?xml version="1.0" encoding="utf-8"?>
<WALLET>
<ID>string<ID>
<BAL>string</BAL>
<NAME>string<NAME>
<EMAIL>string<EMAIL>
<DOCS>
<DOC>
<ID>docId</ID>
<S>documentStatus</S>
</DOC>
...
<DOC>
<ID> docId </ID>
<S>documentStatus</S>
</DOC>
</DOCS>
<IBANS>
<IBAN>
<ID>ibanId</ID>
<S>status</S>
</IBAN>
</IBANS>
<S>string<S>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 29/95


</WALLET>


Element Description Exemple
WALLET Correspond un wallet
ID Identifiant du wallet 33612345678 ou
taxi67
BAL Solde du wallet
23.90
NAME Nom et prnom Jean Dupont
EMAIL Email Jean.dupont@email.c
om
DOCS Liste des documents dont le statut a chang depuis
la date mis en entre

DOC Correspond un document
DOC>ID ID du document 20
DOC>S Statut du document :
1: Document uniquement reu
2: Document vrifi et accept
3: Document vrifi mais non accept
4: Document remplac par un autre document
5: Validit du document expir
2
IBANS Liste des IBAN dont le statut a chang depuis la
date mis en entre

IBAN Correspond un IBAN
IBAN >ID ID de liban 98
IBAN >S Statut de liban :
0 : pas diban li au wallet
5 : utilisable
6 : utilisable, vrifi par Lemon Way
8 : dsactiv
9 : rejet

2
S Statut du wallet :
5 : enregistr (statut donn aprs cration)
6 : documents envoys
12 : ferm
5
2.5.3.3 Version 1.2



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 30/95


< ?xml version="1.0" encoding="utf-8"?>
<WALLET>
<ID>string<ID>
<BAL>string</BAL>
<NAME>string<NAME>
<EMAIL>string<EMAIL>
<DOCS>
<DOC>
<ID>docId</ID>
<S>documentStatus</S>
<TYPE>documentType</TYPE>
</DOC>
...
<DOC>
<ID>docId</ID>
<S>documentStatus</S>
<TYPE>documentType</TYPE>
</DOC>
</DOCS>
<IBANS>
<IBAN>
<ID>ibanId</ID>
<S>status</S>
</IBAN>
</IBANS>
<S>string<S>
</WALLET>


Element Description Exemple
WALLET Correspond un wallet
ID Identifiant du wallet 33612345678 ou
taxi67
BAL Solde du wallet
23.90
NAME Nom et prnom Jean Dupont
EMAIL Email Jean.dupont@email.c
om
DOCS Liste des documents dont le statut a chang
depuis la date mis en entre

DOC Correspond un document
DOC>ID ID du document 20
DOC>S Statut du document :
1: Document uniquement reu
2: Document vrifi et accept
3: Document vrifi mais non accept
4: Document remplac par un autre document
2


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 31/95


5: Validit du document expir
DOC>TYPE Type de document :
0: carte d'identit de la Communaut Euro
1: justificatif de domicile (fournisseurs d'nergie,
tel fixe, feuille d'imposition)
2: scan ou copie dun RIB
7 : Kbis
11 : document divers 1
12 : document divers 2
13 : document divers 3
0
IBANS Liste des IBAN dont le statut a chang depuis la
date mis en entre

IBAN Correspond un IBAN
IBAN >ID ID de liban 98
IBAN >S Statut de liban :
0 : pas diban li au wallet
5 : utilisable
6 : utilisable, vrifi par Lemon Way
8 : dsactiv
9 : rejet

2
S Statut du wallet :
5 : enregistr (statut donn aprs cration)
6 : documents envoys
13 : ferm
5
2.5.3.4 Version 1.3

< ?xml version="1.0" encoding="utf-8"?>
<WALLET>
<ID>string<ID>
<BAL>string</BAL>
<NAME>string<NAME>
<EMAIL>string<EMAIL>
<DOCS>
<DOC>
<ID>docId</ID>
<S>documentStatus</S>
<TYPE>documentType</TYPE>
</DOC>
...
<DOC>
<ID>docId</ID>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 32/95


<S>documentStatus</S>
<TYPE>documentType</TYPE>
</DOC>
</DOCS>
<IBANS>
<IBAN>
<ID>ibanId</ID>
<S>status</S>
<DATA>iban</DATA>
<SWIFT>swiftCode</SWIFT>
</IBAN>
</IBANS>
<S>string<S>
</WALLET>


Element Description Exemple
WALLET Correspond un wallet
ID Identifiant du wallet 33612345678 ou
taxi67
BAL Solde du wallet
23.90
NAME Nom et prnom Jean Dupont
EMAIL Email Jean.dupont@email.c
om
DOCS Liste des documents dont le statut a chang
depuis la date mis en entre

DOC Correspond un document
DOC>ID ID du document 20
DOC>S Statut du document :
1: Document uniquement reu
2: Document vrifi et accept
3: Document vrifi mais non accept
4: Document remplac par un autre document
5: Validit du document expir
2
DOC>TYPE Type de document :
0: carte d'identit de la Communaut Euro
1: justificatif de domicile (fournisseurs d'nergie,
tel fixe, feuille d'imposition)
2: scan ou copie dun RIB
7 : Kbis
11 : document divers 1
0


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 33/95


12 : document divers 2
13 : document divers 3
IBANS Liste des IBAN dont le statut a chang depuis la
date mis en entre

IBAN Correspond un IBAN
IBAN >ID ID de liban 98
IBAN >S Statut de liban :
0 : pas diban li au wallet
5 : utilisable
6 : utilisable, vrifi par Lemon Way
8 : dsactiv
9 : rejet

2
IBAN>DATA Donnes de lIBAN enregistr 30002014400000156
627A61
IBAN>SWIF
T
Code SWIFT associ lIBAN (code BIC) CRLYFRPP
S Statut du wallet :
5 : enregistr (statut donn aprs cration)
6 : documents envoys
14 : ferm
5
2.5.4 Cas derreur
Pas de cas derreur spcifique.
2.6 MoneyIn : Crdit de wallet avec carte bancaire, sans 3D-Secure
Version Description
1.1

2.6.1 Cinmatique
Cette mthode ne ncessite quun seul point dintgration.
Avec la mthode MoneyIn , le systme effectue un rechargement du wallet par carte
bancaire, sans 3D-Secure :
1. Lapplication MARQUE BLANCHE envoie Lemon Way lidentifiant du wallet crditer,
lidentifiant de la carte bancaire associe au wallet, le montant crditer, et un
commentaire
2. Lemon Way rpond


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 34/95


2.6.2 Requte
La requte MoneyIn doit avoir la structure suivante :
<MoneyIn xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<wallet>string</wallet>
<cardType>string</cardType>
<cardNumber>string</cardNumber>
<cardCrypto>string</cardCrypto>
<cardDate>string</cardDate>
<amountTot>string</amount>
<amountCom>string</amountCom>
<comment>string</comment>
<autoCommission>string</autoCommission>
</MoneyIn>

Element Description Requis Format Exemple
wallet Identifiant du wallet crditer Oui [0 : 256] car 33612345678 ou
taxi67
cardType Type de carte bancaire Oui [1] car 0 : CB
1 : Visa
2 : Mastercard
cardNumber Numro 16 chiffres Oui [16] car 4972000011112222
cardCrypto Cryptogramme de la carte 3
chiffres
Oui [3] car 123
cardDate Date dexpiration de la carte Oui MM/yyyy 12/2013
amountTot Montant dbiter de la CB Oui 2 dcimales 15.00
amountCom Montant que la MARQUE
BLANCHE souhaite prlever
Non 2 dcimales 1.00
comment Commentaire du paiement Non [0 :140] car Commande numro
245


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 35/95


autoCommis
sion
Indique si une commission doit
tre prleve directement sur
le montant total.
Si oui : [amount] sera prlev
sur la carte, et creditWallet
recevra [amount-la
commission automatique de
Lemon Way]
Sinon la valeur amountCom
sera utilise
Non [1] car 0 : non (par dfaut)
1 : oui
2.6.3 Rponse
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<MLABEL>string</MLABEL>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
ID identifiant de la transaction 255
MLABEL Numro de carte masqu XXXX XXXX XXXX
9845
DATE Date de la demande
10/09/2011
18:09:27
SEN Vide dans ce cas
REC Wallet crditer Pizza56
DEB 0.00 dans ce cas 0.00
CRED Montant crditer au wallet
(total moins la commission)
15.00
COM Commission prleve par la
MARQUE BLANCHE
2.00
MSG Commentaire Commande numro
245


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 36/95


STATUS Non utilis dans le kit
MARQUE BLANCHE

2.6.4 Cas derreur

Code Description
171
Autorisation refuse
2.7 MoneyIn3DInit : Initialisation du crdit de wallet par CB 3D-
Secure, en mode direct
Version Description
1.1

1.1
Version avec Atos
2.7.1 Cinmatique
Cette fonctionnalit ncessitera 3 points dintgration par la MARQUE BLANCHE :
1. Lapplication MARQUE BLANCHE appelle MoneyIn3DInit du DIRECTKIT pour initialiser
les donnes du rechargement de WALLET : lidentifiant du wallet, les montants et
donnes de la carte. LEMON WAY retourne les informations permettant la MARQUE
BLANCHE de rediriger son CLIENT vers le site dauthentification 3DSecure de sa
banque, ainsi quun identifiant de transaction que la MARQUE BLANCHE devra
renvoyer pour finaliser lacquisition carte.
2. Lapplication de la MARQUE BLANCHE redirige le CLIENT vers le site dauthentification
3D Secure
3. Lapplication attend le retour du CLIENT aprs son authentification 3D Secure, puis
appelle MoneyIn3DConfirm du DIRECTKIT pour demander le dbit de la carte. (Voir
paragraphe suivant pour le dtail de lappel MoneyIn3DConfirm)
2.7.2 Requte
La requte MoneyIn3DInit doit avoir la structure suivante :
< MoneyIn3DInit xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 37/95


<wallet>string</wallet>
<amountTot>string</amountTot>
<amountCom>string</amountCom>
<comment>string</comment>
<wkToken>string</wkToken>
<cardType>string</cardType>
<cardNumber>string</cardNumber>
<cardCode>string</cardCode>
<cardDate>string</cardDate>
<autoCommission>string</autoCommission>
<returnUrl>string</returnUrl>
</MoneyIn3DInit>

Element Description Requis Format Exemple
wallet Identifiant du wallet crditer Oui [0 : 256] car 33612345678 ou
taxi67
amountTot Montant dbiter de la CB Oui 2 dcimales
15.00
amountCom Montant que la MARQUE
BLANCHE souhaite prlever
Non 2 dcimales 1.00
comment Commentaire concernant la
transaction
Non [0 :140] car Commande numro
245
wkToken Identifiant unique de lappel,
cr par le systme de la
MARQUE BLANCHE, sera
retourn par Lemon Way la
fin de lopration, en POST sur
lURL de retour fournie par la
MARQUE BALNCHE
Oui [1 : 10] car 5652772
cardType Type de carte bancaire Oui [1] car 0 : CB
1 : Visa
2 : Mastercard
cardNumber Numro 16 chiffres Oui [16] car 4972000011112222
cardCode Cryptogramme de la carte 3
chiffres
Oui [3] car 123
cardDate Date dexpiration de la carte Oui MM/yyyy 12/2013
autoCommis
sion
Indique si une commission doit
tre prleve directement sur
le montant total.
Oui [1] car 0 : non (par dfaut)
1 : oui


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 38/95


Si oui : [amount] sera prlev
sur la carte, et creditWallet
recevra [amount-la
commission automatique de
Lemon Way]
Sinon la valeur amountCom
sera utilise
returnUrl URL de retour vers laquelle le
site dauthentification 3D
Secure redirigera votre
CLIENT
Oui si
contrat
Atos
https://www.monsite.c
om/payment/?id=356
2.7.3 Rponse
La rponse contient des donnes passer au site dauthentification 3D Secure.

< ?xml version="1.0" encoding="utf-8"?>
<MONEYIN3DINIT>
<ACS>
<actionUrl>string</actionUrl>
<actionMethod>string</actionMethod>
<pareqFieldName>string</pareqFieldName>
<pareqFieldValue>string</pareqFieldValue>
<termurlFieldName>string</termurlFieldName>
<mdFieldName>string</mdFieldName>
<mdFieldValue>string</mdFieldValue>
<mpiResult>string</mpiResult>
</ACS>
<TRANS>
<HPAY>
<ID>string</ID>
<MLABEL>string</MLABEL>
<DATE> string </DATE>
<SEN> string</SEN>
<REC>string</REC>
<DEB>string</DEB>
<CRED>string</CRED>
<COM>string</COM>
<MSG>string</MSG>
<STATUS>string</STATUS>
</HPAY>
</TRANS>
</MONEYIN3DINIT>


Element Description Exemple
ACS
Balise encapsulant les
donnes renvoyes par le
systme metteur de la carte

ACS>actionUrl
URL sur lequel il faut rediriger
https%3a%2f%2facs.


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 39/95


le client pour quil effectue
lauthentification 3DS
modirum.com%2fmdp
ayacs%2fpareq
ACS>actionMethod
Uniquement si contrat Payline.
Mthode utiliser pour
transmettre les informations
la plateforme dauthentification
3DS (GET ou POST)
POST
ACS>pareqFieldName
Uniquement si contrat Payline.
Nom du champ utiliser pour
la transmission de la donne
pareq
PaReq
ACS>pareqFieldValue
Uniquement si contrat Payline.
Donne pareq
transmettre
eJxVkdtSwjAQhl+F4QGapPTIL
JlBYZQZW7XCoNxl2tVWe4C0t
fD2JqWIXmW/PWX3X1inEnHx
gnErkUOAdS0+cJQls7FLKaMe
G3N4mkd44PCNss6qkjODGia
QC6oiGaeibDiI+HCzCrnlu67jA
hkQCpSrBWcOZd7EtphNXZ/6
QM5uKEWB/GEZPIaj7fwNSM8
QV23ZyBM3bQrkAtDKnKdNs5
8S0nWdkWNRlZ04Ge8SiI4Bu
Q7z1GqrVr2OWcKDdboNPyN
HbMI8ed0F0VfzvLuz85DGMyA
6AxLRIDcpm1DfdEbMm07Y1H
SA9H4QhR6CLzfRiFGDqqkGD
+z1R/MzMKojfz2glJVYxifuu55a
5UKAx31VospQWv7akGAdqz
WG57rD7b2WN26UYpbW17a1
vj3rTplSh1mM9q00ANEVZDgd
GQ6rrH8H/wH/Naap
ACS>
termurlFieldName
Uniquement si contrat Payline.
Nom du champ utiliser pour
la transmission de votre URL
de retour
TermUrl
ACS>mdFieldName
Uniquement si contrat Payline.
Nom du champ utiliser pour
la transmission de la donne
md
MD
ACS>mdFieldValue
Uniquement si contrat Payline.
Donne md transmettre
18V64ziCeuvLFKPdne
7G
ACS>mpiResult
Nest plus utilis

TRANS>HPAY
Balise encapsulant un rsum
de la transaction initialise

TRANS>HPAY>ID
Identifiant de la transaction,
sauvegarder pour le renvoyer
ltape de confirmation
677
TRANS>HPAY>MLABE
L
Non utilis dans le cadre de la
marque blanche

TRANS>HPAY>DATE
Date de linitialisation

TRANS>HPAY>SEN
Non utilis

TRANS>HPAY>REC Wallet crditer Pizza56
TRANS>HPAY>DEB 0.00 dans ce cas 0.00


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 40/95


TRANS>HPAY>CRED Montant crditer au wallet
(total moins la commission)
15.00
TRANS>HPAY>COM Commission prleve par la
MARQUE BLANCHE
2.00
TRANS>HPAY>MSG Commentaire Commande numro
245
TRANS>HPAY>STATU
S
Non utilis dans le kit
MARQUE BLANCHE
0

Exemple de formulaire utiliser pour rediriger le CLIENT vers le site dauthentification :
<form action="https://acs.modirum.com/mdpayacs/pareq" method="post">
<input type="text" name=".$pareqFieldName ." value=".$pareqFieldValue.">
<input type="text" name=".$termurlFieldName." value=".$myReturnUrl.">
<input type="text" name=".$mdFieldName." value=".$mdFieldValue.">
<input type="submit" name="submit" class="submit" value="Go to 3DS"></form>
2.8 MoneyIn3DConfirm : Finalisation du crdit de wallet par
3DSecure, en mode direct
Version Description
1.1

2.8.1 Cinmatique
Cette mthode permet de finaliser un crdit de WALLET par carte aprs authentification
3DSecure du CLIENT :
- Aprs avoir initialis cette opration avec MoneyIn3DInit, lapplication a redirig son
CLIENT vers le site dauthentification de lmetteur de la carte bancaire.
- Le CLIENT effectue son authentification puis retourne sur lapplication de la MARQUE
BLANCHE avec des donnes en paramtre POST
- Lapplication appelle MoneyIn3DConfirm avec les donnes en paramtre, pour finaliser
le crdit de WALLET par dbit de la carte bancaire
2.8.2 Requte
La requte MoneyIn3DConfirm doit avoir la structure suivante :
<MoneyIn3DConfirm xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 41/95


<walletUa>string</walletUa>
<transactionId>string</transactionId>
<MD>string</MD>
<PaRes>string</PaRes>
<cardType>string</cardType>
<cardNumber>string</cardNumber>
<cardCode>string</cardCode>
<cardDate>string</cardDate>
</MoneyIn3DConfirm>

Element Description Requis Format Exemple
transactionId Identifiant de la transaction
finaliser
Oui int 255
MD Donne MD retourne par le
site dauthentification
3DSecure
Oui si
contrat
Payline
String 1Ok9dCP55UUkWfdJ
wEid
PaRes Donne Pares retourne par le
site dauthentification
3DSecure
Oui si
contrat
Payline
string
eJxVkdtSwjAQhl+lwwM0SY+
EWTKDgsKMICIgXGbaVaq0h
bS18PYmpYheZb89ZfdfWO4
U4vAVo0qhgCkWhfxAK4n7n
YDz0HNZR8B8sMCjgG9URZ
JngtnUdoBcURepaCezUoCMj
neTmfB4GAYhkBYhRTUZCh
ZQ1nV9j/k05JQDubghkymKp
9H0eWa9DbZAGoYor7JSnY
XjUyBXgErtxa4sDz1C6rq295j
mWS3P9rsCYmJAbsPMK2M
VutcpicV0dUpevkq1TuNKpg+
bxef6ETez9XK87QMxGRDLE
oVDmUu541sO7bFuz/GANH
6QqRlCjFYLi1Gb6qlaDxzMR4
MLMGoifz2glVWYRWfBw65e
5UqAp0Oeoc7QWv7aEGMR6
TXa57bD/djIG5VaMc/jfhgERt
+GTadEq8M8RptWBoCYCtK
ejrSH1da/g/8A8pmnfg==
cardType Type de carte bancaire Oui si
contrat
Payline
[1] car 0 : CB
1 : Visa
2 : Mastercard
cardNumber Numro 16 chiffres Oui si
contrat
Payline
[16] car 4972000011112222
cardCode Cryptogramme de la carte 3
chiffres
Oui si
contrat
Payline
[3] car 123
cardDate Date dexpiration de la carte Oui si
contrat
MM/yyyy 12/2013


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 42/95


Payline
2.8.3 Rponse
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<MLABEL>string</MLABEL>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
ID identifiant de la transaction 255
MLABEL Non utilis
DATE Date de la demande
10/09/2011
18:09:27
SEN Non utilis dans ce cas
REC Wallet crditer Pizza56
DEB 0.00 dans ce cas 0.00
CRED Montant crditer au wallet
(total moins la commission)
15.00
COM Commission prleve par la
MARQUE BLANCHE
2.00
MSG Commentaire Commande numro
245
STATUS Non utilis dans le kit
MARQUE BLANCHE
3
2.8.4 Cas derreur

Code Description
171
Autorisation refuse


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 43/95


2.9 MoneyInWebInit : Initialisation crdit de wallet par carte, en mode
indirect
Version Description
1.1
Lentre wkToken sera sauvegarde et pourra permettre de retrouver
le moneyIn dans la mthode de recherche GetMoneyInTranDetails
2.9.1 Cinmatique
Cette fonctionnalit permet la MARQUE BLANCHE dutiliser les pages web de notre service
dacquisition carte.
Cette fonctionnalit ncessitera 3 points dintgration par la MARQUE BLANCHE :
- Un appel au DIRECTKIT pour initialiser les donnes du rechargement de wallet
- Une redirection du site web de la MARQUE BLANCHE vers le WEBKIT
- Une page de retour sur laquelle le WEBKIT POST le rsultat

1. Lapplication MARQUE BLANCHE envoie Lemon Way lidentifiant du wallet, un token
de requte qui lui permettra de traiter la rponse du WEBKIT, et les montants
2. Lemon Way retourne un token de money-in
3. Le site web de la MARQUE BLANCHE redirige le CLIENT vers le WEBKIT de Lemon
Way, en passant le token de money-in en paramtre GET. (Voir chapitre 3.3
MoneyInWebFinalize : finalisation de crdit de wallet)
2.9.1.1 Version 1.0
Le paramtre wkToken ne sera pas sauvegard.
2.9.1.2 Version 1.1
Le paramtre wkToken sera sauvegard et il sera possible de retrouver le money-in avec cette
donne.
2.9.2 Requte
La requte MoneyInWebInit doit avoir la structure suivante :
< MoneyInWebInit xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 44/95


<walletUa>string</walletUa>
<wallet>string</wallet>
<amountTot>string</amountTot>
<amountCom>string</amountCom>
<comment>string</comment>
<useRegisteredCard>string</useRegisteredCard>
<wkToken>string</wkToken>
<returnUrl>string</returnUrl>
<cancelUrl>string</cancelUrl>
<errorUrl>string</errorUrl>
<autoCommission>string</autoCommission>
</MoneyInWebInit>

Element Description Requis Format Exemple
wallet Identifiant du wallet crditer Oui [0 : 256] car 33612345678 ou
taxi67
amountTot Montant dbiter de la CB Oui 2 dcimales
15.00
amountCom Montant que la MARQUE
BLANCHE souhaite prlever
Non 2 dcimales 1.00
comment Commentaire concernant la
transaction
Non [0 :140] car Commande numro
245
useRegistere
dCard
0 : ne pas enregistrer de carte
ni utiliser de carte enregistre
1 : proposer dutiliser une carte
enregistre ou enregistrer la
carte
Non
(0 par
dfaut)
[0 :1] car 0
wkToken Identifiant unique de lappel,
cr par le systme de la
MARQUE BLANCHE, sera
retourn par Lemon Way la
fin de lopration, en POST sur
lURL de retour fournie par la
MARQUE BALNCHE
Oui [1 : 10] car 5652772
returnUrl url de retour sur le site de la
MARQUE BLANCHE, que le
WEBKIT appellera pour
signifier la fin de lopration
Oui [1 : max] car https://www.votresite.
com/payment_return.
php
errorUrl url de retour sur le site de la
MARQUE BLANCHE, que le
WEBKIT appellera pour
Oui [1 : max] car https://www.votresite.
com/payment_return.
php


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 45/95


signaler une erreur
cancelUrl url de retour sur le site de la
MARQUE BLANCHE, que le
WEBKIT appellera en cas
dannulation de lopration
Oui [1 : max] car https://www.votresite.
com/payment_return.
php
autoCommis
sion
Indique si une commission doit
tre prleve directement sur
le montant total.
Si oui : [amount] sera prlev
sur la carte, et creditWallet
recevra [amount-la
commission automatique de
Lemon Way]
Sinon la valeur amountCom
sera utilise
Oui [1] car 0 : non (par dfaut)
1 : oui
2.9.3 Rponse
< ?xml version="1.0" encoding="utf-8"?>
<MONEYINWEB>
<TOKEN>String</TOKEN>
</MONEYINWEB>


Element Description Exemple
TOKEN
Token de paiement passer
en GET vers lURL du webkit
1wGaBwkdOmOxWT0
s4t1Z1364815798094
2.9.4 Cas derreur
Pas de cas derreur spcifique.
2.10 RegisterCard : Enregistrement de carte bancaire
Cette fonctionnalit permet le Rebill dune carte bancaire, ou le One Clic payment. Nous
rappelons quil est de votre devoir, pour tre conforme la rglementation, davertir votre client
du Rebill, au moins par Email, afin quun suivi de ses paiements soit disponible, et quil puisse
annuler son abonnement auprs de vos services, au moyen dun formulaire sur votre site ; afin
de faire baisser le taux de Charge Back carte.
Note importante : si vous changez de descripteur carte bancaire auprs de Lemon Way, les
informations de Rebill seront perdues ; car les token sont propres un descripteur (le
descripteur est ouvert et choisit lors de votre entre en relation commerciale avec notre
tablissement de paiement. Il correspond la mention lisible sur le relev carte bancaire de vos
clients, ainsi qu la mention du nom du site sur lequel lachat est effectu, lors du paiement en
3D Secure.


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 46/95



Version Description
1.1

2.10.1 Cinmatique
Avec la mthode RegisterCard , le systme peut envoyer une demande dassociation dune
carte bancaire un wallet. Lors des futures acquisitions par carte bancaire, la saisie des
donnes carte ne sera alors plus ncessaire :
1. Lapplication MARQUE BLANCHE envoie Lemon Way lidentifiant du wallet, ainsi que
les informations sur la carte bancaire
2. Lemon Way rpond
2.10.2 Requte
La requte RegisterCard doit avoir la structure suivante :
<RegisterCard xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
</wallet>string</wallet>
<cardType>string</cardType>
<cardNumber>string</cardNumber>
<cardCode>string</cardCode>
<cardDate>string</cardDate>
</RegisterCard>

Element Description Requis Format Exemple
wallet Identifiant du wallet Oui [0 : 256] car 33612345678 ou
taxi67
cardType Type de la carte Oui [1 :1] car
0 : CB
1 : Visa
2 : Mastercard
cardNumber Numro de la carte Oui [16] chiffres 4972000011112222
cardCode Cryptogramme de la carte Oui [3 : 4] car 123


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 47/95


cardDate Date dexpiration de la carte Oui [7] car 06/2013
2.10.3 Rponse
< ?xml version="1.0" encoding="utf-8"?>
<CARD>
<ID>String</ID>
</CARD>


Element Description Exemple
ID identifiant de la carte
enregistre
255
2.10.4 Cas derreur

Code Description
119
Format des informations de carte incorrect
171
Autorisation refuse
2.11 UnregisterCard : Suppression de carte bancaire
Version Description
1.1

2.11.1 Cinmatique
Pour le moment, une seule carte est autorise par wallet. La mthode UnregisterCard permet
de ne plus associer une carte un wallet :
3. Lapplication MARQUE BLANCHE envoie Lemon Way lidentifiant du wallet, ainsi que
lidentifiant de la carte bancaire
4. Lemon Way rpond
2.11.2 Requte
La requte UnregisterCard doit avoir la structure suivante :
<UnregisterCard xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 48/95


<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
</wallet>string</wallet>
<cardId>string</cardId>
</UnregisterCard>

Element Description Requis Format Exemple
wallet Identifiant du wallet Oui [0 : 256] car 33612345678 ou
taxi67
cardId Identifiant de la carte bancaire
dsactiver
Oui [1 :12] car
235
2.11.3 Rponse
< ?xml version="1.0" encoding="utf-8"?>
<CARD>
<ID>String</ID>
</CARD>


Element Description Exemple
ID identifiant de la carte
enregistre
255
2.11.4 Cas derreur

Code Description
219
Identifiant de la carte bancaire non trouv
2.12 MoneyInWithCardId : Crdit de wallet avec carte bancaire pr-
enregistre
Version Description
1.1

2.12.1 Cinmatique
Avec la mthode MoneyInWithCardId , le systme peut envoyer une demande de
rechargement du wallet :


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 49/95


3. Lapplication MARQUE BLANCHE envoie Lemon Way lidentifiant du wallet crditer,
lidentifiant de la carte bancaire associe au wallet, le montant crditer, et un
commentaire
4. Lemon Way rpond
2.12.2 Requte
La requte MoneyInWithCardId doit avoir la structure suivante :
<MoneyInWithCardId xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<wallet>string</wallet>
<cardId>string</cardId>
<amountTot>string</amount>
<amountCom>string</amountCom>
<message>string</message>
<autoCommission>string</autoCommission>
</MoneyInWithCardId>

Element Description Requis Format Exemple
wallet Identifiant du wallet crbiter Oui [0 : 256] car 33612345678 ou
taxi67
cardId Identifiant de la carte bancaire
associe au wallet
Oui [0 : 256] car 243
amountTot Montant dbiter de la CB Oui 2 dcimales 15.00
amountCom Montant que la MARQUE
BLANCHE souhaite prlever
Non 2 dcimales 1.00
message Commentaire du paiement Non [0 :140] car Commande numro
245
autoCommis
sion
Indique si une commission doit
tre prleve directement sur
le montant total.
Si oui : [amount] sera prlev
sur la carte, et creditWallet
Oui [1] car 0 : non (par dfaut)
1 : oui


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 50/95


recevra [amount-la
commission automatique de
Lemon Way]
Sinon la valeur amountCom
sera utilise
2.12.3 Rponse
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<MLABEL>string</MLABEL>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
ID identifiant de la demande 255
MLABEL Numro de carte masqu
XXXX XXXX XXXX
9854
DATE Date de la demande
10/09/2011
18:09:27
SEN Vide dans ce cas
REC Wallet bnficiaire Pizza56
DEB 0.00 dans ce cas 0.00
CRED Montant crditer au wallet
(total moins la commission)
15.00
COM Commission prleve par la
MARQUE BLANCHE
2.00
MSG Commentaire Commande numro
245
STATUS Non utilis dans le kit
MARQUE BLANCHE

2.12.4 Cas derreur



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 51/95


Code Description
219
Identifiant de la carte bancaire non trouv
171
Autorisation refuse
2.13 MoneyInValidate : validation dun moneyIn
Version Description
1.1

2.13.1 Cinmatique
Cette mthode nest utile que lorsque le systme fonctionne en mode diffr.
Avec la mthode MoneyInValidate , le systme valide un moneyIn prcdemment autoris.
Pour plus dinformations, voir le chapitre sur le mode diffr .
2.13.2 Requte
La requte MoneyInValidate doit avoir la structure suivante :
<MoneyInValidate xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<transactionId>string</transactionId>
</MoneyInValidate>

Element Description Requis Format Exemple
transactionId Identifiant du MoneyIn
valider
Oui int 8393
2.13.3 Rponse
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 52/95


<CRED> string </CRED>
<COM> string </COM>
<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
ID identifiant de la demande 255
DATE Date de la demande initiale
10/09/2011
18:09:27
SEN Vide dans ce cas
REC Wallet bnficiaire Pizza56
DEB 0.00 dans ce cas 0.00
CRED Montant crditer au wallet
(total moins la commission)
15.00
COM Commission prleve par la
MARQUE BLANCHE
2.00
STATUS Non utilis dans le kit
MARQUE BLANCHE
3
2.13.4 Cas derreur

Code Description
143
Transaction invalide (inexistante ou un
statut ne permettant pas la validation)
2.14 SendPayment : Paiement entre wallets
Cette fonction de virement interne dit ON US permet le dbit dun Wallet Lemon Way du
dbiteur, et le crdit dun Wallet de destination des fonds. Les wallets peuvent tre attribus
des personnes physiques ou morales, et sont utiles dans les mtiers de prpay, de pot
commun, de listes, de paiement plusieurs, de collectes, etc.

Version Description
1.1

2.14.1 Cinmatique
Avec la mthode SendPayment , le systme peut envoyer un paiement dun wallet existant
vers un autre, existant ou non :


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 53/95


1. Lapplication de vente envoie Lemon Way lidentifiant du wallet dbiter, lidentifiant du
wallet crditer, le montant payer, et un commentaire
2. Lemon Way rpond
2.14.2 Requte
La requte SendPayment doit avoir la structure suivante :
< SendPayment xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<debitWallet>string</debitWallet>
<creditWallet>string</creditWallet>
<amount>string</amount>
<message>string</message>
</ SendPayment >

Element Description Requis Format Exemple
debitWallet Identifiant du wallet dbiter Oui [0 : 256] car 33612345678 ou
taxi67
creditWallet Identifiant du wallet crditer Oui [0 : 256] car 33612345678 ou
taxi67
amount Montant du paiement Oui 2 dcimales 15.00
message Commentaire du paiement Non [0 :140] car Commande numro
245
2.14.3 Rponse
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 54/95


<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
ID identifiant de la demande 255
DATE Date de la demande
10/09/2011 18:09:27
SEN Wallet dbiteur Pizza56
REC Wallet bnficiaire pizza
DEB Montant dbiter 15.00
CRED Montant crditer 15.00
COM Commission de la demande 0.00
MSG Commentaire de la demande Commande numro 245
STATUS Non utilis dans le kit
MARQUE BLANCHE

2.14.4 Cas derreur
Pas de cas derreur spcifique.
2.15 RegisterIBAN : Enregistrement dIBAN
Attention : le code BIC des IBAN change parfois au cours du temps pour une mme banque,
mme pour les grandes enseignes bancaires. Il est trs important de vrifier que votre ou vos
IBANs sont bien complets, incluant le code BIC. Les IBAN non jour sont systmatiquement
refuss par les systmes dchanges interbancaires STEP2 et CORE auquel nous les
soumettons chaque jour ouvr. Vos paiements sont retards. Vos clients particuliers ne sont
pas toujours au courant de lobsolescence de leur IBAN.
Une liste jour est disponible sur : http://www.swiftbic.com/fr/search/swift/
Exemple : Code BIC de Lemon Way : LEWAFR21

Version Description
1.1
Sortie : lidentifiant de lIBAN enregistr est ajout en sortie.
Il est possible denregistrer plusieurs IBAN par wallet.
2.15.1 Cinmatique
Avec la mthode RegisterIBAN , le systme peut envoyer une demande dassociation dun
IBAN un wallet.


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 55/95


Si la configuration du systme nautorise quun seul IBAN par wallet, le prcdent sera
dsactiv.
2.15.2 Requte
La requte RegisterIBAN doit avoir la structure suivante :
<RegisterIBAN xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<wallet>string</wallet>
<holder>string</holder>
<bic>string</bic>
<iban>string</iban>
<dom1>string</dom1>
<dom2>string</dom2>
</RegisterIBAN>

Element Description Requis Format Exemple
wallet Identifiant du wallet Oui [0 : 256] car 33612345678 ou
taxi67
holder Titulaire de lIBAN Oui [1 :100] car
Jean Dupont
bic Code BIC Oui [8,11] car CRLYFRPP
iban IBAN, de 27 caractres pour la
France
Oui [15 : 34] car FR583000202440000
0456575A61
dom1 1ere ligne de domiciliation (en
gnral, nom de lagence)
Oui [1 :26] car LCL MONTREUIL
dom2 2eme ligne de domiciliation (en
gnral, rue de lagence)
Oui [1 :26] car 56 rue de Lays
2.15.3 Rponse
2.15.3.1 Version 1.0
<IBAN>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 56/95


<S>String</S>
</IBAN>

Element Description Exemple
ID Identifiant du wallet inscrit avec succs 33612345678
2.15.3.2 A partir de Version 1.1
<IBAN>
<S>5</S>
<ID>11</ID>
</IBAN>

Element Description Exemple
ID Identifiant de lIBAN 253
S Statut de lIBAN 5
2.15.4 Cas derreur
Pas de cas derreur spcifique.
2.16 MoneyOut : Virement externe
Cette mthode permet de solder entirement ou partiellement un Wallet en faisant un virement
externe de Lemon Way (dun compte de paiement technique Lemon Way) vers un compte
bancaire, en prlevant les commissions du marchand (marque blanche) et de Lemon Way.
Les virements externes SEPA sur des comptes en monnaie non EUR (par exemple : virement
SEPA en GBP) donnent lieu des frais supplmentaires directement prlevs sur le Wallet par
Lemon Way, avant excution de lordre de virement.

Version Description
1.1
Entre : il est possible de renseigner un identifiant dIBAN en entre
1.$
Entre : la valeur autoCom permet maintenant la marque
blanche de dduire automatiquement une commission du virement,
cette commission tant gale celle due Lemon Way
2.16.1 Cinmatique
Avec la mthode MoneyOut , le systme peut envoyer une demande de virement bancaire
depuis un wallet, vers un IBAN associ au wallet.
2.16.2 Requte
La requte MoneyOut doit avoir la structure suivante :


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 57/95


2.16.2.1 Jusqu la version 1.2
< MoneyOut xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<wallet>string</wallet>
<amountTot>string</amountTot>
<amountCom>string</amountCom>
<message>string</message>
<ibanId>string</ibanId>
</MoneyOut>

Element Description Requis Format Exemple
wallet Identifiant du wallet dbiter Oui [0 : 256] car 33612345678 ou
taxi67
amountTot Montant total dbiter du wallet
(le client recevra sur son compte
bancaire amountTot moins la
commission)
Oui 2 dcimales 15.00
amountCo
m
Montant de la commission
prleve par la MARQUE
BLANCHE
Non 2 dcimales 3.00
message Commentaire du paiement Non [0 :140] car Commande numro
245
ibanId Identifiant de lIBAN crditer.
Si aucun identifiant nest
renseign, lopration
seffectuera sur le dernier IBAN
activ du wallet
Non [0 : 10] 253

2.16.2.1 A partir de la version 1.3
< MoneyOut xmlns=Service_mb>
<wlLogin>string</wlLogin>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 58/95


<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<wallet>string</wallet>
<amountTot>string</amountTot>
<amountCom>string</amountCom>
<message>string</message>
<ibanId>string</ibanId>
<autoCom>string</autoCom>
</MoneyOut>

Element Description Requis Format Exemple
wallet Identifiant du wallet dbiter Oui [0 : 256] car 33612345678 ou
taxi67
amountTot Montant total dbiter du wallet
(le client recevra sur son compte
bancaire amountTot moins la
commission)
Oui 2 dcimales 15.00
amountCo
m
Montant de la commission
prleve par la MARQUE
BLANCHE
Non 2 dcimales 3.00
message Commentaire du paiement Non [0 :140] car Commande numro
245
ibanId Identifiant de lIBAN crditer.
Si aucun identifiant nest
renseign, lopration
seffectuera sur le dernier IBAN
activ du wallet
Non [0 : 10] 253
autoCom Indique si Lemon Way doit
dduire automatiquement une
commission du virement, cette
commission tant gale celle
due Lemon Way. Cette
commission remplace alors le
paramtre amountCom qui sera
ignore.
Oui 0 ou 1 0 : ne pas dduire la
commission
automatiquement.

1 : dduire la
commission
automatiquement



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 59/95


2.16.3 Rponse
2.16.3.1 Version 1.0
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<MLABEL>string</MLABEL>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
ID identifiant de la demande 255
MLABEL IBAN sur lequel le virement
sera effectu
FR5830002012300000
116235A61
DATE Date de la demande
10/09/2011
18:09:27
SEN Wallet effectuant le virement Pizza56
REC Vide dans ce cas
DEB Montant dbiter du wallet 15.00
CRED 0 dans ce cas 3.00
COM Commission prleve par la
MARQUE BLANCHE
0.00
MSG Commentaire Commande numro
245
STATUS Non utilis dans le kit
MARQUE BLANCHE

2.16.3.2 A partir de la version 1.1
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<MLABEL>string</MLABEL>
<MID>string</MID>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 60/95


<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
ID identifiant de la demande 255
MLABEL IBAN sur lequel le virement
sera effectu
FR5830002012300000
116235A61
MID ID De lIBAN sur lequel le
virement sera effectu
5
DATE Date de la demande
10/09/2011
18:09:27
SEN Wallet effectuant le virement Pizza56
REC Vide dans ce cas
DEB Montant dbiter du wallet 15.00
CRED 0 dans ce cas 3.00
COM Commission prleve par la
MARQUE BLANCHE
0.00
MSG Commentaire Commande numro
245
STATUS Non utilis dans le kit
MARQUE BLANCHE

2.16.4 Cas derreur
Code Description
215
Aucun IBAN approuv trouv pour ce wallet
2.17 GetPaymentDetails : Rechercher un paiement
Version Description
1.1



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 61/95


2.17.1 Cinmatique
Avec la mthode GetPaymentDetails, la MARQUE BLANCHE peut vrifier le statut et les
dtails dun paiement ou dune demande effectus dans son systme :
2.17.2 Requte
La requte GetPaymentDetails doit avoir la structure suivante :
< GetPaymentDetails xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<transactionId>string</transactionId>
<transactionComment>string</transactionComment>
</ GetPaymentDetails>

Element Description Requis Format Exemple
transactionId Identifiant du paiement Non int 255

transactionC
omment
Commentaire associ au
paiement
Non [0 :140] car Commande numro
245

2.17.3 Rponse
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 62/95


<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
HPAY Correspond une transaction
ID identifiant de la demande ou du paiement 255
DATE Date de la demande ou du paiement
10/09/2011
18:09:27
SEN Wallet dbiteur 33612345678
REC Wallet bnficiaire pizza
DEB Montant dbiter 15.00
CRED Montant crditer 15.00
COM Commission 0.00
MSG Commentaire Commande numro
245
STATUS 2 : paiement expir (bnficiaire non inscrit dans le
dlai imparti)
3 : paiement termin
4 : erreur
7 : demande en attente de paiement
8 : demande en attente denregistrement du
destinataire
9 : demande expire
10 : remboursement dun paiement suite
expiration

3
2.17.4 Cas derreur

Code Description
143
Non trouv, fournir au moins un identifiant
ou un commentaire


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 63/95


2.18 GetMoneyInTransDetails : Rechercher un money-in
Version Description
1.1
Entre : un paramtre de recherche supplmentaire a t ajout :
transactionMerchantToken, qui correspond au wkToken utilis en
entre de MoneyInWebInit
1.2
Sortie : la donne STATUS possde une valeur possible
supplmentaire
1.$
Sortie supplmentaire : balise EXTRA contenant des informations
complmentaires sur la carte utilise
2.18.1 Cinmatique
Avec la mthode GetMoneyInTransDetails, la MARQUE BLANCHE peut vrifier le statut et
les dtails dun money-in effectu dans son systme :
2.18.2 Requte
2.18.2.1 Version 1.0
La requte GetMoneyInTransDetails doit avoir la structure suivante :
< GetMoneyInTransDetails xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<transactionId>string</transactionId>
<transactionComment>string</transactionComment>
</ GetMoneyInTransDetails >

Element Description Requis Format Exemple
transactionId Identifiant du money-in Non int 255

transactionC
omment
Commentaire associ au
money-in
Non [0 :140] car Commande numro
245


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 64/95


2.18.2.2 A partir de la version 1.1
La requte GetMoneyInTransDetails doit avoir la structure suivante :
< GetMoneyInTransDetails xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<transactionId>string</transactionId>
<transactionComment>string</transactionComment>
<transactionMerchantToken>string</transactionMerchantToken>
</ GetMoneyInTransDetails>

Element Description Requis Format Exemple
transactionId Identifiant du money-in Non int 255

transactionC
omment
Commentaire associ au
money-in
Non [0 :140] car Commande numro
245
transactionM
erchantToke
n
Token correspondant au
paramtre wkToken en entre
de la mthode MoneyInWebInit
(v 1.0)
Non [0 : 10] car 312232
2.18.3 Rponse
2.18.3.1 Jusqu la version 1.1
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 65/95



<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
HPAY Correspond un money-in
ID Identifiant du money-in 255
DATE Date du money-in
10/09/2011
18:09:27
SEN Vide dans ce cas
REC Wallet ayant effectu le money-in pizza
DEB 0 dans ce cas 0.00
CRED Montant crditer au wallet (total moins la
commission)
15.00
COM Commission prleve par la MARQUE BLANCHE 2.00
MSG Commentaire Commande numro
245
STATUS 3 : money-in effectu avec succs
4 : erreur (inclu les annulations)

3
2.18.3.2 A partir de la version 1.2
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 66/95



<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>
</TRANS>

Element Description Exemple
HPAY Correspond un money-in
ID Identifiant du money-in 255
DATE Date du money-in
10/09/2011
18:09:27
SEN Vide dans ce cas
REC Wallet ayant effectu le money-in pizza
DEB 0 dans ce cas 0.00
CRED Montant crditer au wallet (total moins la
commission)
15.00
COM Commission prleve par la MARQUE BLANCHE 2.00
MSG Commentaire Commande numro
245
STATUS 3 : money-in effectu avec succs
4 : erreur
0 : en attente de finalisation

3
2.18.3.1 A partir de la version 1.3
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
<EXTRA>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 67/95


<IS3DS>string</IS3DS>
<CTRY>string</CTRY>
</EXTRA>
</HPAY>

<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>
</TRANS>

Element Description Exemple
HPAY Correspond un money-in
ID Identifiant du money-in 255
DATE Date du money-in
10/09/2011
18:09:27
SEN Vide dans ce cas
REC Wallet ayant effectu le money-in pizza
DEB 0 dans ce cas 0.00
CRED Montant crditer au wallet (total moins la
commission)
15.00
COM Commission prleve par la MARQUE BLANCHE 2.00
MSG Commentaire Commande numro
245
STATUS 3 : money-in effectu avec succs
4 : erreur
0 : en attente de finalisation

3
EXTRA
Balise optionnelle contenant des informations carte
EXTRA.IS3DS
Indique si la transaction a t authentifie avec 3D
Secure :
-0 si non
-1 si oui
1
EXTRA.CTRY
Code pays du pays dmission de la carte FR


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 68/95


2.18.4 Cas derreur

Code Description
143
Non trouv, fournir au moins un identifiant
ou un commentaire
2.19 GetMoneyOutTransDetails : Rechercher un money-out
Version Description
1.1

2.19.1 Cinmatique
Avec la mthode GetMoneyOutTransDetails, la MARQUE BLANCHE peut vrifier le statut et
les dtails dun money-out effectu dans son systme :
2.19.2 Requte
La requte GetMoneyOutTransDetails doit avoir la structure suivante :
< GetMoneyOutTransDetails xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<transactionId>string</transactionId>
<transactionComment>string</transactionComment>
</ GetMoneyOutTransDetails>

Element Description Requis Format Exemple
transactionId Identifiant du money-out Non int 255

transactionC
omment
Commentaire associ au
money-out
Non [0 :140] car Commande numro
245



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 69/95


2.19.3 Rponse
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>

<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
HPAY Correspond un money-out
ID Identifiant du money-out 255
DATE Date du money-out
10/09/2011
18:09:27
SEN Wallet ayant effectu le money-out 33612345678
REC Vide dans ce cas
DEB Montant dbiter du wallet 15.00
CRED 0 dans ce cas 0.00
COM Commission prleve par la MARQUE BLANCHE 3.00
MSG Commentaire Commande numro
245
STATUS 3 : money-out effectu avec succs
4 : erreur
3


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 70/95


2.19.4 Cas derreur

Code Description
143
Non trouv, fournir au moins un identifiant
ou un commentaire
2.20 UploadFile : Upload dun justificatif
Les seuils rglementaires demandant le tlchargement de justificatifs (KYC : Know Your
Customer) sont indiqus dans votre contrat de service sign avec Lemon Way. Merci de les
respecter scrupuleusement. Lemon Way contrle priodiquement la transmission des
justificatifs.


Version Description
1.1

1.1
Rduction du nombre de type de documents (anciens types 3, 4 et 5
regroups dans le type 1), ajout du type kbis.
2.20.1 Cinmatique
Avec la mthode UploadFile , la MARQUE BLANCHE peut mettre sur le serveur les
justificatifs dun client.
Le fichier doit avoir une taille infrieure 4 Mo.
Les formats de documents autoriss sont : PDF, JPG, JPEG, BMP, GIF, TIF, TIFF et PNG.
2.20.2 Requte
La requte UploadFile doit avoir la structure suivante :
< UploadFile xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<wallet>string</wallet>
<fileName>string</fileName>
<type>string</type>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 71/95


<buffer>byte[]</buffer>
</UploadFile>

Element Description Requis Format Exemple
wallet Identifiant du wallet du Client Oui [0 : 256] 12345

fileName Nom du document

Oui String CIN_wallet1.png
type Type de document :
0: carte d'identit de la
Communaut Euro
1: justificatif de domicile
(fournisseurs d'nergie, tel
fixe, feuille d'imposition)
2: scan ou copie dun RIB
7 : Kbis
11 : document divers 1
12 : document divers 2
13 : document divers 3
Oui String 2
buffer Tableau de Byte reprsentant
le contenu du document
Oui Byte[]

2.20.3 Rponse
< ?xml version="1.0" encoding="utf-8"?>
<UPLOAD>
<ID>string</ID>
</UPLOAD>



Element Description Exemple
UPLOAD Correspond lupload
ID ID du document 521
2.20.4 Cas derreur
Code Description
235
Fichier trop grand ou de format incorrect


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 72/95



2.21 GetKycStatus: Recherche dutilisateurs, documents et IBAN
modifi depuis une date
Version Description
1.1

1.1
Ajout de la date de dernire modification de chaque document et RIB
1.2
Ajout du status 1 pour les documents, dans le retour.
2.21.1 Cinmatique
Avec la mthode GetKycStatus , la MARQUE BLANCHE peut rechercher tous les
utilisateurs, les documents et les IBAN dont le statut a chang depuis une date donne.
2.21.2 Requte
La requte GetKycStatus doit avoir la structure suivante :
<GetKycStatus xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<updateDate>string</updateDate>
</GetKycStatus >


Element Description Requis Format Exemple
updateDate Date en secondes UTC Oui String 1373448225

2.21.3 Rponse
2.21.3.1 Version 1.0

< ?xml version="1.0" encoding="utf-8"?>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 73/95


<WALLETS>
<WALLET>
<ID>walletId</ID>
<S>walletStatus</S>
<DATE>lastUpdateDate UTC seconds</DATE>
<DOCS>
<DOC>
<ID>docId</ID>
<S>documentStatus</S>
</DOC>
...
<DOC>
<ID> docId </ID>
<S>documentStatus</S>
</DOC>
</DOCS>
<IBANS>
<IBAN>
<ID>ibanId</ID>
<S>status</S>
</IBAN>
</IBANS>
</WALLET>
...
<WALLET>
</WALLET>
</WALLETS>


Element Description Exemple
WALLETS Liste de wallets
WALLET Correspond un wallet
ID ID du wallet 521
S Statut du Wallet :
1 : non enregistr
5 : enregistr (statut donn aprs cration)
6 : documents envoys
11 : bloqu
12 : ferm
1
DATE Date de modification du statut du Wallet en
secondes UTC
1373448289
DOCS Liste des documents dont le statut a chang
depuis la date mis en entre

DOC Correspond un document
ID ID du document 20
S Statut du document :
2: Document vrifi et accept
2


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 74/95


3: Document vrifi mais non accept
4: Document remplac par un autre document
5: Document expir
IBANS Liste des IBAN dont le statut a chang depuis la
date mis en entre

IBAN Correspond un IBAN
ID ID de liban 98
S Statut de liban :
0 : pas diban li au wallet
5 : utilisable
6 : utilisable, vrifi par Lemon Way
8 : dsactiv
9 : rejet

2
2.21.3.1 A partir de la version 1.1
< ?xml version="1.0" encoding="utf-8"?>
<WALLETS>
<WALLET>
<ID>walletId</ID>
<S>walletStatus</S>
<DATE>lastUpdateDate UTC seconds</DATE>
<DOCS>
<DOC>
<ID>docId</ID>
<S>documentStatus</S>
<D>documentDateChange</D>
</DOC>
...
<DOC>
<ID> docId </ID>
<S>documentStatus</S>
<D>documentDateChange</D>

</DOC>
</DOCS>
<IBANS>
<IBAN>
<ID>ibanId</ID>
<S>status</S>
<D>ibanDateChange</D>

</IBAN>
</IBANS>
</WALLET>
...
<WALLET>
</WALLET>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 75/95


</WALLETS>


Element Description Exemple
WALLETS Liste de wallets
WALLET Correspond un wallet
ID ID du wallet 521
S Statut du Wallet :
1 : non enregistr
5 : enregistr (statut donn aprs cration)
6 : documents envoys
11 : bloqu
12 : ferm
1
DATE Date de modification du statut du Wallet en
secondes UTC
1373448289
DOCS Liste des documents dont le statut a chang
depuis la date mis en entre

DOC Correspond un document
ID ID du document 20
S Statut du document :
1: Document uniquement reu
2: Document vrifi et accept
3: Document vrifi mais non accept
4: Document remplac par un autre document
5: Validit du document expir
2
D Date de changement de statut du document
IBANS Liste des IBAN dont le statut a chang depuis la
date mis en entre

IBAN Correspond un IBAN
ID ID de liban 98
S Statut de liban :
0 : pas diban li au wallet
5 : utilisable
6 : utilisable, vrifi par Lemon Way
8 : dsactiv
9 : rejet
2
D Date de changement de statut de lIBAN



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 76/95


2.21.4 Cas derreur
Code Description
234
Format dun paramtre en entre incorrect
2.22 GetMoneyInIBANDetails: Recherche de moneyIn par virement
depuis une date
Version Description
1.1

2.22.1 Cinmatique
Avec la mthode GetMoneyInIBANStatus, la MARQUE BLANCHE peut rcuprer la liste de
tous les moneyIn par virement reus par Lemon Way, depuis une date donne.
2.22.2 Requte
La requte GetMoneyInIBANDetails doit avoir la structure suivante :
< GetMoneyInIBANDetails xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<updateDate>string</updateDate>
</ GetMoneyInIBANDetails>


Element Description Requis Format Exemple
updateDate Date en secondes UTC Oui String 1373448225

2.22.3 Rponse
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 77/95


<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>

<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
HPAY Correspond un money-in
ID Identifiant du money-in 255
DATE Date du money-in
10/09/2011
18:09:27
SEN Vide dans ce cas
REC Wallet ayant effectu le money-in pizza
DEB 0 dans ce cas 0.00
CRED Montant crdit au wallet (total moins la
commission)
15.00
COM Commission prleve par la MARQUE BLANCHE.
Toujours 0 dans le cas des moneyIn par virement.
0.00
MSG Commentaire Commande numro
245
STATUS 3 : money-in effectu avec succs
4 : erreur

3




Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 78/95


2.22.4 Cas derreur
Code Description
234
Format dun paramtre en entre incorrect

2.23 RefundMoneyIn : remboursement carte
Note importante : cette fonctionnalit nest pas disponible entre 22h et 3h, heures de Paris.

Version Description
1.1

1.1
Ajout dune entre pour indiquer le montant pour effectuer un
remboursement partiel
1.2
Modification de la rponse pour que les donnes correspondent au
remboursement effectu et non lopration initiale
2.23.1 Cinmatique
Avec la mthode RefundMoneyIn , le systme peut envoyer une demande de
remboursement dune acquisition carte. Les rgles suivantes sont appliques :
- Le remboursement seffectuera sur la carte ayant servi lacquisition initiale.
- La commission prleve par Lemon Way lacquisition ne sera pas rembourse la
MARQUE BLANCHE
- Si aucun montant nest prcis, le remboursement se fait sur le montant total de
lacquisition initiale.
- Le WALLET du CLIENT sur lequel a eu lieu le moneyIn initial sera dbit du montant
rembourser. Si le solde du WALLET CLIENT est insuffisant, un paiement automatique
sera effectu au pralable, du WALLET de la MARQUE BLANCHE vers le WALLET
CLIENT.
- Avec le remboursement partiel de la version 1.1, il est possible de cumuler les
remboursements en plusieurs fois, jusqu ce que le montant de lacquisition initiale soit
atteint.
2.23.2 Requte
2.23.2.1 Version 1.0
La requte RefundMoneyIn doit avoir la structure suivante :
< RefundMoneyIn xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 79/95


<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<transactionId>string</ transactionId >
<comment>string</comment>
</ RefundMoneyIn >

Element Description Requis Format Exemple
transactionId Identifiant du moneyIn
rembourser
Oui [0 : 10] car 176
comment Commentaire sur le
remboursement
Non [0 :140] car Commande numro
245
2.23.2.1 A partir de version 1.1
La requte RefundMoneyIn doit avoir la structure suivante :
<RefundMoneyIn xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<transactionId>string</ transactionId >
<amountToRefund>string</amountToRefund>
<comment>string</comment>
</RefundMoneyIn>

Element Description Requis Format Exemple
transactionId Identifiant du moneyIn
rembourser
Oui [0 : 10] car 176
comment Commentaire sur le
remboursement
Non [0 :140] car Commande numro
245
amountToRef Montant rembourser. Si vide, Non 2 dcimales 15.00


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 80/95


und le montant total sera rembours
2.23.3 Rponse
2.23.3.1 Jusqu la version 1.1
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
ID Identifiant de lopration de
remboursement
255
DATE Date du money-in annul
10/09/2011
18:09:27
SEN Vide dans ce cas
REC Wallet crdit lors de
lopration initiale
Pizza56
DEB 0 dans ce cas 0.00
CRED Montant crdit au wallet lors
de lopration initiale
15.00
COM Commission prleve par la
MARQUE BLANCHE.
0 dans ce cas.
0.00
STATUS Non utilis dans le kit
MARQUE BLANCHE

2.23.3.1 A partir de la version 1.2
< ?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 81/95


<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<STATUS> string</STATUS>
</HPAY>
</TRANS>


Element Description Exemple
ID Identifiant de la transaction de
remboursement
255
DATE Date de la transaction de
remboursement
10/09/2011
18:09:27
SEN Wallet dbit Pizza56
REC Vide dans ce cas
DEB Montant rembours 15.00
CRED 0 dans ce cas 0.00
COM Commission prleve par la
MARQUE BLANCHE.
0 dans ce cas.
0.00
STATUS Non utilis dans le kit
MARQUE BLANCHE

2.23.4 Cas derreur
Code Description
138
Fonctionnalit indisponible (votre contrat ne vous permet pas de rembourser ou vous
avez envoy la requte durant les heures dindisponibilit de la fonctionnalit)
143
Transaction invalide (inexistante ou un statut ne permettant pas la validation)
151
Montant non autoris (suprieur au montant total remboursable ou infrieur 0.50)
2.24 GetBalances : Rcuprations de lensemble des soldes
Version Description
1.1

2.24.1 Cinmatique
Avec la mthode GetBalances , la MARQUE BLANCHE peut rcuprer lensemble des
wallets dont le solde a chang depuis la date saisie en paramtre.


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 82/95


2.24.2 Requte
La requte GetBalances doit avoir la structure suivante :
< GetBalances xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<wlPDV>string</wlPDV>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<updateDate>string</updateDate>
</ GetBalances>


Element Description Requis Format Exemple
updateDate Date en secondes UTC Oui String 1373448225




2.24.3 Rponse
< ?xml version="1.0" encoding="utf-8"?>
<WALLETS>
<WALLET>
<ID>string</ID>
<BAL> string </BAL>
</WALLET>

<WALLET>
<ID>string</ID>
<BAL> string </BAL>
</WALLET>

</WALLETS>


Element Description Exemple
ID Identifiant du wallet 255


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 83/95


BAL Solde du wallet
25.89
2.24.4 Cas derreur
Code Description
234
Format dun paramtre en entre incorrect

2.25 MoneyIn3DAuthenticate: Savoir si lutilisateur fait
lauthentification 3D Secure
Version Description
1.1

2.25.1 Cinmatique
Cette mthode permet au marchand de savoir pour une transaction donne si lutilisateur fait
lauthentification 3D Secure.
Il nest pas possible de cumuler cette mthode avec MoneyIn3DConfirm : soit vous souhaitez
uniquement vrifier si votre client sest correctement authentifi (utilisez
MoneyIn3DAuthenticate), soit vous souhaitez confirmer le paiement en 3DS (utilisez
MoneyIn3DConfirm).
2.25.2 Requte
La requte MoneyIn3DAuthenticate doit avoir la structure suivante :
< MoneyIn3DAuthenticate xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<transactionId>string</transactionId>
<MD>string</MD>
<PaRes>string</PaRes>
<cardType>string</cardType>
<cardNumber>string</cardNumber>
<cardCode>string</cardCode>


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 84/95


<cardDate>string</cardDate>
</ MoneyIn3DAuthenticate >

Element Description Requis Format Exemple
transactionId Identifiant de la transaction
finaliser
Oui int 255
MD Donne MD retourne par le
site dauthentification
3DSecure
Oui si
contrat
Payline
String 1Ok9dCP55UUkWfdJ
wEid
PaRes Donne Pares retourne par le
site dauthentification
3DSecure
Oui si
contrat
Payline
string
eJxVkdtSwjAQhl+lwwM0SY+
EWTKDgsKMICIgXGbaVaq0h
bS18PYmpYheZb89ZfdfWO4
U4vAVo0qhgCkWhfxAK4n7n
YDz0HNZR8B8sMCjgG9URZ
JngtnUdoBcURepaCezUoCMj
neTmfB4GAYhkBYhRTUZCh
ZQ1nV9j/k05JQDubghkymKp
9H0eWa9DbZAGoYor7JSnY
XjUyBXgErtxa4sDz1C6rq295j
mWS3P9rsCYmJAbsPMK2M
VutcpicV0dUpevkq1TuNKpg+
bxef6ETez9XK87QMxGRDLE
oVDmUu541sO7bFuz/GANH
6QqRlCjFYLi1Gb6qlaDxzMR4
MLMGoifz2glVWYRWfBw65e
5UqAp0Oeoc7QWv7aEGMR6
TXa57bD/djIG5VaMc/jfhgERt
+GTadEq8M8RptWBoCYCtK
ejrSH1da/g/8A8pmnfg==
cardType Type de carte bancaire Oui si
contrat
Payline
[1] car 0 : CB
1 : Visa
2 : Mastercard
cardNumber Numro 16 chiffres Oui si
contrat
Payline
[16] car 4972000011112222
cardCode Cryptogramme de la carte 3
chiffres
Oui si
contrat
Payline
[3] car 123
cardDate Date dexpiration de la carte Oui si
contrat
Payline
MM/yyyy 12/2013
2.25.3 Rponse
< ?xml version="1.0" encoding="utf-8"?>
<MONEYIN>
<O3D_CODE>string</O3D_CODE>
</MONEYIN>




Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 85/95


Element Description Exemple
O3D_CODE Code de retour dAtos :
-00 : Porteur authentifi
-55 : Porteur non authentifi
-62 : By-pass du porteur sur l'ACS
00
2.25.4 Cas derreur
Pas de cas derreur spcifique.
2.26 CreateGiftCodeAmazon: Cration dun Chque-Cadeau Amazon.fr
Cette fonction permet le dbit dun Wallet Lemon Way, afin de crer un Chque-Cadeau
Amazon.fr. Ce chque Cadeau-Amazon.fr cotera lutilisateur 4% de moins que le montant du
chque cadeau.

Version Description
1.1

2.26.1 Cinmatique
Avec la mthode CreateGiftCodeAmazon , lutilisateur entre le montant du Chque-Cadeau
Amazon.fr sera dbit de 4% de moins que le montant du chque cadeau
2.26.2 Requte
La requte CreateGiftCodeAmazon doit avoir la structure suivante :
< CreateGiftCodeAmazon xmlns=Service_mb>
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<debitWallet>string</debitWallet>
<amountAGCOD>string</amountAGCOD>
</CreateGiftCodeAmazon>

Element Description Requis Format Exemple
debitWallet Identifiant du wallet dbiter Oui [0 : 256] car 33612345678 ou
taxi67


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 86/95


amountAGCOD Montant du chque Cadeau Oui 2 dcimales 10.00
2.26.3 Rponse
< ?xml version="1.0" encoding="utf-8"?>
<CreateGiftCodeAmazonConfirm>
<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<AGC> string</AGC>
</HPAY>
</CreateGiftCodeAmazonConfirm>


Element Description Exemple
ID identifiant de la demande 255
DATE Date de la demande
10/09/2011 18:09:27
SEN Wallet dbiteur Pizza56
REC Wallet bnficiaire pizza
DEB Montant dbit du wallet
(montant du chque-cadeau
moins 4%)
9.60
CRED Non utilis 9.60
COM Commission de la demande 0.00
AGC Code du Chque-Cadeau
Amazon.fr
XXXX-XXXXX-XXXX
STATUS Non utilis dans le kit
MARQUE BLANCHE

2.26.4 Cas derreur
Pas de cas derreur spcifique.



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 87/95


3. WEBKIT :
Les fonctionnalits suivantes sont disponibles par WEBKIT :
- La finalisation dun rechargement de wallet par carte bancaire 3D-Secure, initialis au
pralable par DIRECTKIT.
3.1 Gnralits
3.1.1 Requtes
Les donnes sont encodes en UTF-8.
Selon la mthode, les requtes se font en POST ou en GET.
3.1.2 Rponses
Toutes les rponses de Lemon Way se font sous la forme dun POST sur lURL de retour,
dannulation ou derreur, avec les informations suivantes :

Element Description Requis Format Exemple
response_code Code de rponse Oui [4] car 0000 : opration russie
response_wkToken Identifiant unique
de lappel,
prcdemment
envoy par le site
de la MARQUE
BLANCHE
Oui [1 : 20] car 5652772
response_msg Message de retour Oui [0 : max] car Paiement confirm
response_transacti
onId
Identifiant de la
transaction
Non si
erreur
[1 : 10] car 255
response_transacti
onAmount
Montant de la
transaction
Non si
erreur
[1 : 10] car 15.00
reponse_transactio
nMessage
Commentaire li
la transaction
Non si
erreur
[0 : 140] car Commande numro 4552

3.1.3 Erreurs
3.1.3.1 Cas derreur standard :
Les codes derreur suivants sont susceptibles dtre retournes au site de la MARQUE
BLANCHE :



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 88/95


response_code Description
2111
Commande non reconnue
2112
Opration annule par
lutilisateur
211$
Echec dauthentification sur
le webkit
2113
Requte mal forme
$111
Erreur provenant du serveur
3111
Erreur inconnue
3.2 MoneyInWebFull : Rechargement de wallet par carte bancaire
Cette fonctionnalit nest plus maintenue.
3.3 MoneyInWebFinalize : Finalisation du crdit de wallet en mode
indirect
Cette fonctionnalit permet de finaliser une recharge de wallet par carte bancaire, la recharge
ayant t initialise par la fonction moneyInWebInit du webservice en DIRECTKIT. Le 3D-
Secure est utilis si la banque du porteur de la carte le permet.
La page de paiement est personnalisable, voir Annexe 4.1.
3.3.1 Cinmatique
Pr-requis : la MARQUE BLANCHE a initialis un rechargement via la mthode
moneyInWebInit du DIRECTKIT. La MARQUE BALNCHE est alors en possession dun token de
money-in.
1. Le site de la MARQUE BLANCHE redirige lutilisateur vers le WEBKIT de Lemon Way,
avec en paramtre GET le token de money-in.
2. Le webkit effectue des vrifications puis redirige lutilisateur sur la page dacquisition CB.
3. Sur la page de saisie de donnes carte :
Si un contrat Payline est utilis :
o Si la MARQUE BLANCHE a demand lutilisation de CB enregistre,
Payline propose lutilisateur dutiliser une CB enregistre, sil en
possde une.
o Si la MARQUE BLANCHE na pas demand lutilisation de CB
enregistre ou si lutilisateur nen a pas encore enregistr, lutilisateur
saisit ses donnes CB, et procde une vrification 3D Secure si sa
banque le permet.
Si un contrat Atos est utilis : lutilisateur saisit ses donnes CB, et procde
une vrification 3D Secure si sa banque le permet.



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 89/95


4. La transaction de money-in est enregistre et lutilisateur est redirig vers le site de la
MARQUE BLANCHE.
3.3.2 Requte
La requte est envoye au WEBKIT de Lemon Way, avec en paramtre GET les informations
suivantes :

Variable Description Requis Format Exemple
moneyInToken Token de money-in
reu par la MARQUE
BLANCHE en sortie
de moneyInWebInit
du DIRECTKIT
Oui [1:256] car 33687654321
p URL du CSS de
personnalisation de la
page de paiement.
Ne fonctionne que
pour les contrats avec
Atos.
Non https%3A%2F%2Fwww.
lemonway.fr%2Fmercan
et_lw.css
lang Langue des pages de
paiement
Ne fonctionne que
pour les contrats avec
Atos.
Non Langues
disponibles :
anglais : en
norvgien: no
japonais: jp
coren: ko
espagnol: sp
francais: fr
tchque: xz
allemand: ge
italien: it
breton: br
danois: da
finnois: fi:
sudois: sw:
portugais: po
flamand: fl
chinois: ci
polonais: pl
en


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 90/95


nerlandais:
ne

3.3.2.1 Exemples
<?php
/*
$wkURL : URL du WEBKIT de LEMON WAY
$moneyInToken : Token rcupr via le DIRECTKIT
$p : URL du CSS de personnalisation, URL encoded
$lang : Langue utiliser pour laffichage de la page
*/
header('Location: '.$wkURL.'?moneyInToken='.$moneyInToken.'&p='.$p.'&lang='.$lang);
?>
3.3.3 Retour
LURL de retour de la MARQUE BLANCHE reoit 2 retours diffrents :
- Lorsque le CLIENT termine son paiement ou lorsque le paiement est abandonn, un
POST est envoy sur lURL de la MARQUE BLANCHE
- Lorsque le CLIENT termine son opration, il est redirig vers lURL de la MARQUE
BLANCHE avec des donnes en paramtres GET
Pour des raisons de scurit, quel que soit le code de rponse retourn par le POST, il convient
la MARQUE BLANCHE dappeler la mthode GetMoneyInTransDetails du DIRECTKIT afin de
sassurer du rsultat du paiement.

POST de rponse :
Element Description Exemple
response_code Code de rponse :
-0000 : succs
-3000 : erreur
0000
response_wkTok
en
wkToken envoy par la
MARQUE BLANCHE en
entre de linitialisation du
moneyIn
rhjzekdzejkd
response_msg Commentaire sur le code de
retour

response_transa
ctionId
Rfrence Lemon Way de la
transaction
755
response_transa
ctionAmount
Montant de la transaction 34.00
response_transa
ctionMessage
Commentaire de la transaction pizza


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 91/95


GET de rponse :
Element Description Exemple
response_wkTok
en
wkToken envoy par la
MARQUE BLANCHE en
entre de linitialisation du
moneyIn
rhjzekdzejkd




Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 92/95


4. ANNEXE
4.1 Personnalisation de page de paiement
4.1.1 Cas Payline




4.1.2 Cas Atos
Le paiement par Atos comprend 2 pages :
1 : le formulaire de slection du mode de paiement (type de carte)
2 : le formulaire de saisie des donnes carte



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 93/95


Les lments personnalisables sont :
- La langue daffichage des pages de paiement : passer la langue en paramtre, comme
indiqu en chapitre 3.3.2
- Le formulaire de slection du type de carte : il peut tre intgr au site de la MARQUE
BLANCHE, pour cela, au lieu de rediriger votre CLIENT aprs MoneyInWebInit,
rcuprez le formulaire sur votre serveur, et intgrez-le votre page
- Le formulaire de saisie des donnes carte : vous pouvez nous envoyer le CSS que vous
souhaitez ajouter cette page en envoyant lURL du CSS en paramtre, comme indiqu
en chapitre 3.3.2 . Attention, en production, il conviendra dutiliser une URL en HTTPS.
Si vous nen avez pas, nous pourrons hberger votre CSS.
4.1.3 Exemple de page de paiement
4.1.3.1 Payline



Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 94/95


4.1.3.2 Atos

4.2 Informations concernant le paiement 3D Secure
Plus dinformations sur : http://www.banque-france.fr/observatoire/telechar/faq-20121207-
observatoire-commercants-paiemnts-carte.pdf

Extrait :

Rseaux MasterCard et Visa : Pour ce qui est des oprations ralises avec des cartes ne
prsentant par le logo CB, les rglementations des rseaux internationaux MasterCard et Visa
sappliquent et des particularits sur le non transfert de responsabilit peuvent tre
identifies, mme si le processus de paiement 3D-Secure a abouti avec succs. Ainsi, par
exemple, le transfert de responsabilit peut ne pas sappliquer pour toutes les cartes
corporate , business ou purchasing mises hors Europe, lorsque la rgion dmission
de la carte et la rgion dacquisition du paiement sont diffrentes. Pour de plus amples
informations concernant les limites du transfert de responsabilit, vous pouvez vous
rapprocher de votre banque acqureur.

Les eCartes bleues ne permettent pas non-plus de paiement 3D Secure avec authentification
de la banque.
Enfin, le paiement 3D Secure vous protge contre la fraude (vol ou utilisation de numros de
cartes bancaires vols sur internet, mais pas dun litige commercial.

Nous encourageons tous nos clients utiliser le paiement 3D Secure, qui fait baisser le
taux de fraude et de ChargeBack, et qui est de mieux en mieux compris des franais.


Lemon Way SAS - Kit Marque Blanche - Guide dintgration page 95/95



4.2.1 Exemple despace 3D Secure dune banque :