RegisterWallet

Creating a New Wallet

How it works

By calling this method enables Lemonway to create a wallet.

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

🚧

IMPORTANT

We apply validation rules for different parameters.

Check Injection:

  • String parameters (email, name and so on) must not contain odd characters, for example: *&#=<>

Names (first and last name)

  • Not made-up names: "Unknown", "Inconnu", "Test" or "xxx"
  • Names must have at least 2 characters with at least 1 vowel
  • The first name must not be the same as the last name
  • Using the same the same character 3 times in a row will cause an error
  • We might apply other validation rules, for example: in the case VIP (politician)

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>

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

{   
    "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",
}    
{  
    "WALLET":{  
        "ID":"string",
        "LWID":"string",
        "LIMITS": {
            "TOTALMONEYINALLOWED":"string",
            "AMOUNTMONEYINALLOWED":"string"
        }
    }
}
ItemDescriptionMandatoryFormatExample
walletWallet ID that you use to identify the customer. Choose your unique number.Yes[1 :100] char33612345678
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: [email protected]%+-  (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")
clientMailUnique Email.Yes[6 :256] char[email protected]
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.
clientTitleCLIENT titleNo[1] char"M": Mr.
"F": Miss
"J": joint account
"U": Unknown(default)
clientFirstNameCLIENT first nameYes[2 :256] charPierre
clientLastNameCLIENT last nameYes[2 :256] charDupont
streetCLIENT number and streetNo[0 :256] car26 rue de Paris
postCodeCLIENT post code/ZIPNo[0 :10] car93100
cityCLIENT cityNo[0 :140] carMontreuil
ctryCLIENT country using ISO-3Yes[3] charFRA
phoneNumberPhone number with MSISDN format: international number with country code without "00" neither "+".No[6 :30] char33672635263
No "00"
No "+" thanks
mobileNumberMobile phone number with MSISDN format: international number with country code without "00" neither "+".No[6 :30] char33672635263
This will be used by default when electronically signing documents
No "00"
No "+" thanks
birthdateClient birthdateYesdd/MM/yyyy21/03/1985
isCompanyIndicates if the wallet is created for a companyYes[1] char1
1: Legal entity (Company, association...)
0 or empty: Individual person
companyNameName of the company (at least one alphabetic character is required)No[1 :256] charLemonway SAS
companyWebsiteWebsite URLNo[1 :256] charwww.lemonway.com
companyDescriptionCompany descriptionYes/No[1 :256] charEcommerce, clothings
If isCompany = 1 then this value is mandatory. 
companyIdentificationNumberCompany identification numberNo[1 :256] char123567ABCDEF
isDebtorFor crowdfunding/loan platforms, indicates if the wallet is created for a debtorNo[1] char1
1: yes
0 or empty: no
nationalityNationality of the client, using ISO-3 format.Yes[0 :19] charFRA,USA
Please separate multiple nationalities with a comma.
birthcityClient city of birthNo[0 :140] carMontreuil
birthcountryClient country of birth, using ISO-3No[3] charFRA
isUltimateBeneficialOwnerIndicates if the legal representative is also an Ultimate Beneficial owner (ie shareholder with >25% of capital or voting rights).No[1] char1
0: no (default)
1: yes
payerOrBeneficiaryIndicates if the wallet is created for a payer or a beneficiary :Yes[1] char1
Empty: unknown status (default)
1: payer
2: beneficiary
isOneTimeCustomerIndicates 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.No[1] char1
0: no (default)
1: yes
isTechWalletThis option is available depending on your contract.No[1] char1
0 or empty: no (default)
1: yes, in case this option is enabled in your contract. Otherwise, it will be considered a client wallet.
isUltimateBeneficialOwnerIndicates if the legal representative is also an Ultimate Beneficial owner (ie shareholder with >25% of capital or voting rights).No[1] char1
0: no (default)
1: yes