v1

latestOpenAPI 3.0.02026-07-2691259477.2 KB

Accounts | Create & KYC

Create a New Legal Account

Lets you to create a legal payment account:

Your client enter their data on your platform, for example on their profile space.
Your server calls our Accounts API.
Lemonway creates the payment account in your environment.
Your system reads the method response and informs the user.

We apply validation rules for different parameters.

Check Injection:

String parameters (email, name and so on) must not contain odd characters.

Names (first and last name)

Not made-up names: "name", "nom", "prénom", "prenom", "lastname", "last_name", "last name", "firstname", "first_name", "first name", "name", "test", "unknow"
Names must have at least 2 characters with at least 1 vowel
The first name must not be the same as the last name
Using the same the same character 3 times in a row will cause an error
We might apply other validation rules, for example: in the case VIP (politician)

post/v2/accounts/legal

Headers

Authorizationstring required

Authorization bearer (OAuth 2)

PSU-Accept-Languagestring

Response language accepted by final client (PSU). English by default

PSU-IP-Addressstring required

IP address of the final client (PSU).

PSU-User-Agentstring

User-agent of the final client (PSU).

Request body

isUltimateBeneficialOwnerboolean

Indicates if the legal representative is also an Ultimate Beneficial owner (i.e. shareholder with >25% of capital or voting rights).

accountIdstring required

Payment account ID that you use to identify the customer.Choose your unique number.<br /><b>Note:</b> If you plan to credit payments accounts by fund transfer, please use short alphanumeric payment account identifiers (max 20 char.). Your customers will have to write their payment account identifier in the transfer label/comment, a label of more that 20 characters could be cut when passing the the banking system.

emailstring

Unique Email

titlestring

Client title

firstNamestring required

Client first name

lastNamestring required

Client last name

nationalitystring

Client nationality, using ISO 3166-1 alpha-3 format Please separate multiple nationalities with a comma

phoneNumberstring

Phone number with MSISDN format: international number with country code without "00" neither "+".

mobileNumberstring

Mobile phone number with MSISDN format: international number with country code without "00" neither "+". This will be used by default when eletronically signing documents.

isDebtorboolean

For crowdfunding/loan platforms, indicates if the wallet is created for a debtor.

payerOrBeneficiaryinteger

Indicates if the payment account is created for a Payer or a Beneficiary. 1: Payer (default) 2: Beneficiary

isOneTimeCustomerAccountboolean

Indicates if the payment account is for a one-time customer. If yes, the payment account will be created with status 14, allowing only one payment. The maximum amount will be defined with Lemonway.

isTechnicalAccountboolean

Note: This option is available depending on your contract True, in case this option is enabled in your contract. Otherwise it will be considered a Client Wallet.

Example request

{
  "company": {
    "name": "Lemonway SAS",
    "description": "Ecommerce, clothings",
    "websiteUrl": "www.lemonway.fr",
    "identificationNumber": "123567ABCDEF"
  },
  "accountId": "33612345678",
  "email": "adresse@domaine.com",
  "title": "M",
  "firstName": "Pierre",
  "lastName": "Dupont",
  "adresse": {
    "street": "26 rue de Paris",
    "postCode": "93100",
    "city": "Montreuil",
    "country": "FRA"
  },
  "birth": {
    "date": "1985/03/21",
    "city": "Montreuil",
    "Country": "FRA"
  },
  "nationality": "FRA,USA",
  "phoneNumber": "33672635263",
  "mobileNumber": "33672635263",
  "isDebtor": true,
  "payerOrBeneficiary": 1,
  "isOneTimeCustomerAccount": false,
  "isTechnicalAccount": false
}