ClientId
and an API key – if you don’t have these, contact Sales to get access to the Mangopay DashboardLegalPersonType
is BUSINESS
or PARTNERSHIP
and for whom you have submitted all the necessary KYC Documents (see How to submit a KYC Document).UserId
.
POST /v2.01/{ClientId}/users/{UserId}/kyc/ubodeclarations
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.
Id
of the UBO Declaration as the UboDeclarationId
path parameter, create the first UBO, entering the required information.
POST /v2.01/{ClientId}/users/{UserId}/kyc/ubodeclarations/{UboDeclarationId}/ubos
Status
from CREATED
to VALIDATION_ASKED
.
PUT /v2.01/{ClientId}/users/{UserId}/kyc/ubodeclarations/{UboDeclarationId}
VALIDATED
.REFUSED
.INCOMPLETE
.INCOMPLETE
declarations can be reusedUBO Declarations can be resubmitted or not depending on their status:REFUSED
- The object can’t be re-submitted. You need to create a new declaration.INCOMPLETE
- The object can be modified and re-submitted.Reason
and Message
parameters returned by the View a UBO Declaration endpoint.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.
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}
INCOMPLETE
has been addressed, re-submit the UBO Declaration by changing the Status to VALIDATED_ASKED
(as in Step 4).