Notification types

Learn about the MarketPay notification types.


Adyen MarketPay sends notifications to your marketplace on every event, which you may need to process. These notifications are sent to the endpoints that you specify for MarketPay using the API calls described in the Configure notifications document.

Notification types

Notification messages include a number of different fields, which vary depending on the event type that triggers this specific notification.

MarketPay sends the following notifications.

Notification Description
ACCOUNT_HOLDER_CREATED

This notification is triggered when an account holder is created, or when an error occurred during account holder creation.

ACCOUNT_CREATED

This notification is triggered when an account is created.

ACCOUNT_HOLDER_UPDATED

This notification is triggered when an account holder is updated.

ACCOUNT_HOLDER_STATUS_CHANGE

This notification is triggered when the status of an account holder is changed (for example, when the processing amount exceeds the current tier's limits and proceeds to the next tier).

ACCOUNT_HOLDER_VERIFICATION

This notification is triggered when some events occur during account holder verification. For more information, refer to  KYC verification checks .

ACCOUNT_HOLDER_PAYOUT

This notification is sent out when a payout is initiated.  If the payout process has been started successfully for a specified account, amount, and bank account, the notification contains statusCode = Initiated; in case of any error a notification with statusCode = Failed is sent.

PAYMENT_FAILURE

This notification is triggered in case of a split payment is failed.

SCHEDULED_REFUNDS

After refunds were triggered by the /refundNotPaidOutTransfers request , Adyen sends out this notification containing the scheduled refunds.

TRANSFER_FUNDS

This notification is triggered in case the transferFunds request has been called.

REPORT_AVAILABLE

This notification triggers when Adyen generates a marketplace-specific report.

COMPENSATE_NEGATIVE_BALANCE

On the last day of each month Adyen MarketPay checks if there are any accounts with a negative balance. When such accounts are found, MarketPay compensates their balance from the liable marketplace account and sends the COMPENSATE_NEGATIVE_BALANCE notification to the marketplace.