Create a New Legal Account

Important: From December 1, 2026, this endpoint will be deprecated; we advise you to move to our new Online Onboarding system, which is faster and more effective. Contact your account manager or support for information.


Enables your system to create a legal payment account by following these steps:

  1. Your client enters their personal data on your platform (e.g. in their profile).
  2. Your server calls the Accounts API.
  3. Lemonway provisions the payment account in your environment.
  4. Your system reads the API response and notifies the user.

The API enforces several validation rules:

  • Injection checks
    • String parameters (email, name, etc.) must not contain unusual or non‑standard characters.

  • Name requirements (first & last name)
    • Cannot be a placeholder or “made‑up” value (e.g. “name”, “nom”, “prenom”, “test”, “unknown”).
    • Must consist of at least two characters and include at least one vowel.
    • First name and last name must differ.
    • No character may repeat three times in a row.
    • Additional checks may apply for special cases (e.g. VIP or politically exposed persons).

Important: Whenever you see accountId in a path or body parameter, enter your wallet’s ID.

Body Params
company
object
required
boolean

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

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

string
length between 1 and 1

Client title

string
required
length between 2 and 256

Client first name

string
required
length between 2 and 256

Client last name

adresse
object
birth
object
string
required
length between 0 and 19

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

string
length between 6 and 30

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

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.

boolean

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

int32
required
1 to 2

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

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.

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.

Headers
string
required

Authorization bearer (OAuth 2)

string

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

string
required

IP address of the final client (PSU).

string

User-agent of the final client (PSU).

Responses

401

Unauthorized

500

InternalServerError

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json