This page lists the event types for which Mangopay can send webhook notifications.

The event types are listed by feature for each RessourceId on which they occur. Alongside is the GET API call you can use to confirm the event is still valid and retrieve more details, as well as the related guide pages.

To listen to an event type on your chosen URL, set up a webhook in the Mangopay Dashboard (Developers > Webhooks) or using the POST Create a Hook endpoint.

Learn more about webhooks

User management

User regulatory status

ResourceUserId
Related GETGET View a User’s regulatory status
Related guideBlocked users
Event typeUSER_INFLOWS_BLOCKED
Description

The User has been blocked by Mangopay and can no longer make pay-ins or send or receive transfers.

Event typeUSER_INFLOWS_UNBLOCKED
Description

The User has been unblocked by Mangopay and can now make pay-ins or send or receive transfers.

Event typeUSER_OUTFLOWS_BLOCKED
Description

The User has been blocked by Mangopay and can no longer make payouts or send or receive transfers.

Event typeUSER_OUTFLOWS_UNBLOCKED
Description

The User has been unblocked by Mangopay and can now make payouts or send or receive transfers.

Mangopay SCA on Owners

ResourceUserId
Related GETGET View a User (SCA)
Related guidesSCA
Event typeUSER_ACCOUNT_VALIDATION_ASKED
Description

The Owner User has triggered SCA enrollment or re-enrollment. Their access to Mangopay features is restricted until they enroll successfully.

The User’s UserStatus has changed to PENDING_USER_ACTION. This event is only triggered if UserCategory is OWNER.

Event typeUSER_ACCOUNT_ACTIVATED
Description

The Owner User has been successfully enrolled in SCA. They can now access Mangopay features.

The User’s UserStatus has changed from PENDING_USER_ACTION to ACTIVE. This event is only triggered if UserCategory is OWNER.

User KYC status

ResourceUserId
Related GETGET View a User (SCA)
Related guidesUser KYC/KYB verification
Event typeUSER_KYC_LIGHT
Description

The User is not KYC/KYB verified by Mangopay and is therefore subject to KYC/KYB verification limits.

The User’s KYCLevel has changed from REGULAR to LIGHT.

Event typeUSER_KYC_REGULAR
Description

The User has been KYC/KYB verified by Mangopay.

The User’s KYCLevel has changed from LIGHT to REGULAR.

User data format

ResourceUserId
Related GETGET View a User (SCA)
Related guidesCompany number
Event typeLEGAL_COMPANY_NUMBER_VALIDATION_FAILED
Description

The format of the company number is not valid for the headquarters address country of the Business-type Legal User. A invalid format blocks verification.

Event typeLEGAL_COMPANY_NUMBER_VALIDATION_SUCCEEDED
Description

The format of the company number is valid for the headquarters address country of the Business-type Legal User. The format is as expected for the country of registration but the veracity of the data has not yet been verified.

KYC documents

ResourceKYCDocumentId
Related GETGET View a KYC Document
Related guidesSubmitting KYC documents
Event typeKYC_CREATED
Description

The KYC Document has been created but not yet submitted for review.

Event typeKYC_VALIDATION_ASKED
Description

The KYC Document has been submitted for validation and is being processed.

Event typeKYC_SUCCEEDED
Description

The KYC Document has been validated by Mangopay.

Event typeKYC_FAILED
Description

The KYC Document has been refused by Mangopay.

Event typeKYC_OUTDATED
Description

The KYC Document is no longer valid. This is due to an amendment of the user’s identity or other key details as per the KYC/KYB verification downgrade.

UBO declarations

ResourceUboDeclarationId
Related GETGET View a UBO Declaration
Related guidesBeneficial owners
Event typeUBO_DECLARATION_CREATED
Description

The UBO Declaration has been created but not yet submitted for review.

Event typeUBO_DECLARATION_VALIDATION_ASKED
Description

The UBO Declaration has been submitted for validation and is being processed.

Event typeUBO_DECLARATION_VALIDATED
Description

The UBO Declaration has been validated by the Mangopay Compliance team.

Event typeUBO_DECLARATION_INCOMPLETE
Description

The UBO Declaration is incomplete and additional information or documents may be required.

Event typeUBO_DECLARATION_REFUSED
Description

The UBO Declaration has been refused by Mangopay.

Pay-ins

All payment methods

ResourcePayInId
Related GETGET View a PayIn (Direct Card) for example – same endpoint for all payment methods, different response object
Related guidesAll payment methods
Event typePAYIN_NORMAL_CREATED
Description

The PayIn transaction has been created but is not yet processed.

Event typePAYIN_NORMAL_SUCCEEDED
Description

The PayIn transaction has been successfully processed.

Event typePAYIN_NORMAL_FAILED
Description

The PayIn transaction has failed.

Card payments

Card validations

ResourceCardValidationId
Related GETGET View a Card Validation
Related guidesCard validation without debit
Event typeCARD_VALIDATION_CREATED
Description

The Card Validation object has been created and the card is pending validation.

Event typeCARD_VALIDATION_FAILED
Description

The Card Validation has failed, setting the corresponding card as invalid.

Event typeCARD_VALIDATION_SUCCEEDED
Description

The Card Validation has succeeded, setting the corresponding card as valid.

Recurring pay-in registrations

ResourceRecurringRegistrationId
Related GETGET View a Recurring PayIn Registration
Related guidesRecurring card payments
Event typeRECURRING_REGISTRATION_CREATED
Description

The Recurring Registration object has been successfully created.

Event typeRECURRING_REGISTRATION_AUTH_NEEDED
Description

A pay-in against this recurring object requires authentication.

Event typeRECURRING_REGISTRATION_IN_PROGRESS
Description

The Recurring Registration object is in a valid state. Pay-ins against this recurring registration are possible.

Event typeRECURRING_REGISTRATION_ENDED
Description

The Recurring Registration object has been ended. It is no longer possible to make pay-ins against this recurring registration.

Preauthorizations

ResourcePreauthorizationId
Related GETGET View a Preauthorization
Related guides7-day preauthorization
Event typePREAUTHORIZATION_CREATED
Description

The Preauthorization object has been successfully created.

Event typePREAUTHORIZATION_FAILED
Description

The authorization of this Preauthorization has failed.

Event typePREAUTHORIZATION_PAYMENT_CANCELED
Description

The authorization of this Preauthorization has been canceled.

Event typePREAUTHORIZATION_PAYMENT_EXPIRED
Description

The authorization of this Preauthorization has expired.

Event typePREAUTHORIZATION_PAYMENT_VALIDATED
Description

The Preauthorization has been successfully debited.

Event typePREAUTHORIZATION_PAYMENT_WAITING
Description

The Preauthorization object can now be debited.

Event typePREAUTHORIZATION_SUCCEEDED
Description

The authorization of this Preauthorization has been successful.

Deposit preauthorizations

ResourceDepositId
Related GETGET View a Deposit Preauthorization
Related guides30-day deposit preauthorization
Event typeDEPOSIT_PREAUTHORIZATION_CREATED
Description

The Deposit Preauthorization object has been successfully created.

Event typeDEPOSIT_PREAUTHORIZATION_FAILED
Description

The authorization of the Deposit Preauthorization has failed.

Event typeDEPOSIT_PREAUTHORIZATION_PAYMENT_CANCEL_REQUESTED
Description

The request to cancel the Deposit Preauthorization has been taken into account.

Event typeDEPOSIT_PREAUTHORIZATION_PAYMENT_CANCELED
Description

The Deposit Preauthorization has been successfully canceled.

Event typeDEPOSIT_PREAUTHORIZATION_PAYMENT_EXPIRED
Description

The authorization of the Deposit Preauthorization has expired.

Event typeDEPOSIT_PREAUTHORIZATION_PAYMENT_FAILED
Description

The payment action against the Deposit Preauthorization has failed, whether capture without complement, capture prior to complement, no-show request, or complement. A retry may be possible.

Event typeDEPOSIT_PREAUTHORIZATION_PAYMENT_NO_SHOW
Description

The Deposit Preauthorization wasn’t debited and a no-show has been successfully declared. A pay-in complement can be made.

Event typeDEPOSIT_PREAUTHORIZATION_PAYMENT_NO_SHOW_REQUESTED
Description

The Deposit Preauthorization wasn’t debited and a request for a no-show has been taken into account. A pay-in complement cannot yet be made.

Event typeDEPOSIT_PREAUTHORIZATION_PAYMENT_TO_BE_COMPLETED
Description

The Deposit Preauthorization was successfully debited (a successful pay-in against the preauthorization was made). A pay-in complement can be made.

Event typeDEPOSIT_PREAUTHORIZATION_PAYMENT_VALIDATED
Description

The Deposit Preauthorization has been successfully debited (a successful pay-in against the preauthorization has been made). No further pay-ins can be made.

Event typeDEPOSIT_PREAUTHORIZATION_PAYMENT_WAITING
Description

The authorization of the Deposit Preauthorization has been successful. It can now be debited.

Banking payments

Pay by bank

ResourcePayInId
Related GETGET View a PayIn (Pay by Bank)
Related guidesPay by Bank
Event typePAYIN_NORMAL_PROCESSING_STATUS_PENDING_SUCCEEDED
Description

The Pay by Bank PayIn has been successfully initiated by the user. The funds have not yet arrived on Mangopay’s bank account and the pay-in Status is still CREATED.

Direct debit mandates

ResourceMandateId
Related GETGET View a Mandate
Related guidesDirect debit mandates
Event typeMANDATE_ACTIVATED
Description

The Mandate request has been successfully created and validated. A bank wire can be initiated.

Event typeMANDATE_EXPIRED
Description

The Mandate has expired. It is no longer possible to make bank wire pay-ins against this mandate.

Event typeMANDATE_FAILED
Description

The Mandate request has failed.

Event typeMANDATE_SUBMITTED
Description

The Mandate has been successfully validated, an email has been sent to the end user (if emails are configured).

Transfers

ResourceTransferId
Related GETGET View a Transfer
Related guides
Event typeTRANSFER_NORMAL_CREATED
Description

The Transfer has been created but is not yet processed.

Event typeTRANSFER_NORMAL_FAILED
Description

The Transfer could not be processed.

Event typeTRANSFER_NORMAL_SUCCEEDED
Description

The Transfer has been successfully processed.

Refunds

Pay-in refunds

ResourceRefundId
Related GETGET View a Refund
Related guidesRefunds - Pay-in
Event typePAYIN_REFUND_CREATED
Description

The PayIn Refund transaction has been created but is not yet processed.

Event typePAYIN_REFUND_FAILED
Description

The PayIn Refund transaction could not be processed.

Event typePAYIN_REFUND_SUCCEEDED
Description

The PayIn Refund transaction has been successfully processed.

Transfer refunds

ResourceRefundId
Related GETGET View a Refund
Related guidesRefunds - Transfer
Event typeTRANSFER_REFUND_CREATED
Description

The Transfer Refund has been created but is not yet processed.

Event typeTRANSFER_REFUND_FAILED
Description

The Transfer Refund transaction could not be processed.

Event typeTRANSFER_REFUND_SUCCEEDED
Description

The Transfer Refund transaction has been successfully processed.

Payout returns

ResourceRefundId
Related GETGET View a Refund
Related guidesPayouts - Returns
Event typePAYOUT_REFUND_CREATED
Description

The payout return has been created.

Event typePAYOUT_REFUND_FAILED
Description

The payout return has failed.

Event typePAYOUT_REFUND_SUCCEEDED
Description

The payout return has been successfully processed.

Disputes

Disputes

ResourceDisputeId
Related GETGET View a Dispute
Related guidesDisputes
Event typeDISPUTE_CREATED
Description

The Dispute has been created. It can either be closed directly or reviewed by the platform.

Event typeDISPUTE_ACTION_REQUIRED
Description

The contestable Dispute requires further action. The platform is notified by Mangopay in a short period of time.

Event typeDISPUTE_SUBMITTED
Description

The Dispute has been contested by the platform, either entirely or partially.

Event typeDISPUTE_SENT_TO_BANK
Description

The Dispute has been sent to the bank for review and approval following the Dispute Documents validation.

Event typeDISPUTE_FURTHER_ACTION_REQUIRED
Description

To settle the Dispute, additional documents are required.

Event typeDISPUTE_CLOSED
Description

The Dispute has been closed. It can either be WON or LOST by the platform.

Dispute documents

ResourceDisputeDocumentId
Related GETGET View a Dispute Document
Related guidesDisputes
Event typeDISPUTE_DOCUMENT_CREATED
Description

The Dispute Document has been successfully added to the Dispute, either by the platform or Mangopay’s team.

Event typeDISPUTE_DOCUMENT_FAILED
Description

The Dispute Document has been refused by Mangopay’s team.

Event typeDISPUTE_DOCUMENT_SUCCEEDED
Description

The Dispute Document has been validated by Mangopay’s team.

Event typeDISPUTE_DOCUMENT_VALIDATION_ASKED
Description

The Dispute Document has been sent to Mangopay’s team for validation.

Repudiations

ResourceRepudiationId
Related GETGET View a Repudiation
Related guidesDisputes
Event typePAYIN_REPUDIATION_CREATED
Description

A chargeback has been filed and has been created in Mangopay’s environment (Repudiation Wallet).

Event typePAYIN_REPUDIATION_FAILED
Description

A chargeback has been filed but the transaction from the Repudiation Wallet back to the initial pay-in author has failed.

Event typePAYIN_REPUDIATION_SUCCEEDED
Description

A chargeback has been filed and successfully sent back to the initial pay-in author.

Settlement transfers

ResourceSettlementId
Related GETGET View a Settlement Transfer
Related guidesDisputes
Event typeTRANSFER_SETTLEMENT_CREATED
Description

The Settlement Transfer has been created but is not yet processed.

Event typeTRANSFER_SETTLEMENT_FAILED
Description

The Settlement Transfer could not be processed.

Event typeTRANSFER_SETTLEMENT_SUCCEEDED
Description

The Settlement Transfer has been successfully processed.

Recipients

ResourceRecipientId
Related GETGET View a Recipient
Related guidesRecipients
Event typeRECIPIENT_ACTIVE
Description

The Recipient was created successfully, including the SCA session if RecipientScope is OWNER, and it can now be used for payments.

Event typeRECIPIENT_CANCELED
Description

The Recipient creation was unsuccessful because the SCA session was not successful. The CANCELED status is only relevant if RecipientScope is OWNER.

Event typeRECIPIENT_DEACTIVATED
Description

The Recipient was permanently deactivated and can no longer be used.

Payouts

Standard payouts

ResourcePayoutId
Related GETGET View a Payout
Related guidesPayouts
Event typePAYOUT_NORMAL_CREATED
Description

The Payout transaction has been created but is not yet processed.

Event typePAYOUT_NORMAL_FAILED
Description

The Payout transaction has failed.

Event typePAYOUT_NORMAL_SUCCEEDED
Description

The Payout transaction has been successfully processed.

Instant payouts

ResourcePayoutId
Related GETGET View a Payout and check mode applied
Related guidesInstant payouts
Event typeINSTANT_PAYOUT_FAILED
Description

The Instant Payout transaction has failed.

Event typeINSTANT_PAYOUT_FALLBACKED
Description

The Payout could not be processed instantly; it will be processed in 48 hours as a standard payout instead.

Event typeINSTANT_PAYOUT_SUCCEEDED
Description

The Instant Payout transaction has been successfully processed.

Helpers

Country authorizations

ResourceCountryCode
Related GETGET View authorizations for a country
Related guidesCountry restrictions
Event typeCOUNTRY_AUTHORIZATION_UPDATED
Description

The restrictions related to a country have been updated.