RegisterWallet : Création de wallet

Version

Description

1.1

Sortie : ajout de l'identifiant unique du wallet, généré par Lemonway

1.2Sortie : limites pour ce wallet

Cinématique

Avec la méthode « RegisterWallet », le système MARQUE BLANCHE demande à Lemonway la création d'un wallet.

  1. L'utilisateur saisit ses données
  2. L'application appelle le webservice de Lemonway
  3. Lemonway enregistre les données et crée le compte de paiement
  4. L'application traite la réponse de Lemonway et affiche un message de confirmation

Requête


XML

<RegisterWallet xmlns="Service_mb">
  <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>
  <street>string</street>
  <postCode>string</postCode>
  <city>string</city>
  <ctry>string</ctry>
  <birthdate>string</birthdate>
  <phoneNumber>string</phoneNumber>
  <mobileNumber>string</mobileNumber>
  <isCompany>string</isCompany>
  <companyName>string</companyName>
  <companyWebsite>string</companyWebsite>
  <companyDescription>string</companyDescription>
  <companyIdentificationNumber>string</companyIdentificationNumber>
  <isDebtor>string</isDebtor>
  <nationality>string</nationality>
  <birthcity>string</birthcity>
  <birthcountry>string</birthcountry>
  <payerOrBeneficiary>string</payerOrBeneficiary>
  <isOneTimeCustomer>string</isOneTimeCustomer>
  <isTechWallet>string</isTechWallet>
</RegisterWallet>

JSON

{   
    "wlLogin":"string",
    "wlPass":"string",
    "language":"string",
    "version":"string",
    "walletIp":"string",
    "walletUa":"string",
    "wallet":"string",
    "clientMail":"string",
    "clientTitle":"string",
    "clientFirstName":"string",
    "clientLastName":"string",
    "street":"string",
    "postCode":"string",
    "city":"string",
    "ctry":"string",
    "birthdate":"string",
    "phoneNumber":"string",
    "mobileNumber":"string",
    "isCompany":"string",
    "companyName":"string",
    "companyWebsite":"string",
    "companyDescription":"string",
    "companyIdentificationNumber":"string",
    "isDebtor":"string",
    "nationality":"string",
    "birthcity":"string",
    "birthcountry":"string",
    "payerOrBeneficiary":"string",
    "isOneTimeCustomer":"string",
    "isTechWallet":"string"
}

Element

Description

Requis

Format

Exemple

wallet

Identifiant que vous choisissez pour identifier le wallet dans le système.


NOTE : Si vous prévoyez d'alimenter des wallets par virement ou chèque, veuillez choisir des identifiants de wallet alphanumérique (20 car max) car ils devront être écrits par vos utilisateurs dans les libellés de virement ou le dos du chèque. Un libellé de plus de 20 caracteres risque d'etre coupé par le systeme bancaire.

Oui

[1 :100] car

^[A-Z0-9._@%+-]{1,100}$

33612345678

clientMail

Adresse email du CLIENT. Doit être unique dans l'environnement de la MARQUE BLANCHE

Oui

[6 :256] car

adresse@domaine.com

clientTitle

Civilité du CLIENT

Non

[1] car

"M" : M.
"F" : Mme
"J" : Compte joint
"U" : Inconnu (défaut)

clientFirstName

Prénom du CLIENT

Oui

[2 :256] car

Pierre

clientLastName

Nom du CLIENT

Oui

[2 :256] car

Dupont

street

Numéro et rue de l'adresse du CLIENT

Non

[0 :256] car

26 rue de Paris

postCode

Code postal du CLIENT

Non

[0 :10] car

93100

city

Ville du CLIENT

Non

[0 :140] car

Montreuil

ctry

Pays du CLIENT, au format ISO-3

Oui

[3] car

FRA

phoneNumber

Numéro de téléphone de contact, en format MSISDN : numéro international avec code pays, sans le « + » ni « 00 »

Non

[6 :30] car

33672635263

mobileNumber

Numéro de téléphone mobile de contact, en format MSISDN : numéro international avec code pays, sans le « + » ni « 00 ».
C'est vers ce numéro que sera envoyé un code par SMS pour signer électroniquement un mandat de prélèvement.

Non

[6 :30] car

33672635263

birthdate

Date de naissance du CLIENT

Oui

dd/MM/yyyy

21/03/1985

isCompany

Indique si le compte de paiement est créé pour une personne morale
1 : Personne morale (Société, association...)
0 ou vide : Personne physique

Oui

[1] car

1

companyName

Raison sociale de l'entreprise / l'association… (au moins une lettre est requise)

Obligatoire si isCompany = 1.

Oui/Non

[1 :256] car

Lemonway SAS

companyWebsite

URL du site web

Obligatoire si isCompany = 1.

Oui/Non

[1 :256] char

www.lemonway.com

companyDescription

Description de l'activité

Obligatoire si isCompany = 1.

Oui/Non

[1 :256] char

Ecommerce, vêtements

companyIdentificationNumber

Numéro d'identification de la personne morale (SIREN, RNA, immatriculation RCS/RN)

Non

[1 :256] char

123567ABCDEF

isDebtor

Dans une plateforme de crowdfunding/prêt, indique si le wallet est créé pour un emprunteur
1 : oui
0 ou vide : non

Non

[1] car

1

nationality

Nationalité du CLIENT, au format ISO-3
Pour les nationalités multiples, veuillez séparer les nationalités par une virgule

Oui

[0 :19] char

FRA

birthcity

Ville de naissance du CLIENT

Non

[0 :140] car

Montreuil

birthcountry

Pays de naissance du CLIENT, au format ISO-3

Non

[3] car

FRA

payerOrBeneficiary

Indique si le wallet est créé pour un payeur ou un bénéficiaire :
Vide : statut inconnu (par défaut)
1 : payeur
2 : bénéficiaire

Oui

[1] car

1

isOneTimeCustomer

Indique s'il s'agit d'un client occasionnel. Si oui, le statut 14 lui sera attribué, et il n'aura droit qu'à un unique paiement dont le montant maximum sera défini avec Lemonway.
0 : non (par défaut)
1 : oui

Non

[1] car

1

isTechWallet

Cette option peut être disponible ou non selon la nature du contrat. Veuillez vous renseigner auprès du support avant de l'utiliser.

Indique s'il s'agit d'un wallet technique. Si oui, le statut 16 lui sera attribué.

0 ou vide : non (par défaut)
1 : oui, dans le cas ou cette option est activé dans votre contrat. Sinon, il sera considéré comme un wallet client.

Non[1] car1

Réponse


XML

<?xml version="1.0" encoding="utf-8"?>
<WALLET>
	<ID>string</ID>
	<LWID>string</LWID> <!-- à partir de la version 1.1-->
	<LIMITS> <!-- à partir de la version 1.2-->
		<TOTALMONEYINALLOWED>int</TOTALMONEYINALLOWED>
		<AMOUNTMONEYINALLOWED>decimal</AMOUNTMONEYINALLOWED>
	</LIMITS>
 </WALLET>
  

JSON

{  
    "WALLET":{  
        "ID":"string",
        "LWID":"string",
		"LIMITS": {
			"TOTALMONEYINALLOWED":"string",
			"AMOUNTMONEYINALLOWED":"string"
		}
    }
}

Version

Element

Description

Exemple

>= 1.0

ID

Identifiant du wallet inscrit avec succès (correspond à ce que vous nous avez envoyé en entrée)

33612345678

>= 1.1

LWID

Identifiant interne attribué par LEMONWAY (identifiant affiché dans le BACKOFFICE)

2343

>= 1.2

LIMITS

Client occasionnel uniquement

Indique les limites du wallet


>= 1.2
TOTALMONEYINALLOWED

Client occasionnel uniquement

Nombre total de money in autorisé pour ce wallet

 3
>= 1.2
AMOUNTMONEYINALLOWED

Client occasionnel uniquement

Montant total de money in autorisé pour ce wallet

 1000,00