RegisterWallet: creating a new wallet

Version

Description

1.1

Output: unique Lemon Way wallet ID, generated by Lemon Way

1.2Output: limits for this wallet

How it works

By calling this method, the WHITE BRAND asks Lemon Way to create a wallet.

  1. Users enters its data on your web site, for example on his 'profile' area on your web site
  2. Your serveur calls our RegisterWallet API
  3. Lemon Way creates the wallet in your environment
  4. Your system reads the answer of this method and informs the user

Request

<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>

  
    "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"

}


Item

Description

Mandatory

Format

Example

wallet

Wallet ID that you use to identify the customer. Choose your unique number.


NOTE : If you plan to credit wallets by fund transfer, please use short alphanumeric wallet identifiers (max 20 char.). Your customers will have to write their wallet identifier in the transfer label/comment, a label of more that 20 characters could be cut when passing the the banking system.

Yes

[1 :100] char

33612345678

clientMail

Unique Email.

The Email must be unique in YOUR environment. If the Emails alreay exists, please use the previously created Wallet. Do not create 2 different wallets for the same user, for compliance reason, security, and fraud management. Use the real Email of the end customer, not a generic Email, nor a fake Email.

Yes

[6 :256] char

adresse@domaine.com

clientTitle

CLIENT title

No

[1] char

"M": Mr.
"F": Miss
"J": joint account
"U": Unknown(default)

clientFirstName

CLIENT first name

Yes

[2 :256] char

Pierre

clientLastName

CLIENT last name

Yes

[2 :256] char

Dupont

street

CLIENT number and street

No

[0 :256] car

26 rue de Paris

postCode

CLIENT post code/ZIP

No

[0 :10] car

93100

city

CLIENT city

No

[0 :140] car

Montreuil

ctry

CLIENT country using ISO-3

Yes

[3] char

FRA

phoneNumber

Phone number with MSISDN format: international number with country code without "00" neither "+".

No

[6 :30] char

33672635263

No "00"
No "+" thanks

mobileNumber

Mobile phone number with MSISDN format: international number with country code without "00" neither "+".
This will be used by default when electronically signing documents

No

[6 :30] char

33672635263

No "00"
No "+" thanks

birthdate

CLIENT birthdate

Yes

dd/MM/yyyy

21/03/1985

isCompany

Indicates if the wallet is created for a company

1: Legal entity (Company, association...)
0 or empty: Individual person

Yes

[1] char

1

companyName

Name of the company (at least one alphabethic character is required)

If isCompany = 1 then this value is mandatory. 

Yes/No

[1 :256] char

Lemon Way SAS

companyWebsite

Website URL

If isCompany = 1 then this value is mandatory. 

Yes/No

[1 :256] char

www.lemonway.fr

companyDescription

Company description

If isCompany = 1 then this value is mandatory. 

Yes/No

[1 :256] char

Ecommerce, clothings

companyIdentificationNumber

Company identification number

No

[1 :256] char

123567ABCDEF

isDebtor

For crowdfunding/loan platforms, indicates if the wallet is created for a debtor
1: yes
0 or empty: no

No

[1] char

1

nationality

Nationality of the client, using ISO-3 format.
Please separate multiple nationalities with a comma.

Yes

[0 :19] char

FRA,USA

birthcity

CLIENT city of birth

No

[0 :140] car

Montreuil

birthcountry

CLIENT country of birth, using ISO-3

No

[3] char

FRA

payerOrBeneficiary

Indicates if the wallet is created for a payer or a beneficiary :
Empty: unknown status (default)
1: payer
2: beneficiary

Yes

[1] char

1

isOneTimeCustomer

Indicates if the wallet is for a one-time customer. If yes, the wallet will be created with status 14, allowing only one payment. The maximum amount will be defined with Lemon Way.
0: no (default)
1: yes

No

[1] char

1

isTechWallet

This option is available depending on your contract.

0 or empty : no (default)
1 : yes, in case this option is enabled in your contract. Otherwise it will be considered a client wallet .


No[1] char1

Answer

<?xml version="1.0" encoding="utf-8"?>
<WALLET>
	<ID>string</ID>
	<LWID>string</LWID> <!-- since version 1.1-->
	<LIMITS> <!-- à partir de la version 1.2-->
		<TOTALMONEYINALLOWED>string</TOTALMONEYINALLOWED>
		<AMOUNTMONEYINALLOWED>string</AMOUNTMONEYINALLOWED>
	</LIMITS>
 </WALLET>
{  
    "WALLET":{  
        "ID":"string",
        "LWID":"string",
		"LIMITS": {
			"TOTALMONEYINALLOWED":"string",
			"AMOUNTMONEYINALLOWED":"string"
		}
    }
}

Version

Item

Description

Example

>= 1.0

ID

Wallet ID inscrit avec succès

33612345678

>= 1.1

LWID

Unique Lemon Way ID.
This ID is generated by our server. You can see this ID in the BACKOFFICE

2343

>= 1.2LIMITS

One time customer only

Indicates the wallet's limits


>= 1.2
TOTALMONEYINALLOWED
Total money in number allowed for this wallet 4
>= 1.2
AMOUNTMONEYINALLOWED
Total money in amount allowed for this wallet 1000,00


We apply various validation rules for different parameters For eg:

  • Check injection: Sensible string parameters (Email, Name..) must not contains odds character for eg: *&#[]()=<>
  • Names (First name, last name) must to be rather serious. For eg:
    • it should not be "Unknow", "Inconnu", "Test" or "xxx" 
    • Names must to have at least 2 characters with at least 1 vowel
    • First name must not be same as last name
    • We might apply other validation if detected a name of a VIP (politician)
    • 3 times the same charater in a row will also raise an error