Adyen dispute webhook events
Adyen sends 19 events across a dispute's life, from NOTIFICATION_OF_CHARGEBACK when a dispute opens to SECOND_CHARGEBACK and the pre-arbitration stages. 15 have sample payloads.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
CHARGEBACK
documented from Adyen docs (example)
CHARGEBACK Payment is charged back and funds leave your account
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
{
"live": "false",
"notificationItems": [
{
"NotificationRequestItem": {
"additionalData": { … },
"amount": { … },
"eventCode": "CHARGEBACK",
"eventDate": "2021-01-01T01:00:00+01:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"merchantReference": "YOUR_MERCHANT_REFERENCE",
"originalReference": "9913140798220028",
"paymentMethod": "mc"
}
}
]
} From Adyen docs
-
Content type
application/json
CHARGEBACK_REVERSED
documented from Adyen docs (example)
CHARGEBACK_REVERSED Chargeback is defended with the issuer, though not finally
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
{
"live": "false",
"notificationItems": [
{
"NotificationRequestItem": {
"additionalData": { … },
"amount": { … },
"eventCode": "CHARGEBACK_REVERSED",
"eventDate": "2021-01-01T01:00:00+01:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"merchantReference": "YOUR_MERCHANT_REFERENCE",
"paymentMethod": "mc",
"pspReference": "QFQTPCQ8HXSKGK82"
}
}
]
} From Adyen docs
-
Content type
application/json
DISPUTE_DEFENSE_PERIOD_ENDED
documented from Adyen docs (example)
DISPUTE_DEFENSE_PERIOD_ENDED Defense window closes unused or after you accept liability
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
{
"live": "true",
"notificationItems": [
{
"NotificationRequestItem": {
"additionalData": { … },
"amount": { … },
"eventCode": "DISPUTE_DEFENSE_PERIOD_ENDED",
"eventDate": "2024-11-11T01:30:57+01:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"merchantReference": "YOUR_REFERENCE",
"originalReference": "9914444444444444",
"paymentMethod": "visa"
}
}
]
} From Adyen docs
-
Content type
application/json
INFORMATION_SUPPLIED
documented from Adyen docs (example)
INFORMATION_SUPPLIED Defense documents are uploaded or the dispute is auto-defended
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
{
"live": "true",
"notificationItems": [
{
"NotificationRequestItem": {
"additionalData": { … },
"amount": { … },
"eventCode": "INFORMATION_SUPPLIED",
"eventDate": "2025-05-17T09:35:14+02:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"originalReference": "9914444444444444",
"merchantReference": "YOUR_REFERENCE",
"paymentMethod": "visa"
}
}
]
} From Adyen docs
-
Content type
application/json
ISSUER_COMMENTS
documented from Adyen docs (example)
ISSUER_COMMENTS Issuer adds free-text comments about a dispute
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
{
"live": "false",
"notificationItems": [
{
"NotificationRequestItem": {
"additionalData": { … },
"amount": { … },
"eventCode": "ISSUER_COMMENTS",
"eventDate": "2025-05-17T09:35:14+02:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"originalReference": "9914444444444444",
"merchantReference": "YOUR_REFERENCE",
"paymentMethod": "visa"
}
}
]
} From Adyen docs
-
Content type
application/json
ISSUER_RESPONSE_TIMEFRAME_EXPIRED
documented from Adyen docs (example)
ISSUER_RESPONSE_TIMEFRAME_EXPIRED Issuer accepts your defense or doesn't respond in time
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
{
"live": "false",
"notificationItems": [
{
"NotificationRequestItem": {
"additionalData": { … },
"amount": { … },
"eventCode": "ISSUER_RESPONSE_TIMEFRAME_EXPIRED",
"eventDate": "2021-05-19T09:35:14+02:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"originalReference": "9914444444444444",
"merchantReference": "YOUR_REFERENCE",
"paymentMethod": "visa"
}
}
]
} From Adyen docs
-
Content type
application/json
NOTIFICATION_OF_CHARGEBACK
documented from Adyen docs (example)
NOTIFICATION_OF_CHARGEBACK Dispute opens, so investigate and supply defense documents
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
{
"live": "false",
"notificationItems": [
{
"NotificationRequestItem": {
"additionalData": { … },
"amount": { … },
"eventCode": "NOTIFICATION_OF_CHARGEBACK",
"eventDate": "2021-01-01T01:00:00+01:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"merchantReference": "YOUR_MERCHANT_REFERENCE",
"originalReference": "9913140798220028",
"paymentMethod": "mc"
}
}
]
} From Adyen docs
-
Content type
application/json
NOTIFICATION_OF_FRAUD
documented from Adyen docs (example)
NOTIFICATION_OF_FRAUD Issuer's fraud alert reaches you through the card scheme
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
{
"live": "false",
"notificationItems": [
{
"NotificationRequestItem": {
"additionalData": { … },
"amount": { … },
"eventCode": "NOTIFICATION_OF_FRAUD",
"eventDate": "2021-01-01T01:00:00+01:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"merchantReference": "YOUR_MERCHANT_REFERENCE",
"originalReference": "9913140798220028",
"paymentMethod": "visa"
}
}
]
} From Adyen docs
-
Content type
application/json
PREARBITRATION_ACCEPTED
documented from Adyen docs (example)
PREARBITRATION_ACCEPTED Pre-arbitration case is accepted
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
{
"live": "true",
"notificationItems": [
{
"NotificationRequestItem": {
"additionalData": { … },
"amount": { … },
"eventCode": "PREARBITRATION_ACCEPTED",
"eventDate": "2025-10-01T12:46:09+02:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"merchantReference": "YOUR_REFERENCE",
"originalReference": "JDD6LKT8MBLZNN84",
"paymentMethod": "mc"
}
}
]
} PREARBITRATION_DECLINED
documented from Adyen docs (example)
PREARBITRATION_DECLINED Pre-arbitration case is declined
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
{
"live": "true",
"notificationItems": [
{
"NotificationRequestItem": {
"additionalData": { … },
"amount": { … },
"eventCode": "PREARBITRATION_DECLINED",
"eventDate": "2025-10-01T12:51:33:56+02:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"merchantReference": "YOUR_REFERENCE",
"originalReference": "M5N7TQ4TG5PFWR50",
"paymentMethod": "visa"
}
}
]
} PREARBITRATION_ISSUER_WITHDRAWN
documented No payload yet
PREARBITRATION_ISSUER_WITHDRAWN Issuer withdraws a pre-arbitration case
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
No payload yet.
PREARBITRATION_LOST
documented from Adyen docs (example)
PREARBITRATION_LOST Cardholder's bank declines your pre-arbitration case
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
{
"live": "true",
"notificationItems": [
{
"NotificationRequestItem": {
"additionalData": { … },
"amount": { … },
"eventCode": "PREARBITRATION_LOST",
"eventDate": "2021-01-01T01:00:00+01:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"merchantReference": "YOUR_MERCHANT_REFERENCE",
"paymentMethod": "visa",
"pspReference": "QFQTPCQ8HXSKGK82"
}
}
]
} From Adyen docs
-
Content type
application/json
PREARBITRATION_OPEN
documented from Adyen docs (example)
PREARBITRATION_OPEN Cardholder's bank opens a pre-arbitration case
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
{
"live": "true",
"notificationItems": [
{
"NotificationRequestItem": {
"additionalData": { … },
"amount": { … },
"eventCode": "PREARBITRATION_OPEN",
"eventDate": "2025-10-01T12:40:39+02:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"merchantReference": "YOUR_REFERENCE",
"paymentMethod": "visa",
"pspReference": "NC6HT9CRT65ZGN82"
}
}
]
} PREARBITRATION_WON
documented from Adyen docs (example)
PREARBITRATION_WON Cardholder's bank accepts your pre-arbitration case
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
{
"live": "false",
"notificationItems": [
{
"NotificationRequestItem": {
"amount": { … },
"eventCode": "PREARBITRATION_WON",
"eventDate": "2021-01-01T01:00:00+01:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"merchantReference": "YOUR_MERCHANT_REFERENCE",
"paymentMethod": "bankTransfer_IBAN",
"pspReference": "QFQTPCQ8HXSKGK82",
"reason": ""
}
}
]
} From Adyen docs
-
Content type
application/json
REQUEST_FOR_INFORMATION
documented from Adyen docs (example)
REQUEST_FOR_INFORMATION Shopper opens a request-for-information case with the bank
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
{
"live": "false",
"notificationItems": [
{
"NotificationRequestItem": {
"additionalData": { … },
"amount": { … },
"eventCode": "REQUEST_FOR_INFORMATION",
"eventDate": "2021-01-01T01:00:00+01:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"merchantReference": "YOUR_MERCHANT_REFERENCE",
"originalReference": "9913140798220028",
"paymentMethod": "mc"
}
}
]
} From Adyen docs
-
Content type
application/json
SCHEME_ARBITRATION
documented No payload yet
SCHEME_ARBITRATION Issuer escalates pre-arbitration to scheme arbitration
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
No payload yet.
SCHEME_ARBITRATION_LOST
documented No payload yet
SCHEME_ARBITRATION_LOST Card scheme rules that you are liable
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
No payload yet.
SCHEME_ARBITRATION_WON
documented No payload yet
SCHEME_ARBITRATION_WON Card scheme rules that the issuer is liable
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
No payload yet.
SECOND_CHARGEBACK
documented from Adyen docs (example)
SECOND_CHARGEBACK Issuer declines your defense and the amount is deducted
Identified by eventCode in Payments, type in body on Platforms
Resource dispute
{
"live": "false",
"notificationItems": [
{
"NotificationRequestItem": {
"additionalData": { … },
"amount": { … },
"eventCode": "SECOND_CHARGEBACK",
"eventDate": "2021-01-01T01:00:00+01:00",
"merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
"merchantReference": "YOUR_MERCHANT_REFERENCE",
"paymentMethod": "jcb",
"pspReference": "QFQTPCQ8HXSKGK82"
}
}
]
} From Adyen docs
-
Content type
application/json
Route Adyen events by type.
Event Gateway receives every Adyen delivery and filters and routes it by event type, so each service gets only the events it handles.