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)

Payment is charged back and funds leave your account

Identified by eventCode in Payments, type in body on Platforms Resource dispute

adyen-chargeback.json
{
  "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

Send example to Inspect → View as JSON

CHARGEBACK_REVERSED

documented from Adyen docs (example)

Chargeback is defended with the issuer, though not finally

Identified by eventCode in Payments, type in body on Platforms Resource dispute

adyen-chargeback-reversed.json
{
  "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

Send example to Inspect → View as JSON

DISPUTE_DEFENSE_PERIOD_ENDED

documented from Adyen docs (example)

Defense window closes unused or after you accept liability

Identified by eventCode in Payments, type in body on Platforms Resource dispute

adyen-dispute-defense-period-ended.json
{
  "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

Send example to Inspect → View as JSON

INFORMATION_SUPPLIED

documented from Adyen docs (example)

Defense documents are uploaded or the dispute is auto-defended

Identified by eventCode in Payments, type in body on Platforms Resource dispute

adyen-information-supplied.json
{
  "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

Send example to Inspect → View as JSON

ISSUER_COMMENTS

documented from Adyen docs (example)

Issuer adds free-text comments about a dispute

Identified by eventCode in Payments, type in body on Platforms Resource dispute

adyen-issuer-comments.json
{
  "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

Send example to Inspect → View as JSON

ISSUER_RESPONSE_TIMEFRAME_EXPIRED

documented from Adyen docs (example)

Issuer accepts your defense or doesn't respond in time

Identified by eventCode in Payments, type in body on Platforms Resource dispute

adyen-issuer-response-timeframe-expired.json
{
  "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

Send example to Inspect → View as JSON

NOTIFICATION_OF_CHARGEBACK

documented from Adyen docs (example)

Dispute opens, so investigate and supply defense documents

Identified by eventCode in Payments, type in body on Platforms Resource dispute

adyen-notification-of-chargeback.json
{
  "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

Send example to Inspect → View as JSON

NOTIFICATION_OF_FRAUD

documented from Adyen docs (example)

Issuer's fraud alert reaches you through the card scheme

Identified by eventCode in Payments, type in body on Platforms Resource dispute

adyen-notification-of-fraud.json
{
  "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

Send example to Inspect → View as JSON

PREARBITRATION_ACCEPTED

documented from Adyen docs (example)

Pre-arbitration case is accepted

Identified by eventCode in Payments, type in body on Platforms Resource dispute

adyen-prearbitration-accepted.json
{
  "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"
      }
    }
  ]
}

Send example to Inspect → View as JSON

PREARBITRATION_DECLINED

documented from Adyen docs (example)

Pre-arbitration case is declined

Identified by eventCode in Payments, type in body on Platforms Resource dispute

adyen-prearbitration-declined.json
{
  "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"
      }
    }
  ]
}

Send example to Inspect → View as JSON

PREARBITRATION_ISSUER_WITHDRAWN

documented No payload yet

Issuer withdraws a pre-arbitration case

Identified by eventCode in Payments, type in body on Platforms Resource dispute

No payload yet.

Help fill this in → View as JSON

PREARBITRATION_LOST

documented from Adyen docs (example)

Cardholder's bank declines your pre-arbitration case

Identified by eventCode in Payments, type in body on Platforms Resource dispute

adyen-prearbitration-lost.json
{
  "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

Send example to Inspect → View as JSON

PREARBITRATION_OPEN

documented from Adyen docs (example)

Cardholder's bank opens a pre-arbitration case

Identified by eventCode in Payments, type in body on Platforms Resource dispute

adyen-prearbitration-open.json
{
  "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"
      }
    }
  ]
}

Send example to Inspect → View as JSON

PREARBITRATION_WON

documented from Adyen docs (example)

Cardholder's bank accepts your pre-arbitration case

Identified by eventCode in Payments, type in body on Platforms Resource dispute

adyen-prearbitration-won.json
{
  "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

Send example to Inspect → View as JSON

REQUEST_FOR_INFORMATION

documented from Adyen docs (example)

Shopper opens a request-for-information case with the bank

Identified by eventCode in Payments, type in body on Platforms Resource dispute

adyen-request-for-information.json
{
  "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

Send example to Inspect → View as JSON

SCHEME_ARBITRATION

documented No payload yet

Issuer escalates pre-arbitration to scheme arbitration

Identified by eventCode in Payments, type in body on Platforms Resource dispute

No payload yet.

Help fill this in → View as JSON

SCHEME_ARBITRATION_LOST

documented No payload yet

Card scheme rules that you are liable

Identified by eventCode in Payments, type in body on Platforms Resource dispute

No payload yet.

Help fill this in → View as JSON

SCHEME_ARBITRATION_WON

documented No payload yet

Card scheme rules that the issuer is liable

Identified by eventCode in Payments, type in body on Platforms Resource dispute

No payload yet.

Help fill this in → View as JSON

SECOND_CHARGEBACK

documented from Adyen docs (example)

Issuer declines your defense and the amount is deducted

Identified by eventCode in Payments, type in body on Platforms Resource dispute

adyen-second-chargeback.json
{
  "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

Send example to Inspect → View as 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.

Not affiliated with Adyen. Facts are compiled from public sources and linked inline.