​
Description

The UBO Declaration object is a container to provide information regarding the ultimate of a legal entity. It is mandatory for legal users with LegalPersonType of BUSINESS or PARTNERSHIP. See the glossary for details on the criteria defining beneficial owners.

​
Attributes

​
Id
string
The unique identifier of the object.
​
UserId
string
The unique identifier of the user.
​
CreationDate
Unix timestamp
The date and time at which the object was created.
​
Status
string
Returned values: CREATED, VALIDATION_ASKED, INCOMPLETE, VALIDATED, REFUSEDThe status of the declaration:
  • CREATED – The UBO Declaration is created, but not submitted yet.
  • VALIDATION_ASKED – The UBO Declaration is submitted for validation.
  • INCOMPLETE – The UBO Declaration is deemed incomplete by Mangopay teams.
  • VALIDATED – The UBO Declaration is validated by Mangopay’s team.
  • REFUSED – The UBO Declaration is rejected by Mangopay’s team. You can learn more about the reasons for refusal in the Reason and  Message fields.
​
Reason
string
The reason for which the UBO Declaration was REFUSED or considered as INCOMPLETE.
​
Message
string
Additional information about why the UBO Declaration was refused or marked as incomplete, provided by Mangopay’s team.
​
Array (UBOs)
array
The list of UBOs attached to the UBO Declaration.

How to

How to submit a UBO Declaration

Guide

Learn more about beneficial owners