Skip to content
PayplugPayplug Elements

A dispute was raised

POST

Sent to your notification URL when a cardholder’s bank disputes a tranche, sometimes weeks after the payment. Nothing is handled automatically on our side: mind validUntil, past which the dispute is lost by default.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json

A dispute on one of your tranches, relayed as the PSP raised it.

object
event
required
string
Allowed value: chargeback
notificationId
required

Stable across retries: deduplicate on it.

string
orderId
required

Your own order reference.

string
sessionId
required

The session the disputed tranche belongs to.

string format: uuid
attemptId
required

The disputed tranche.

string format: uuid
transactionId
required

The operation the money moved on.

string format: uuid
type
required

Which way the money went. chargeback: a debit, the money left your account. representment: a credit, the dispute was settled in your favour.

string
Allowed values: chargeback representment
amount
required

The disputed amount.

object
amount
required

Amount in the MINOR unit of the currency — 1000_00 is one thousand euros, never 1000.

integer
currency
required

ISO 4217 code, uppercase. One currency per session.

string
/^[A-Z]{3}$/
provider
required

Which PSP raised it.

string
providerRef
required

The PSP’s own reference for the disputed operation.

string
reasonCode

The network’s reason code.

string
status

The PSP’s status for the dispute.

string
date

When the dispute was raised.

string
validUntil

The deadline to contest it: past that date, the dispute is lost by default.

string
Example
{
  "event": "chargeback",
  "notificationId": "A180635474:chargeback:2026-08-18:60000",
  "orderId": "EP-123456",
  "sessionId": "019f18f1-cbf4-762f-bd94-776f523c9ffb",
  "attemptId": "019f18f2-6ceb-729c-98b4-d60271a718e0",
  "transactionId": "019f18f2-73ee-729c-98b4-dd336f0beb22",
  "type": "chargeback",
  "amount": {
    "amount": 60000,
    "currency": "EUR"
  },
  "provider": "dalenys",
  "providerRef": "A180635474",
  "reasonCode": "13.1",
  "status": "First chargeback",
  "date": "2026-08-18",
  "validUntil": "2026-09-15"
}

Responses

Section titled “ Responses ”

200

Section titled “200”

Received. Answer 200 with the body OK in text/plain: any other answer — another status, another content type, another body — is retried at t+1 second, t+1 minute, then t+5 minutes.

Media typetext/plain
string
Allowed value: OK