API - May 13, 2025
Hosted KYC/KYB verification solution
Mangopay’s new hosted KYC/KYB verification solution is generally available for all platforms (previously in beta).
Thanks to the Mangopay-hosted web session, end users can complete all the necessary steps for their KYC/KYB verification in one smooth experience.
For Natural users, the solution guides them through a live photo ID check. For Soletrader and Business users, the solution uses business data to perform a lookup in the relevant national registry, helping streamline the process. Read more in the dedicated guide:
Guide
Learn about Mangopay’s hosted KYC/KYB solution
Note – Activation required
To activate the hosted KYC/KYB verification feature for your platform, get in touch via the Dashboard.
The following endpoints have been added, which enable your platform to initiate and manage hosted sessions:
POST Create an IDV Session
Initiate a hosted KYC/KYB session and get the unique link for the frontend experience
GET View an IDV Session
See details of a hosted KYC/KYB session, outcome of checks, and verified data
GET List IDV Session for a User
Retrieve key details of all hosted KYC/KYC sessions attempted for a user
The following webhooks event types have been added:
IDENTITY_VERIFICATION_VALIDATED
– The IDV Session’sStatus
changed toVALIDATED
and the User became KYC/KYB verified.IDENTITY_VERIFICATION_FAILED
– The IDV Session’sStatus
changed toREFUSED
and the User was not KYC/KYB verified.IDENTITY_VERIFICATION_INCONCLUSIVE
– The IDV Session’sStatus
changed toREVIEW
and the session is under manual review by Mangopay’s teams before an outcome can be given.IDENTITY_VERIFICATION_OUTDATED
– The IDV Session’sStatus
changed toOUTDATED
indicating that the user’s KYC/KYB verification status was downgraded. To regain KYC/KYB verified status, the user must complete a new IDV Session successfully.