Create a New Individual Account

post deprecated

https://ws.lemonway.fr/mb/ENVNAME/prod/directkitrest/v2/accounts/individual

Lets you to create a individual 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 our 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)

Body Params

accountId

string

required

length between 1 and 100

Payment account ID that you use to identify the customer.Choose your unique number.
Note: 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.

string

required

length between 6 and 256

Unique Email

title

string

length between 1 and 1

Client title

firstName

string

required

length between 2 and 256

Client first name

lastName

string

required

length between 2 and 256

Client last name

adresse

object

birth

object

nationality

string

required

length between 0 and 19

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

phoneNumber

string

length between 6 and 30

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

mobileNumber

string

length between 6 and 30

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

isDebtor

boolean

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

payerOrBeneficiary

int32

required

1 to 2

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

isOneTimeCustomerAccount

boolean

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.

isTechnicalAccount

boolean

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.

isUltimateBeneficialOwner

boolean

Headers

Authorization

string

required

Authorization bearer (OAuth 2)

PSU-Accept-Language

string

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

PSU-IP-Address

string

required

IP address of the final client (PSU).

PSU-User-Agent

string

User-agent of the final client (PSU).

Responses

401

Unauthorized

500

InternalServerError

200OK