GetWalletDetails: Getting detailed wallet data

Version

Description

1.1

Status of all uploaded documents and IBAN

1.2

Output: the type of uploaded document

1.3

Output: IBAN data and complete SWIFT BIC code

1.4

Output: SDD mandates

1.5

Output: validity date for documents

1.6

Output: blocked wallet
Output: IBAN holders

1.7

Output: Lemon Way's internal wallet ID

1.8

Output: List of cards associated to the wallet

2.0Output: wallet holder's name, company, payer or beneficiary, is debtor
2.2Output: nationality, birthdate, birth city, birth country, company identification number
2.3Output: title, number and street, post code/ZIP, city, country, phone number, mobile phone number, is company, is one-time customer, is wallet technique
2.4Output: document modification date
2.5Output: IBAN type
2.6Output: limits for this wallet

How it works

This method is often used by your system, to get all information regarding a wallet: amount of money in the wallet, IBAN associated to the wallet, document uploaded for KYC (Know Your Customer)… Everything about one wallet is here.

Fill at least one search field.

Request

<GetWalletDetails xmlns="Service_mb">

  <wlLogin>string</wlLogin>

  <wlPass>string</wlPass>

  <language>string</language>

  <version>string</version>

  <walletIp>string</walletIp>

  <walletUa>string</walletUa>

  <wallet>string</wallet>

  <email>string</email>

</GetWalletDetails>

  
    "wlLogin":"string",
    "wlPass":"string",
    "language":"string",
    "version":"string",
    "walletIp":"string",
    "walletUa":"string",
    "wallet":"string",
    "email":"string"
}

Item

Description

Mandatory

Format

Example

wallet

Wallet ID

No

[0 : 256] char

33612345678

email

Wallet email

No

[0 : 256] char

email@email.com

Answer

<?xml version="1.0" encoding="utf-8"?>
<WALLET>
	<ID>string<ID>
	<BAL>string</BAL>
	<NAME>string<NAME>
	<EMAIL>string<EMAIL>
	<DOCS> <!--since version 1.1-->
		<DOC>
			<ID> string </ID>
			<S> string </S>
			<TYPE> string </TYPE><!--since version 1.2-->
			<VD> string </VD><!--since version 1.5-->
			<D> string </D><!--since version 2.4-->
		</DOC>
		...
	</DOCS>
	<IBANS> <!--since version 1.1-->
		<IBAN>
			<ID> string </ID>
			<S> string </S>
			<DATA> string </DATA><!--since version 1.3-->
			<SWIFT> string </SWIFT><!--since version 1.3-->
			<HOLDER> string </HOLDER><!--since version 1.6-->
            <TYPE> string </TYPE><!--since version 2.5-->
		</IBAN>
		...
	</IBANS>
	<STATUS>string</STATUS>
	<BLOCKED>1</BLOCKED> <!--since de version 1.6-->
	<SDDMANDATES> <!--since de version 1.4-->
		<SDDMANDATE>
			<ID>sddMandateId</ID>
			<S>status</S>
			<DATA>iban</DATA>
			<SWIFT>swiftCode</SWIFT>
		</SDDMANDATE>
		...
	</SDDMANDATES>
	<LWID>string</LWID>
	<CARDS> <!--since version 1.8-->
		<CARD>
			<ID>string</ID>
			<EXTRA>
				<IS3DS> string </IS3DS>
				<CTRY> string </CTRY>
				<AUTH> string </AUTH>
				<NUM> string </NUM>
				<EXP> string </EXP>
				<TYP> string </TYP>
			</EXTRA>
		</CARD>
		...
	</CARDS>
	<!--since version 2.0-->
	<FirstName> string </FirstName>
	<LastName> string </LastName>
	<CompanyName> string </CompanyName>
	<CompanyDescription> string </CompanyDescription>
	<CompanyWebsite> string </CompanyWebsite>
	<!--since version 2.2--> 
	<Nationality> string </Nationality>
	<BirthDate> string </BirthDate>
	<BirthCity> string </BirthCity>
	<BirthCountry> string </BirthCountry>
	<CompanyIdentificationNumber> string </CompanyIdentificationNumber>
	<!--à partir de la version 2.3--> 
	<ClientTitle> string </ClientTitle>
	<Street> string </Street>
	<PostCode> string </PostCode>
	<City> string </City>
	<Country> string </Country>
	<PhoneNumber> string </PhoneNumber>
	<MobileNumber> string </MobileNumber>
	<IsCompany> string </IsCompany>
	<IsOneTimeCustomer> string </IsOneTimeCustomer>
	<IsTechWallet> string </IsTechWallet>
	<LIMITS> <!-- à partir de la version 2.6-->
		<TOTALMONEYINALLOWED>string</TOTALMONEYINALLOWED>
		<AMOUNTMONEYINALLOWED>string</AMOUNTMONEYINALLOWED>
	</LIMITS>
</WALLET>
 "WALLET":{  
            "ID":"string",
            "BAL":"string",
            "NAME":"string",
            "EMAIL":"string",
            "DOCS":[  
                {  
                    "ID":"string",
                    "S":"string",
                    "TYPE":"string",
                    "VD":"string",
                    "D":"string"
                },
                ...
            ],
            "IBANS":[  
                {  
                    "ID":"string",
                    "S":"string",
                    "DATA":"string",
                    "SWIFT":"string",
                    "HOLDER":"string",
                    "TYPE":"string"
                },
                ...
            ],
            "STATUS":"string",
            "BLOCKED":"1",
            "SDDMANDATES":[  
                {  
                    "ID":"sddMandateId",
                    "S":"status",
                    "DATA":"iban",
                    "SWIFT":"swiftCode"
                }
            ],
            "LWID":"string",
            "CARDS":[  
                {  
                    "ID":"string",
                    "EXTRA":{  
                        "IS3DS":"string",
                        "CTRY":"string",
                        "AUTH":"string",
                        "NUM":"string",
                        "EXP":"string",
                        "TYP":"string"
                    }
                },
                ...
            ],
            "FirstName":"string",
            "LastName":"string",
            "CompanyName":"string",
            "CompanyDescription":"string",
            "CompanyWebsite":"string",
            "Nationality": "string",
            "BirthDate": "string",
            "BirthCity": "string",
            "BirthCountry": "string",
            "CompanyIdentificationNumber": "string",
            "ClientTitle": "string",
            "Street": "string",
            "PostCode": "string",
            "City": "string",
            "Country": "string",
            "PhoneNumber": "string",
            "MobileNumber": "string",
            "IsCompany": "string",
            "IsOneTimeCustomer": "string",
            "IsTechWallet": "string",
			"LIMITS": {
				"TOTALMONEYINALLOWED":"string",
				"AMOUNTMONEYINALLOWED":"string"
			}
        }

Version

Item

Description

Example

>= 1.0

WALLET

Wallet


>= 1.0

ID

Wallet ID

33612345678 ou taxi67

>= 1.0

BAL

Wallet balance amount

23.90

>= 1.0

NAME

First name and last name

Jean Dupont

>= 1.0

EMAIL

Email

Jean.dupont@email.com

>= 1.1

DOCS

All documents related to the wallet including the old ones which are replaced (status = 4). You have to check the status of these documents in order to recognize the real or accepted document.


>= 1.1

DOC

Document


>= 1.1

DOC>ID

Document ID

20

>= 1.1

DOC>S

Status of the document.
The list of status is available in annex .

2

>= 1.2

DOC>TYPE

Type of document.
The list of types is available in annex .

0

>= 1.5

DOC>VD

Validity date of the document
Format: dd/mm/yyy
Empty if unknown

23/03/2016

>= 1.9DOC>CComment written by our KYC team on a documentincorrect ID card holder

>= 1.1

IBANS

IBAN list that changed since the entry date


>= 1.0

IBAN

IBAN


>= 1.0

IBAN>ID

IBAN ID

98

>= 1.0

IBAN>S

Only status 5 allows the use of the IBAN for a money-out.
The list of types is available in annex . 

5

>= 1.3

IBAN>DATA

IBAN saved

30002014400000156627A61

>= 1.3

IBAN>SWIFT

SWIFT BIC code associated to the IBAN

CRLYFRPP

>= 1.6

IBAN>HOLDER

Holder of the IBAN

Jean Dupont

>= 1.0

STATUS

Wallet status.
The list of status is available in annex

5

>= 1.6

BLOCKED

Indicates if wallet is blocked or not:
0: not blocked
1: blocked

1

>= 1.4

SDDMANDATES

List of SDD mandates associated to the wallet


>= 1.4

SDDMANDATE

SDD mandate block


>= 1.4

SDDMANDATE>ID

Mandate ID

98

>= 1.4

SDDMANDATE>S

Mandate status.
The list of types is available in annex . 

5

>= 1.4

SDDMANDATE>DATA

IBAN associated to the mandate


>= 1.4

SDDMANDATE>SWIFT

SWIFT code associated to the mandate


>= 1.7

LWID

Internal ID given by LEMON WAY (ID displayed on the BACKOFFICE)

3673

>= 1.8

CARDS

List of cards linked to the wallet


>= 2.0FirstNameHolder's First NameJean
>= 2.0LastNameHolder's Last NameDupont
>= 2.0CompanyNameCompany nameLEMON
>= 2.0CompanyDescriptionCompany DescriptionPayment Service
>= 2.0CompanyWebsiteCompany Websitelemonway.fr
>= 2.0isDebtorFor crowdfunding/loan platforms, indicates if the wallet is created for a debtor 
1: yes 
0 or empty: no
0
>= 2.0payerOrBeneficiary

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

1
>= 2.2NationalityNationalityFRA
>= 2.2BirthDateBirthdate
>= 2.2BirthCityBirth cityPARIS
>= 2.2BirthCountryBirth countryFRA
>= 2.2CompanyIdentificationNumberCompany identification number12
>= 2.3ClientTitleTitle"M" : M.
"F" : Mme 
"J" : Compte joint 
"U" : Inconnu (défaut)
>= 2.3StreetNumber and street26 rue de Paris
>= 2.3PostCodePost code/ZIP93100
>= 2.3City

City

Montreuil
>= 2.3CountryCountry using ISO-3

FRA

>= 2.3PhoneNumberPhone number with MSISDN format: international number with country code without "00" neither "+"33672635263
>= 2.3MobileNumberMobile phone number with MSISDN format: international number with country code without "00" neither "+"
This is used by default when eletronically signing documents
33672635263
>= 2.3IsCompanyIndicates if the wallet is created for a company 
1: yes 
0 or empty: no
1
>= 2.3IsOneTimeCustomerIndicates if the wallet is for a one-time customer
0: no (default) 
1: yes
1
>= 2.3IsTechWallet

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

1
>=2.4DOC>D
Indicates the modification date of the document
26/02/2019
>=2.5IBAN>TYPE

Indicates it it's a merchant iban or a virtual client iban.

1: merchant iban

2: iban virtual client.

2
>=2.6LIMITS

One time customer only

Indicates the wallet's limits


>=2.6TOTALMONEYINALLOWED

One time customer only

Total money in number allowed for this wallet

3
>=2.6AMOUNTMONEYINALLOWED

One time customer only

Total money in amount allowed for this wallet

1000.00