The regulatory thresholds for downloading documents (KYC: Know Your Customer) are indicated in your service contract signed with Lemonway. Please respect them scrupulously. Lemonway systematically controls the transmission of documents.

Version	Description
1.0
1.1	Reducing the number of types of documents (old types 3, 4 et 5 into type 1), add type "kbis" (proof of the existence of an enterprise at the chamber of commerce).
1.2	Added SUBSTATUS (available when the status S=1) and ACCOUNTSTATUS (Account KYC status) in the Response.

How it works

Use UploadFile to upload documents into a payment account (max size 10 Mb) for manual validation. 4MB max to be analyzed instantly by the machine.

For security reason, only those documents types are accepted : PDF, JPG, JPEG, and PNG.

Refrain from using TIFF and prefer PDF.

If a previously uploaded document has been rejected, it is possible to upload the same document again to the same document type slot

Request

XML

<UploadFile xmlns="Service_mb">
  <wlLogin>string</wlLogin>
  <wlPass>string</wlPass>
  <language>string</language>
  <version>string</version>
  <walletIp>string</walletIp>
  <walletUa>string</walletUa>
  <wallet>string</wallet>
  <fileName>string</fileName>
  <type>string</type>
  <buffer>byte[]</buffer>
  <sddMandateId>string</sddMandateId>
</UploadFile>

JSON

{   
    "wlLogin":"string",
    "wlPass":"string",
    "language":"string",
    "version":"string",
    "walletIp":"string",
    "walletUa":"string",
    "wallet":"string",
    "fileName":"string",
    "type":"string",
    "buffer":"byte[]",
    "sddMandateId":"string"
}

Item	Description	Mandatory	Format	Example
wallet	Payment account ID	Yes	[0 : 256]	12345
fileName	Name of the document	Yes	String	CIN_wallet1.png
type	Type of document: 0: ID card (both sides in one file) 1: Proof of address 2: Scan of proof of IBAN 3: Passport (European Community) 4: Passport (outside the European Community) 5: Residence permit (both sides in one file) 7: Official company registration document (Kbis extract or equivalent) 11: Driver license (both sides in one file) 12: Status 13: Selfie 21: SDD Mandate	Yes	String	2
buffer	Byte array with the document. Encode in base 64 if necessary.	Yes	Byte[]
sddMandateId	This allows you to upload the mandate document you signed yourself (with your own signing partner) in order to validate a mandate ID you previously created with RegisterSddMandate. This is not allowed to all of our partners, please contact us if you want to use it.	No	int	356

Response

XML

<?xml version="1.0" encoding="utf-8"?>
<UPLOAD>
	<ID>string</ID>
    <S>string</S>
    <SUBSTATUS>string</SUBSTATUS>
    <ACCOUNTSTATUS>string</ACCOUNTSTATUS>
</UPLOAD>

JSON

{  
    "UPLOAD":{  
        "ID":"string",
        "S":"string",
	    "SUBSTATUS":"string",
	    "ACCOUNTSTATUS":"string"
    }
}

Item	Description	Example
UPLOAD	Upload
ID	ID of the document	521
S	Status of the document The list of document status is available in annex	1
SUBSTATUS	Sub status of the document Only when Status = 1 The list of substatus is available in annex	2
ACCOUNTSTATUS	Status of the Payment account The list of account status is available in annex	5

UploadFile: Upload Document for KYC

How it works

Request

Response

Search