API - June 23, 2026 | Mangopay docs

Added

Webhook event types for user KYC/KYB renewal

Note – Feature being rolled out during 2026

Mangopay’s continuous KYC/KYB verification feature is being rolled out during 2026.

The webhook event types below can already be set up via the API or the Mangopay Dashboard. Notifications will start being sent before August 31st, 2026, and the first renewal-related downgrades are scheduled for December 1st, 2026.

Read more about the forthcoming features and rollout for KYC/KYB renewal →

To support Mangopay’s forthcoming continuous KYC/KYB verification feature, two new webhooks event types are available.

Event type USER_KYC_RENEWAL_REQUIRED

Description

Event type	`USER_KYC_RENEWAL_REQUIRED`
Description	The User’s `KycRenewalDeadline` is in 90 days. If the KYC/KYB verification process is not successfully completed before the end of this date (UTC), then the User’s `KYCLevel` will be downgraded to `LIGHT` the following day. As a result, the User will be subject to the same KYC/KYB limits as an unverified user. For platforms in the EEA, this means they will be unable to request payouts.

The User’s KycRenewalDeadline is in 90 days.

If the KYC/KYB verification process is not successfully completed before the end of this date (UTC), then the User’s KYCLevel will be downgraded to LIGHT the following day.

As a result, the User will be subject to the same KYC/KYB limits as an unverified user. For platforms in the EEA, this means they will be unable to request payouts.

Event type USER_KYC_RENEWED

Description

Event type	`USER_KYC_RENEWED`
Description	The User has successfully completed the KYC/KYB verification process and a new `KycRenewalDeadline` has been set. The User’s `KYCLevel` has not changed and remains `REGULAR`.

The User has successfully completed the KYC/KYB verification process and a new KycRenewalDeadline has been set.

The User’s KYCLevel has not changed and remains REGULAR.

The RessourceId on both webhooks is the UserId.

Once you receive a notification, you will be able to call the GET View a User’s regulatory status endpoint to retrieve the KycRenewalDeadline.

Recurring payment support for Apple Pay and Google Pay

Platforms can now offer recurring payments with Apple Pay and Google Pay.

The feature relies on the existing POST Create a Recurring PayIn Registration endpoint, which now supports new PaymentType values – APPLEPAY and GOOGLE_PAY – as well as accepting the PaymentData retrieved from the payment method’s API.

Once in place, the RecurringPayinRegistrationId enables you to request CIT and MIT payments with the new endpoints: