​
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, REFUSED

The 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