Getting startedRelease notes

API - May 13, 2025

Added

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’s Status changed to VALIDATED and the User became KYC/KYB verified.
  • IDENTITY_VERIFICATION_FAILED – The IDV Session’s Status changed to REFUSED and the User was not KYC/KYB verified.
  • IDENTITY_VERIFICATION_INCONCLUSIVE – The IDV Session’s Status changed to REVIEW and the session is under manual review by Mangopay’s teams before an outcome can be given.
  • IDENTITY_VERIFICATION_OUTDATED – The IDV Session’s Status changed to OUTDATED 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.