This page lists the event types for which you use the POST Create a Hook endpoint to be notified at your chosen URL.

Learn more about webhooks

User management

User regulatory status

USER_INFLOWS_BLOCKED

RessourceId : UserId

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

USER_INFLOWS_UNBLOCKED

RessourceId : UserId

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

USER_OUTFLOWS_BLOCKED

RessourceId : UserId

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

USER_OUTFLOWS_UNBLOCKED

RessourceId : UserId

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

User KYC status

USER_KYC_LIGHT

RessourceId : UserId

The User is not verified by Mangopay and is, therefore, subject to Anti-Money Laundering limits.

USER_KYC_REGULAR

RessourceId : UserId

The User has been verified by the Mangopay Compliance team.

User data format

LEGAL_COMPANY_NUMBER_VALIDATION_FAILED

RessourceId : UserId

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

RessourceId : UserId

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

RessourceId : KYCDocumentId

The KYC Document has been created.

KYC_FAILED

RessourceId : KYCDocumentId

The KYC Document has been refused by the Mangopay Compliance team.

KYC_OUTDATED

RessourceId : KYCDocumentId

The KYC Document is no longer valid. This is due to an amendment of the user’s identity.

KYC_SUCCEEDED

RessourceId : KYCDocumentId

The KYC Document has been validated by the Mangopay Compliance team.

KYC_VALIDATION_ASKED

RessourceId : KYCDocumentId

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

UBO declarations

UBO_DECLARATION_CREATED

RessourceId : UboDeclarationId

The UBO Declaration has been created.

UBO_DECLARATION_INCOMPLETE

RessourceId : UboDeclarationId

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

UBO_DECLARATION_REFUSED

RessourceId : UboDeclarationId

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

UBO_DECLARATION_VALIDATED

RessourceId : UboDeclarationId

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

UBO_DECLARATION_VALIDATION_ASKED

RessourceId : UboDeclarationId

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

Pay-ins

All payment methods

PAYIN_NORMAL_CREATED

RessourceId : PayInId

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

PAYIN_NORMAL_FAILED

RessourceId : PayInId

The PayIn transaction has failed.

PAYIN_NORMAL_SUCCEEDED

RessourceId : PayInId

The PayIn transaction has been successfully processed.

Card payments

Card validations

CARD_VALIDATION_CREATED

RessourceId : CardValidationId

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

CARD_VALIDATION_FAILED

RessourceId : CardValidationId

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

CARD_VALIDATION_SUCCEEDED

RessourceId : CardValidationId

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

Recurring pay-in registrations

RECURRING_REGISTRATION_AUTH_NEEDED

RessourceId : RecurringRegistrationId

A pay-in against this recurring object requires authentication.

RECURRING_REGISTRATION_CREATED

RessourceId : RecurringRegistrationId

The Recurring Registration object has been successfully created.

RECURRING_REGISTRATION_ENDED

RessourceId : RecurringRegistrationId

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

RECURRING_REGISTRATION_IN_PROGRESS

RessourceId : RecurringRegistrationId

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

Preauthorizations

PREAUTHORIZATION_CREATED

RessourceId : PreauthorizationId

The Preauthorization object has been successfully created.

PREAUTHORIZATION_FAILED

RessourceId : PreauthorizationId

The authorization of this Preauthorization has failed.

PREAUTHORIZATION_PAYMENT_CANCELED

RessourceId : PreauthorizationId

The authorization of this Preauthorization has been canceled.

PREAUTHORIZATION_PAYMENT_EXPIRED

RessourceId : PreauthorizationId

The authorization of this Preauthorization has expired.

PREAUTHORIZATION_PAYMENT_VALIDATED

RessourceId : PreauthorizationId

The Preauthorization has been successfully debited.

PREAUTHORIZATION_PAYMENT_WAITING

RessourceId : PreauthorizationId

The Preauthorization object can now be debited.

PREAUTHORIZATION_SUCCEEDED

RessourceId : PreauthorizationId

The authorization of this Preauthorization has been successful.

Deposit preauthorizations

DEPOSIT_PREAUTHORIZATION_CREATED

RessourceId : DepositId

The Deposit Preauthorization object has been successfully created.

DEPOSIT_PREAUTHORIZATION_FAILED

RessourceId : DepositId

The authorization of the Deposit Preauthorization has failed.

DEPOSIT_PREAUTHORIZATION_PAYMENT_CANCEL_REQUESTED

RessourceId : DepositId

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

DEPOSIT_PREAUTHORIZATION_PAYMENT_CANCELED

RessourceId : DepositId

The Deposit Preauthorization has been successfully canceled.

DEPOSIT_PREAUTHORIZATION_PAYMENT_EXPIRED

RessourceId : DepositId

The authorization of the Deposit Preauthorization has expired.

DEPOSIT_PREAUTHORIZATION_PAYMENT_FAILED

RessourceId : DepositId

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

RessourceId : DepositId

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

RessourceId : DepositId

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

RessourceId : DepositId

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

RessourceId : DepositId

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

RessourceId : DepositId

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

Banking payments

Direct debit mandates

MANDATE_ACTIVATED

RessourceId : MandateId

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

MANDATE_EXPIRED

RessourceId : MandateId

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

MANDATE_FAILED

RessourceId : MandateId

The Mandate request has failed.

MANDATE_SUBMITTED

RessourceId : MandateId

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

Transfers

TRANSFER_NORMAL_CREATED

RessourceId : TransferId

The Transfer has been created but is not yet processed.

TRANSFER_NORMAL_FAILED

RessourceId : TransferId

The Transfer could not be processed.

TRANSFER_NORMAL_SUCCEEDED

RessourceId : TransferId

The Transfer has been successfully processed.

Refunds

Pay-in refunds

PAYIN_REFUND_CREATED

RessourceId : RefundId

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

PAYIN_REFUND_FAILED

RessourceId : RefundId

The PayIn Refund transaction could not be processed.

PAYIN_REFUND_SUCCEEDED

RessourceId : RefundId

The PayIn Refund transaction has been successfully processed.

Transfer refunds

TRANSFER_REFUND_CREATED

RessourceId : RefundId

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

TRANSFER_REFUND_FAILED

RessourceId : RefundId

The Transfer Refund transaction could not be processed.

TRANSFER_REFUND_SUCCEEDED

RessourceId : RefundId

The Transfer Refund transaction has been successfully processed.

Payout returns

PAYOUT_REFUND_CREATED

RessourceId : RefundId

The Payout Refund transaction has been created.

PAYOUT_REFUND_FAILED

RessourceId : RefundId

The Payout Refund transaction has failed.

PAYOUT_REFUND_SUCCEEDED

RessourceId : RefundId

The Payout Refund transaction has been successfully processed.

Disputes

Disputes

DISPUTE_ACTION_REQUIRED

RessourceId : DisputeId

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

DISPUTE_CLOSED

RessourceId : DisputeId

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

DISPUTE_CREATED

RessourceId : DisputeId

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

DISPUTE_FURTHER_ACTION_REQUIRED

RessourceId : DisputeId

To settle the Dispute, additional documents are required.

DISPUTE_SENT_TO_BANK

RessourceId : DisputeId

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

DISPUTE_SUBMITTED

RessourceId : DisputeId

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

Dispute documents

DISPUTE_DOCUMENT_CREATED

RessourceId : DisputeDocumentId

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

DISPUTE_DOCUMENT_FAILED

RessourceId : DisputeDocumentId

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

DISPUTE_DOCUMENT_SUCCEEDED

RessourceId : DisputeDocumentId

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

DISPUTE_DOCUMENT_VALIDATION_ASKED

RessourceId : DisputeDocumentId

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

Repudiations

PAYIN_REPUDIATION_CREATED

RessourceId : RepudiationId

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

PAYIN_REPUDIATION_FAILED

RessourceId : RepudiationId

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

PAYIN_REPUDIATION_SUCCEEDED

RessourceId : RepudiationId

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

Settlement transfers

TRANSFER_SETTLEMENT_CREATED

RessourceId : SettlementId

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

TRANSFER_SETTLEMENT_FAILED

RessourceId : SettlementId

The Settlement Transfer could not be processed.

TRANSFER_SETTLEMENT_SUCCEEDED

RessourceId : SettlementId

The Settlement Transfer has been successfully processed.

Payouts

Standard payouts

PAYOUT_NORMAL_CREATED

RessourceId : PayoutId

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

PAYOUT_NORMAL_FAILED

RessourceId : PayoutId

The Payout transaction has failed.

PAYOUT_NORMAL_SUCCEEDED

RessourceId : PayoutId

The Payout transaction has been successfully processed.

Instant payouts

INSTANT_PAYOUT_FAILED

RessourceId : PayoutId

The Instant Payout transaction has failed.

INSTANT_PAYOUT_FALLBACKED

RessourceId : PayoutId

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

INSTANT_PAYOUT_SUCCEEDED

RessourceId : PayoutId

The Instant Payout transaction has been successfully processed.

Helpers

Country authorizations

COUNTRY_AUTHORIZATION_UPDATED

RessourceId : CountryCode

The restrictions related to a country have been updated.