PUT
/
v2.01
/
{ClientId}
/
users
/
legal
/
{UserId}

Read more about the Legal User object →

Caution – Modification may cause verification downgrade

Modification of some values may cause an Owner user to have a verification document marked as outdated, which may lead to their KYCLevel being downgraded from REGULAR to LIGHT

The impacted parameters are:

  • LegalRepresentativeFirstName
  • LegalRepresentativeLastName
  • LegalRepresentativeBirthday
  • LegalRepresentativeNationality
  • LegalPersonType

For more information, see the Verification downgrade article.

Note – Country-based restrictions apply to users

Due to Mangopay’s , it is not possible to create or modify users using blocked countries.

For Legal Users, the following parameters are concerned:

  • Country of the HeadquartersAddress
  • LegalRepresentativeNationality
  • LegalRepresentativeCountryOfResidence
  • Country of the LegalRepresentativeAddress

For more information, see the Country restrictions article.

Path parameters

UserId
string
required

The unique identifier of the user.

Body parameters

HeadquartersAddress
object

Required if UserCategory is OWNER. Child parameters returned null if UserCategory is PAYER.

The legally registered address of the entity’s administrative center.

LegalRepresentativeAddress
object

The address of the entity’s legal representative.

Name
string
required

Max. length: 255 characters

The registered legal name of the entity. The Name value should be the one registered with the relevant national authority.

LegalPersonType
string
required

Allowed values: BUSINESS, PARTNERSHIP, ORGANIZATION, SOLETRADER

The type of legal user. For information on which LegalPersonType to use for a particular local legal structure, see the verification requirements.

Caution: Modification of the LegalPersonType may result in a verification downgrade.

LegalRepresentativeFirstName
string
required

Max. length: 100 characters

The first name of the entity’s legal representative.

LegalRepresentativeLastName
string
required

Max. length: 100 characters

The last name of the entity’s legal representative.

LegalRepresentativeEmail
string

Format: A valid email address

The email address of the entity’s legal representative.

Returned null if UserCategory is PAYER.

LegalRepresentativeBirthday
timestamp

Required if UserCategory is OWNER. Returned null if UserCategory is PAYER.

The date of birth of the entity’s legal representative.

LegalRepresentativeNationality
string

Allowed values: Two-letter country code (ISO 3166-1 alpha-2 format).

Required if UserCategory is OWNER. Returned null if UserCategory is PAYER.

The nationality of the entity’s legal representative.

LegalRepresentativeCountryOfResidence
string

Allowed values: Two-letter country code (ISO 3166-1 alpha-2 format).

Required if UserCategory is OWNER. Returned null if UserCategory is PAYER.

The country of residence of the entity’s legal representative.

CompanyNumber
string

Required if UserCategory is OWNER and LegalPersonType is BUSINESS. Returned null if UserCategory is PAYER.

The registration number of the entity, assigned by the relevant national authority. For information on the expected format for a specific country, see the Company number guide. To validate the format of a number before submitting documents for verification, use POST Validate the format of User data.

Tag
string

Max. length: 255 characters

Custom data that you can add to this object.

Email
string
required

Format: A valid email address

The email address for the entity.

TermsAndConditionsAccepted
boolean
required

Default value: false

Whether the user has accepted Mangopay’s terms and conditions (as defined by your contract).
If this value is not true, Owners will be limited in their use of Mangopay.

UserCategory
string
required

Default value: PAYER

Allowed values: PAYER, OWNER

The category of the user:

  • PAYER – User who can only make pay-ins to their wallet and transfers to other wallets.
  • OWNER – User who can do everything a Payer can, plus receive transfers to their wallet. To request payouts, an Owner user’s KYCLevel must be REGULAR. For more information, see the Verification section.

Responses