The Natural 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 Natural User object represents an individual (natural person).

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

AddressobjectOptional
The postal address.
FirstNamestringOptional
LastNamestringOptional
BirthdayintegerOptional
NationalitystringOptional
CountryOfResidencestringOptional
OccupationstringOptional
IncomeRangeintegerOptional
ProofOfIdentitystringOptional
ProofOfAddressstringOptional
CapacitystringOptional
This is a deprecated parameter.
IdstringOptional
TagstringOptional
CreationDateintegerOptional
PersonTypestringOptional
EmailstringOptional
KYCLevelstringOptional
TermsAndConditionsAcceptedbooleanOptional
TermsAndConditionsAcceptedDateintegerOptional
UserCategorystringOptional
UserStatusstringOptional