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
USER_INFLOWS_BLOCKED |
The User has been blocked by Mangopay and can no longer make pay-ins or send or receive transfers. |
USER_INFLOWS_UNBLOCKED |
The User has been unblocked by Mangopay and can now make pay-ins or send or receive transfers. |
USER_OUTFLOWS_BLOCKED |
The User has been blocked by Mangopay and can no longer make payouts or send or receive transfers. |
USER_OUTFLOWS_UNBLOCKED |
The User has been unblocked by Mangopay and can now make payouts or send or receive transfers. |
Mangopay SCA on Owners
USER_ACCOUNT_VALIDATION_ASKED |
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 . |
USER_ACCOUNT_ACTIVATED |
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
USER_KYC_LIGHT |
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 . |
USER_KYC_REGULAR |
The User has been KYC/KYB verified by Mangopay. The User’s KYCLevel has changed from LIGHT to REGULAR . |
LEGAL_COMPANY_NUMBER_VALIDATION_FAILED |
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. |
LEGAL_COMPANY_NUMBER_VALIDATION_SUCCEEDED |
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
KYC_CREATED |
The KYC Document has been created but not yet submitted for review. |
KYC_VALIDATION_ASKED |
The KYC Document has been submitted for validation and is being processed. |
KYC_SUCCEEDED |
The KYC Document has been validated by Mangopay. |
KYC_FAILED |
The KYC Document has been refused by Mangopay. |
KYC_OUTDATED |
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
UBO_DECLARATION_CREATED |
The UBO Declaration has been created but not yet submitted for review. |
UBO_DECLARATION_VALIDATION_ASKED |
The UBO Declaration has been submitted for validation and is being processed. |
UBO_DECLARATION_VALIDATED |
The UBO Declaration has been validated by the Mangopay Compliance team. |
UBO_DECLARATION_INCOMPLETE |
The UBO Declaration is incomplete and additional information or documents may be required. |
UBO_DECLARATION_REFUSED |
The UBO Declaration has been refused by Mangopay. |
Pay-ins
All payment methods
PAYIN_NORMAL_CREATED |
The PayIn transaction has been created but is not yet processed. |
PAYIN_NORMAL_SUCCEEDED |
The PayIn transaction has been successfully processed. |
PAYIN_NORMAL_FAILED |
The PayIn transaction has failed. |
Card payments
Card validations
CARD_VALIDATION_CREATED |
The Card Validation object has been created and the card is pending validation. |
CARD_VALIDATION_FAILED |
The Card Validation has failed, setting the corresponding card as invalid. |
CARD_VALIDATION_SUCCEEDED |
The Card Validation has succeeded, setting the corresponding card as valid. |
Recurring pay-in registrations
RECURRING_REGISTRATION_CREATED |
The Recurring Registration object has been successfully created. |
RECURRING_REGISTRATION_AUTH_NEEDED |
A pay-in against this recurring object requires authentication. |
RECURRING_REGISTRATION_IN_PROGRESS |
The Recurring Registration object is in a valid state. Pay-ins against this recurring registration are possible. |
RECURRING_REGISTRATION_ENDED |
The Recurring Registration object has been ended. It is no longer possible to make pay-ins against this recurring registration. |
Preauthorizations
PREAUTHORIZATION_CREATED |
The Preauthorization object has been successfully created. |
PREAUTHORIZATION_FAILED |
The authorization of this Preauthorization has failed. |
PREAUTHORIZATION_PAYMENT_CANCELED |
The authorization of this Preauthorization has been canceled. |
PREAUTHORIZATION_PAYMENT_EXPIRED |
The authorization of this Preauthorization has expired. |
PREAUTHORIZATION_PAYMENT_VALIDATED |
The Preauthorization has been successfully debited. |
PREAUTHORIZATION_PAYMENT_WAITING |
The Preauthorization object can now be debited. |
PREAUTHORIZATION_SUCCEEDED |
The authorization of this Preauthorization has been successful. |
Deposit preauthorizations
DEPOSIT_PREAUTHORIZATION_CREATED |
The Deposit Preauthorization object has been successfully created. |
DEPOSIT_PREAUTHORIZATION_FAILED |
The authorization of the Deposit Preauthorization has failed. |
DEPOSIT_PREAUTHORIZATION_PAYMENT_CANCEL_REQUESTED |
The request to cancel the Deposit Preauthorization has been taken into account. |
DEPOSIT_PREAUTHORIZATION_PAYMENT_CANCELED |
The Deposit Preauthorization has been successfully canceled. |
DEPOSIT_PREAUTHORIZATION_PAYMENT_EXPIRED |
The authorization of the Deposit Preauthorization has expired. |
DEPOSIT_PREAUTHORIZATION_PAYMENT_FAILED |
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. |
DEPOSIT_PREAUTHORIZATION_PAYMENT_NO_SHOW |
The Deposit Preauthorization wasn’t debited and a no-show has been successfully declared. A pay-in complement can be made. |
DEPOSIT_PREAUTHORIZATION_PAYMENT_NO_SHOW_REQUESTED |
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. |
DEPOSIT_PREAUTHORIZATION_PAYMENT_TO_BE_COMPLETED |
The Deposit Preauthorization was successfully debited (a successful pay-in against the preauthorization was made). A pay-in complement can be made. |
DEPOSIT_PREAUTHORIZATION_PAYMENT_VALIDATED |
The Deposit Preauthorization has been successfully debited (a successful pay-in against the preauthorization has been made). No further pay-ins can be made. |
DEPOSIT_PREAUTHORIZATION_PAYMENT_WAITING |
The authorization of the Deposit Preauthorization has been successful. It can now be debited. |
Banking payments
Pay by bank
PAYIN_NORMAL_PROCESSING_STATUS_PENDING_SUCCEEDED |
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 . |
Virtual accounts
VIRTUAL_ACCOUNT_ACTIVE |
The account is active and can receive funds (see note about delayed UK CoP recognition for GB accounts). |
VIRTUAL_ACCOUNT_BLOCKED |
The account is blocked and is not active. Any funds sent to the account are returned. This temporary status may be used during processes relating to user verification or fraud screening. |
VIRTUAL_ACCOUNT_CLOSED |
The account has been deactivated and is closed. Any funds sent to the account are returned. This is a final state. |
VIRTUAL_ACCOUNT_FAILED |
The account creation request failed or was rejected. This final state is rare. Any funds sent to the account are returned (if account details exist). |
Direct debit mandates
MANDATE_ACTIVATED |
The Mandate request has been successfully created and validated. A bank wire can be initiated. |
MANDATE_EXPIRED |
The Mandate has expired. It is no longer possible to make bank wire pay-ins against this mandate. |
MANDATE_FAILED |
The Mandate request has failed. |
MANDATE_SUBMITTED |
The Mandate has been successfully validated, an email has been sent to the end user (if emails are configured). |
Transfers
TRANSFER_NORMAL_CREATED |
The Transfer has been created but is not yet processed. |
TRANSFER_NORMAL_FAILED |
The Transfer could not be processed. |
TRANSFER_NORMAL_SUCCEEDED |
The Transfer has been successfully processed. |
Refunds
Pay-in refunds
PAYIN_REFUND_CREATED |
The PayIn Refund transaction has been created but is not yet processed. |
PAYIN_REFUND_FAILED |
The PayIn Refund transaction could not be processed. |
PAYIN_REFUND_SUCCEEDED |
The PayIn Refund transaction has been successfully processed. |
Transfer refunds
TRANSFER_REFUND_CREATED |
The Transfer Refund has been created but is not yet processed. |
TRANSFER_REFUND_FAILED |
The Transfer Refund transaction could not be processed. |
TRANSFER_REFUND_SUCCEEDED |
The Transfer Refund transaction has been successfully processed. |
Payout returns
PAYOUT_REFUND_CREATED |
The payout return has been created. |
PAYOUT_REFUND_FAILED |
The payout return has failed. |
PAYOUT_REFUND_SUCCEEDED |
The payout return has been successfully processed. |
Disputes
Disputes
DISPUTE_CREATED |
The Dispute has been created. It can either be closed directly or reviewed by the platform. |
DISPUTE_ACTION_REQUIRED |
The contestable Dispute requires further action. The platform is notified by Mangopay in a short period of time. |
DISPUTE_SUBMITTED |
The Dispute has been contested by the platform, either entirely or partially. |
DISPUTE_SENT_TO_BANK |
The Dispute has been sent to the bank for review and approval following the Dispute Documents validation. |
DISPUTE_FURTHER_ACTION_REQUIRED |
To settle the Dispute, additional documents are required. |
DISPUTE_CLOSED |
The Dispute has been closed. It can either be WON or LOST by the platform. |
Dispute documents
DISPUTE_DOCUMENT_CREATED |
The Dispute Document has been successfully added to the Dispute, either by the platform or Mangopay’s team. |
DISPUTE_DOCUMENT_FAILED |
The Dispute Document has been refused by Mangopay’s team. |
DISPUTE_DOCUMENT_SUCCEEDED |
The Dispute Document has been validated by Mangopay’s team. |
DISPUTE_DOCUMENT_VALIDATION_ASKED |
The Dispute Document has been sent to Mangopay’s team for validation. |
Repudiations
PAYIN_REPUDIATION_CREATED |
A chargeback has been filed and has been created in Mangopay’s environment (Repudiation Wallet). |
PAYIN_REPUDIATION_FAILED |
A chargeback has been filed but the transaction from the Repudiation Wallet back to the initial pay-in author has failed. |
PAYIN_REPUDIATION_SUCCEEDED |
A chargeback has been filed and successfully sent back to the initial pay-in author. |
Settlement transfers
TRANSFER_SETTLEMENT_CREATED |
The Settlement Transfer has been created but is not yet processed. |
TRANSFER_SETTLEMENT_FAILED |
The Settlement Transfer could not be processed. |
TRANSFER_SETTLEMENT_SUCCEEDED |
The Settlement Transfer has been successfully processed. |
Recipients
RECIPIENT_ACTIVE |
The Recipient was created successfully, including the SCA session if RecipientScope is OWNER , and it can now be used for payments. |
RECIPIENT_CANCELED |
The Recipient creation was unsuccessful because the SCA session was not successful. The CANCELED status is only relevant if RecipientScope is OWNER . |
RECIPIENT_DEACTIVATED |
The Recipient was permanently deactivated and can no longer be used. |
Payouts
Standard payouts
PAYOUT_NORMAL_CREATED |
The Payout transaction has been created but is not yet processed. |
PAYOUT_NORMAL_FAILED |
The Payout transaction has failed. |
PAYOUT_NORMAL_SUCCEEDED |
The Payout transaction has been successfully processed. |
Instant payouts
INSTANT_PAYOUT_FAILED |
The Instant Payout transaction has failed. |
INSTANT_PAYOUT_FALLBACKED |
The Payout could not be processed instantly; it will be processed in 48 hours as a standard payout instead. |
INSTANT_PAYOUT_SUCCEEDED |
The Instant Payout transaction has been successfully processed. |
Helpers
Country authorizations
COUNTRY_AUTHORIZATION_UPDATED |
The restrictions related to a country have been updated. |