User verificationUBO declarations

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

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.

Object (UBO)
object

The UBO object created by the platform.

Id
string

The unique identifier of the object.

CreationDate
Unix timestamp

The date and time at which the object was created.

LastName
string

Max. length: 100 characters
The last name of the beneficial owner.

FirstName
string

Max. length: 100 characters
The first name of the beneficial owner.

Birthday
Unix timestampRequired

The date of birth of the beneficial owner.

Note: This is a Unix timestamp in UTC. Ensure you convert your timezone to UTC to avoid midnight being interpreted as the day before.

Nationality
stringRequired

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

The nationality of the beneficial owner.

Address
objectRequired

The postal address of the beneficial owner.

AddressLine1
stringRequired

Max. length: 255 characters
The first line of the address.

AddressLine2
string

Max. length: 255 characters
The second line of the address.

City
stringRequired

Max. length: 255 characters
The city of the address.

Region
string

Max. length: 255 characters Required if Country is US, CA, or MX.

The region of the address.

PostalCode
stringRequired

Max. length: 255 characters
The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.

Country
stringRequired

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

The country of the address.

Birthplace
objectRequired

Information about the beneficial owner’s place of birth.

City
stringRequired

The city in which the beneficial owner was born.

Country
stringRequired

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

The country in which the beneficial owner was born.

IsActive
boolean

Whether or not the UBO is considered in the declaration. To disregard a UBO, set this parameter to false. This action is irreversible.

How to
How to submit a UBO Declaration
Guide
Learn more about beneficial owners