How to submit a UBO Declaration

Introduction

This how-to guide will show you how to successfully submit a UBO Declaration for validation by Mangopay.

The UBO Declaration object allows you to submit information concerning the beneficial owners of a legal user. Find out more about the process in the Beneficial owners article.

Test data

You can simulate the acceptance or refusal of a UBO Declaration in Sandbox. To do so, when you create the first UBO (Step 2 below), set the FirstName to the relevant (case-sensitive) value to produce the desired outcome after submission (Step 4):

1. Create the UBO Declaration

Create the UBO Declaration with the UserId.

POST /v2.01/{ClientId}/users/{UserId}/kyc/ubodeclarations

The response shows the Status “CREATED” and contains an Id, which is the unique identifier of the UBO Declaration object. You need to save this for the next step.

2. Create the first UBO

With the Id of the UBO Declaration as the UboDeclarationId path parameter, create the first UBO, entering the required information. In Sandbox, set the FirstName to the desired test outcome, for example, AcceptUBO.

POST /v2.01/{ClientId}/users/{UserId}/kyc/ubodeclarations/{UboDeclarationId}/ubos

3. Create additional UBOs as needed

Repeat Step 2 as many times as necessary. Your UBO Declaration can contain a minimum of 1 and a maximum of 15 UBOs.

4. Submit the UBO Declaration

Once all UBOs are created and correctly declared, submit the declaration for review by Mangopay’s teams by changing the Status from CREATED to VALIDATION_ASKED.

PUT /v2.01/{ClientId}/users/{UserId}/kyc/ubodeclarations/{UboDeclarationId}

5. Set up relevant hooks (recommended)

There are dedicated hooks to provide notifications of the outcome of the review by Mangopay:

• UBO_DECLARATION_VALIDATED, notifying that the UBO Declaration status has changed to VALIDATED.
• UBO_DECLARATION_REFUSED, notifying that the UBO Declaration status has changed to REFUSED.
• UBO_DECLARATION_INCOMPLETE, notifying that the UBO Declaration status has changed to INCOMPLETE.

7. If incomplete, take any remedial action

If the response from Mangopay is that the UBO Declaration is INCOMPLETE, check the View a UBO Declaration endpoint for information on why.

Take the necessary steps indicated by Mangopay in the Reason and Message parameters.

1
{
2
   "Id": "160691001",
3
   "UserId": "160686549",
4
   "CreationDate": 1674491433,
5
   "ProcessedDate": null,
6
   "Status": "INCOMPLETE",
7
   "Reason": "SHAREHOLDERS_DECLARATION_NEEDED",
8
   "Message": null,
9
   "Ubos": [
10
       {
11
           "Id": "160691407",
12
           "CreationDate": 1674491528,
13
           "LastName": "Boulanger",
14
           "FirstName": "Marie",
15
           "Birthday": 652117514,
16
           "Nationality": "FR",
17
           "Address": {
18
               "AddressLine1": "16 rue de Paris",
19
               "AddressLine2": null,
20
               "City": "Paris",
21
               "Region": "Île-de-France",
22
               "PostalCode": "75001",
23
               "Country": "FR"
24
           },
25
           "Birthplace": {
26
               "City": "Paris",
27
               "Country": "FR"
28
           },
29
           "IsActive": true
30
       }
31
   ]
32
}

If further documents required

It may be that additional documentary evidence is required, such as the Shareholder Declaration form or another verification document. Any additional documents should be submitted in a KYC Document object.

How to submit a KYC Document →

If UBO added in error

It may be that the declaration contains information about someone who is not in fact a beneficial owner. If this happens, change the IsActive parameter of the UBO object to false to have them disregarded from the declaration. This action is irreversible, but another UBO can be added in their place.

PUT /v2.01/{ClientId}/users/{UserId}/kyc/ubodeclarations/{UboDeclarationId}/ubos/{UboId}

1
{
2
   "Id": "160691407",
3
   "CreationDate": 1674491528,
4
   "LastName": "Boulanger",
5
   "FirstName": "Marie",
6
   "Birthday": 652117514,
7
   "Nationality": "FR",
8
   "Address": {
9
       "AddressLine1": "16 rue de Paris",
10
       "AddressLine2": null,
11
       "City": "Paris",
12
       "Region": "Île-de-France",
13
       "PostalCode": "75001",
14
       "Country": "FR"
15
   },
16
   "Birthplace": {
17
       "City": "Paris",
18
       "Country": "FR"
19
   },
20
   "IsActive": false
21
}

8. Once remediated, re-submit the UBO Declaration

Once the reason that the declaration was marked INCOMPLETE has been addressed, re-submit the UBO Declaration by changing the Status to VALIDATED_ASKED (as in Step 4).