Webhook Payloads
Dispute Webhooks
The payload sent to your webhook endpoint when a dispute is created or updated. Handle each event to respond to disputes and reconcile your records.
As your Merchant of Record, Dodo Payments manages the dispute and chargeback process with the card networks on your behalf. These webhooks keep your systems in sync as a dispute moves through its lifecycle so you can revoke access, gather evidence, and reconcile your records.
Dispute Webhook Events
A dispute emits an event at each stage of its lifecycle:Disputes auto-resolved through Visa Rapid Dispute Resolution (RDR) appear as
dispute.lost with is_resolved_by_rdr: true. This is expected — the refund was issued automatically to prevent a formal chargeback.Ethoca alerts and deflections never create a dispute, so they emit no
dispute.* events. An Ethoca alert refund fires the standard refund.succeeded event, and any linked subscription cancellation fires the usual subscription event. A deflection fires no event.Handling Dispute Events
Whendispute.opened fires, the disputed amount is held immediately. Use the event to update your records and, if you intend to contest it, gather evidence in the dashboard.
Handling dispute events
Dispute Status and Stage
The dispute object reports its progress through two fields:Related
Managing Disputes
How to respond to disputes, submit evidence, and how RDR protects your dispute rate.
Handle Payment Failures
Detect and recover failed payments before they become disputes.
Webhook Payload Schema
Last modified on September 25, 2026