The UBO Declaration object
Description
Caution – Legacy endpoints being superseded by the hosted KYC/KYB solution
Mangopay’s hosted KYC/KYB solution is becoming mandatory for all platforms, and allows Legal Users to declare and verify all beneficial owners in the same IDV Session object.
The criteria defining beneficial owners remain the same.
The UBO Declaration object is a container to provide information regarding the ultimate beneficial owners of a legal entity. In the API-only flow, it is a requirement for legal users with LegalPersonType of BUSINESS or PARTNERSHIP.
Attributes
Max length: 128 characters (see data formats for details)
The unique identifier of the object.
Unix timestamp (UTC) of the date and time the object was created.
Unix timestamp (UTC) of the date and time the UBO Declaration was processed by Mangopay’s team.
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 theReasonandMessagefields.
The reason for which the UBO Declaration was REFUSED or considered as INCOMPLETE.
Additional information about why the UBO Declaration was refused or marked as incomplete, provided by Mangopay’s team.