PUT
/
v2.01
/
{ClientId}
/
users
/
{UserId}
/
kyc
/
ubodeclarations
/
{UboDeclarationId}
{
    "Status": "VALIDATION_ASKED",
}  

{
    "Id": "158947737",
    "UserId": "158947634",
    "CreationDate": 1672153298,
    "ProcessedDate": null,
    "Status": "VALIDATION_ASKED",
    "Reason": null,
    "Message": null,
    "Ubos": [
        {
            "Id": "158947898",
            "CreationDate": 1672153693,
            "LastName": "Wiza",
            "FirstName": "Jess",
            "Birthday": 652117514,
            "Nationality": "FR",
            "Address": {
                "AddressLine1": "669 Ratke Forge",
                "AddressLine2": "Schamberger Walk",
                "City": "Paris",
                "Region": "Île-de-France",
                "PostalCode": "75001",
                "Country": "FR"
            },
            "Birthplace": {
                "City": "Paris",
                "Country": "FR"
            },
            "IsActive": true
        }
    ]
}

Read more about the UBO Declaration object →

Submitting a UBO Declaration consists in updating the object Status parameter value to VALIDATION_ASKED.

From there, Mangopay Compliance team will validate, indicate as incomplete, or reject the declaration.

​
Path parameters

​
UserId
string
required

The unique identifier of the user.

​
UboDeclarationId
string
required

The unique identifier of the UBO Declaration.

​
Body parameters

​
Status
string
required

Allowed values: VALIDATION_ASKED

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.

​
Responses

{
    "Id": "158947737",
    "UserId": "158947634",
    "CreationDate": 1672153298,
    "ProcessedDate": null,
    "Status": "VALIDATION_ASKED",
    "Reason": null,
    "Message": null,
    "Ubos": [
        {
            "Id": "158947898",
            "CreationDate": 1672153693,
            "LastName": "Wiza",
            "FirstName": "Jess",
            "Birthday": 652117514,
            "Nationality": "FR",
            "Address": {
                "AddressLine1": "669 Ratke Forge",
                "AddressLine2": "Schamberger Walk",
                "City": "Paris",
                "Region": "Île-de-France",
                "PostalCode": "75001",
                "Country": "FR"
            },
            "Birthplace": {
                "City": "Paris",
                "Country": "FR"
            },
            "IsActive": true
        }
    ]
}  

{
    "Status": "VALIDATION_ASKED",
}