Skip to main content
Sent when a dispute progresses. Key off status to know whether it was won or lost. Delivered to endpoints with event_source set to connect or all. See Connect events.

Event fields

string
The event’s unique identifier, prefixed evt_. Use it to deduplicate deliveries.
string
Always dispute.updated.
string
When the event occurred, in UTC.
string
Whoever the dispute belongs to. On a connected account’s charge, this is the account, not your platform.
string
The connected account the event is attributed to. Present only on events from a connected account.
string
The dispute’s ID.
string
The disputed charge.
string
The disputed amount, as a decimal string.
string
The dispute currency, as an ISO 4217 code.
string
Dispute status, e.g. needs_response, under_review, won, lost, closed, prevented.
boolean
Whether you can still submit or update evidence.
string | null
The reason the dispute was raised.
string | null
When your evidence is due, in UTC.
string | null
When the dispute was created, in UTC.
string | null
When the dispute was last updated, in UTC.
string | null
The charge’s full amount, as a decimal string in data.charge_currency. A dispute can cover less than the full charge when only part of an order is disputed, so this is not always equal to data.amount.
string | null
The charge’s currency, as an ISO 4217 code.