Skip to main content
Mangopay provides a web-hosted identity verification (IDV) experience on which your users can complete all the steps necessary. The endpoint to initiate the session is the same for all users, POST Create an IDV Session, and the user’s type determines the frontend flow they are presented. For Natural Users, the session allows the user to complete the liveness check using their accepted ID proof. For the different types of Legal User, the session guides the user through forms to fill in regarding their legal entity. For Businesses, the session also includes the declaration of beneficial owners, which are referred to as Persons of Significant Control (PSCs) in the hosted solution.
Note – IDV sessions available in the DashboardIn the Mangopay Dashboard, your platform can:
  • Generate a new session link for a user
  • See details of sessions, including the checks performed and refusal reasons
To access, navigate to a given User’s profile and click the KYV verification tab.

​
Transition to hosted IDV

Note - Hosted KYC/KYB verification mandatoryAll platforms are required to integrate Mangopay’s hosted KYC/KYB experience, relying on the POST Create an IDV Session endpoint.
Mangopay’s hosted KYC/KYB solution is becoming mandatory for all platforms. Hosted KYC/KYB streamlines the verification process for your platform by providing a secure pre-built web experience. On the HostedUrl returned by one API call, POST Create an IDV Session:
  • Natural Users can complete a liveness check – taking photos of themselves and their ID proof, which is handled via a QR code if opened on desktop
  • Legal Users can provide business information, declare beneficial owners, and then pass the URL to the declared legal representative for the liveness check
Mangopay is delivering improvements in the short term:
  • Pre-population of Legal User data from the Legal User API object
  • Customization using your platform’s trading name, logo, and colors

​
Legacy solution

Mangopay’s legacy solution remains available during the transition to hosted IDV. The KYC Document and UBO Declaration endpoints continue to be supported for existing integrations. In the eventuality that Mangopay requests additional documents, these cannot yet be submitted via the hosted IDV solution. In this case, your platform needs to be able to allow the user to transfer the documents to Mangopay via the legacy endpoint. Read more about submitting additional documents →

​
Experience

​
Available languages

The default session language is English. On the welcome screen, the user can change this to one of the other available options: Dutch, French, German, Italian, Lithuanian, Polish, Portuguese, Romanian, Spanish. There is no way to change the language used as the default language. When the QR code is scanned (see below), the mobile experience to take photos inherits the language of the session.

​
Session autosave and validity

The hosted KYC/KYB session autosaves the progress made by the user on each screen. The session expires after 24 hours, regardless of whether the user has started it or not. Therefore, the session URL can be closed and re-opened before submission – this may be necessary for Business and Organization flows where a registered director must be the one who performs the liveness check (on the same link).

​
QR code on desktop

For steps that require the user to take a photo, if the URL is opened on a desktop browser then a QR code is presented on screen which the user must scan to open the session on their smartphone or tablet. Once scanned, the photo-taking progress is tracked on screen. The experience attempts to automatically recognize the document or face in the screen and takes the photo. If this is unsuccessful, then the user can take a photo manually and choose to submit or retry.
Note – Mobile session attempts ID check automaticallyIf the session is open on a phone, the user is invited to take photos of their ID and a selfie, even if they are not the declared legal representative or listed as a director on the national registry.

​
Accepted documents

All documents submitted during the session must be those accepted by Mangopay. For the liveness check, the identity document must be one of those listed by country of issue in the accepted ID page. For Registration Proof and Articles of Association, the accepted documents depend on the legal status and country of registration or incorporation and are listed in the KYB local page.
Note – Session doesn’t prevent incorrect uploadsOn the welcome screen, the session notes that the ID document used must correspond to one of those accepted by Mangopay and provides a link to the full list. However, the session supports types of ID that are not accepted by Mangopay.

​
Persons of significant control (PSC)

For Business users, the individuals declared during the session as PSCs must be beneficial owners as defined by Mangopay here. PSC data entered by the user during a session is not made available to the platform directly. The legacy UBO Declaration feature of the API does not have an equivalent in the hosted solution: everything is submitted by the user directly in the session.