GetWalletDetails: Get 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: Lemonway's internal wallet ID

1.8

Output: List of cards associated to the wallet

2.0

Output: wallet holder's name, company, payer or beneficiary, is debtor

2.2

Output: nationality, birthdate, birth city, birth country, company identification number

2.3

Output: title, number and street, post code/ZIP, city, country, phone number, mobile phone number, is company, is one-time customer, is wallet technique

2.4

Output: document modification date

2.5

Output: IBAN type

2.6

Output: limits for this wallet

How it works

This method is often used by your system, to get all information regarding a wallet: the amount of money in the wallet and so forth. Everything about one wallet is here.

Fill at least one search field.

Request

XML

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


JSON

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

Response

XML

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


JSON

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

DOC>C

Comment written by our KYC team on a document

incorrect 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 LEMONWAY (ID displayed on the BACKOFFICE)

3673

>= 1.8

CARDS

List of cards linked to the wallet


>= 2.0

FirstName

Holder's First Name

Jean

>= 2.0

LastName

Holder's Last Name

Dupont

>= 2.0

CompanyName

Company name

LEMON

>= 2.0

CompanyDescription

Company Description

Payment Service

>= 2.0

CompanyWebsite

Company Website

lemonway.com

>= 2.0

isDebtor

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

0

>= 2.0

payerOrBeneficiary

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

1

>= 2.2

Nationality

Nationality

FRA

>= 2.2

BirthDate

Birthdate


>= 2.2

BirthCity

Birth city

PARIS

>= 2.2

BirthCountry

Birth country

FRA

>= 2.2

CompanyIdentificationNumber

Company identification number

12

>= 2.3

ClientTitle

Title

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

>= 2.3

Street

Number and street

26 rue de Paris

>= 2.3

PostCode

Post code/ZIP

93100

>= 2.3

City

City

Montreuil

>= 2.3

Country

Country using ISO-3

FRA

>= 2.3

PhoneNumber

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

33672635263

>= 2.3

MobileNumber

Mobile phone number with MSISDN format: international number with country code without "00" neither "+"
This is used by default when eletronically signing documents

33672635263

>= 2.3

IsCompany

Indicates if the wallet is created for a company 
1: yes 
0 or empty: no

1

>= 2.3

IsOneTimeCustomer

Indicates if the wallet is for a one-time customer
0: no (default) 
1: yes

1

>= 2.3

IsTechWallet

0 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.4

DOC>D

Indicates the modification date of the document

26/02/2019

>=2.5

IBAN>TYPE

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

1: merchant iban

2: iban virtual client.

2

>=2.6

LIMITS

One time customer only

Indicates the wallet's limits


>=2.6

TOTALMONEYINALLOWED

One time customer only

Total money in number allowed for this wallet

3

>=2.6

AMOUNTMONEYINALLOWED

One time customer only

Total money in amount allowed for this wallet

1000.00