Upload Document for KYC
Important
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.
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.
Security
For security reasons, only those document types are accepted: PDF, JPG, JPEG, and PNG.
Refrain from using the TIFF format.
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>
<?xml version="1.0" encoding="utf-8"?>
<UPLOAD>
<ID>string</ID>
<S>string</S>
<SUBSTATUS>string</SUBSTATUS>
<ACCOUNTSTATUS>string</ACCOUNTSTATUS>
</UPLOAD>
JSON
{
"wlLogin":"string",
"wlPass":"string",
"language":"string",
"version":"string",
"walletIp":"string",
"walletUa":"string",
"wallet":"string",
"fileName":"string",
"type":"string",
"buffer":"byte[]",
"sddMandateId":"string"
}
{
"UPLOAD":{
"ID":"string",
"S":"string",
"SUBSTATUS":"string",
"ACCOUNTSTATUS":"string"
}
}
Request Input Description
| 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: | Yes | String | 2 |
| 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 | ||||
| buffer | Byte array with the document. | Yes | Byte[] | |
| Encode in base 64 if necessary. | ||||
| 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. | No | int | 356 |
| This is not allowed to all of our partners, please contact us if you want to use it. | ||||
Response Output Description
| Item | Description | Example |
|---|---|---|
| UPLOAD | Upload | |
| ID | ID of the document | 521 |
| S | Status of the document | 1 |
| The list of document status is available in annex | ||
| SUBSTATUS | Sub status of the document | 2 |
| Only when Status = 1 | ||
| The list of substatus is available in annex | ||
| ACCOUNTSTATUS | Status of the Payment account | 5 |
| The list of account status is available in annex |