Version	Description
1.1	Output: unique Lemonway wallet ID, generated by Lemonway
1.2	Output: limits for this wallet

How it works

By calling this method enables Lemonway to create a wallet.

Users enter their data on your web site, for example on his 'profile' area on your web site
Your server calls our RegisterWallet API
Lemonway creates the wallet in your environment
Your system reads the answer of this method and informs the user

Request

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>
  <isUltimateBeneficialOwner>string</isUltimateBeneficialOwner>
</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",
    "isUltimateBeneficialOwner":"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 than 20 characters could be cut when passing the banking system. Accepting characters: A-Za-z0-9._@%+- (Example: space is not in this list so you cannot use it here) Reserved name (case insensitive): "lw", "lemonwaycbv", "sc" (example: we will return an error if you try to create wallet "Lw")	Yes	[1 :100] char	33612345678
clientMail	Unique Email. The Email must be unique in YOUR environment. If the Emails already 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 alphabetic character is required)	No	[1 :256] char	Lemonway SAS
companyWebsite	Website URL	No	[1 :256] char	www.lemonway.com
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
isUltimateBeneficialOwner	Indicates if the legal representative is also an Ultimate Beneficial owner (ie shareholder with >25% of capital or voting rights). 0: no (default) 1: yes	No	[1] char	1
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 Lemonway. 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] char	1
isUltimateBeneficialOwner	Indicates if the legal representative is also an Ultimate Beneficial owner (ie shareholder with >25% of capital or voting rights). 0: no (default) 1: yes	No	[1] char	1

Response

XML

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

JSON

{  
    "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 Lemonway ID. This ID is generated by our server. You can see this ID in the BACKOFFICE	2343
>= 1.2	LIMITS	One time customer only Indicates the wallet's limits
>= 1.2	TOTALMONEYINALLOWED	The total money-in number allowed for this wallet	4
>= 1.2	AMOUNTMONEYINALLOWED	The 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 contain odds character for eg: *&#[]()=<>
Names (First name, last name) must to be rather serious. For eg:
- Should not be "Unknow", "Inconnu", "Test" or "xxx"
- Names must to have at least 2 characters with at least 1 vowel
- The first name must not be the same as the last name
- We might apply other validation if detected a name of a VIP (politician)
- 3 times the same character in a row will also raise an error

RegisterWallet: Creating a New Wallet

How it works

Request

Response

Search