UploadFile: document upload 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 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, with a file size smaller than 10 Mb, or 4Mb for instant validation. 

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 a 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 licence (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 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