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

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