The Legal User object

Deprecated

Caution - Deprecated endpoints

The legacy User endpoints are deprecated. These endpoints will stop working and return an error after Dec 15, 2025.

These endpoints were made redundant by the equivalent SCA-enabled endpoints during the introduction of SCA.

The Legal User object represents a legal entity (legal person) like a company, non-profit or sole proprietor (read more about user types).

Mangopay users have one of two categories, indicated by UserCategory:

  • PAYER – User who can only make pay-ins to their wallets and transfers to other wallets.
  • OWNER – User who can also receive transfers to their wallets. Owners are able to request KYC verification, which if successful gives them the KYCLevel of REGULAR and the ability to request payouts.

Attributes

HeadquartersAddressobjectOptional
The postal address.
LegalRepresentativeAddressobjectOptional
The postal address.
NamestringOptional
LegalPersonTypestringOptional
LegalRepresentativeFirstNamestringOptional
LegalRepresentativeLastNamestringOptional
LegalRepresentativeEmailstringOptional
LegalRepresentativeBirthdayintegerOptional
LegalRepresentativeNationalitystringOptional
LegalRepresentativeCountryOfResidencestringOptional
ProofOfRegistrationstringOptional
ShareholderDeclarationstringOptional
StatutestringOptional
LegalRepresentativeProofOfIdentitystringOptional
CompanyNumberstringOptional
IdstringOptional
TagstringOptional
CreationDateintegerOptional
PersonTypestringOptional
EmailstringOptional
KYCLevelstringOptional
TermsAndConditionsAcceptedbooleanOptional
TermsAndConditionsAcceptedDateintegerOptional
UserCategorystringOptional
UserStatusstringOptional