Event types
This page lists the event types for which you use the POST Create a Hook endpoint to be notified at your chosen URL.
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.
Was this page helpful?