UploadFile: Upload Document for KYC

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.2Added 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.

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

SStatus 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
ACCOUNTSTATUSStatus of the Payment account
The list of account status is available in annex
5