dispute.created

Occurs when a payment charge is disputed by the customer (chargeback initiated).

WEBHOOK dispute.created

Example

{
  "id": "dsp_abc123",
  "paymentId": "pay_019e60cb...",
  "amount": "100.00",
  "currency": "USD",
  "status": "needs_response",
  "reason": "fraudulent",
  "editable": true,
  "needsResponseBy": "2023-11-07T05:31:56Z",
  "customerName": "<string>",
  "customerEmail": "<string>",
  "notes": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

Authenticate requests using your standard bearer API key (e.g. YOUR_API_KEY).

Body

application/json

id · string

Internal dispute ID.

Example:

"dsp_abc123"

paymentId · string

Example:

"pay_019e60cb..."

amount · string

Dollar value, 2 d.p.

Example:

"100.00"

currency · string

Example:

"USD"

status · string

Example:

"needs_response"

reason · string | null

Example:

"fraudulent"

editable · boolean

needsResponseBy · string<date-time> | null

customerName · string | null

customerEmail · string | null

notes · string | null

createdAt · string<date-time>

updatedAt · string<date-time>

Response

200

Webhook processed successfully.