Skip to main content
En tant que Commerçant d’Enregistrement, Dodo Payments gère le processus de litige et de rétrofacturation avec les réseaux de cartes en votre nom. Ces webhooks gardent vos systèmes synchronisés à mesure qu’un litige progresse dans son cycle de vie afin que vous puissiez révoquer l’accès, rassembler des preuves et concilier vos enregistrements.

Événements Webhook de Litige

Un litige émet un événement à chaque étape de son cycle de vie :
Les litiges résolus automatiquement via Visa Rapid Dispute Resolution (RDR) apparaissent comme dispute.lost avec is_resolved_by_rdr: true. C’est prévu — le remboursement a été émis automatiquement pour éviter une rétrofacturation formelle.
Les alertes Ethoca et les déflections ne créent jamais de litige et n’émettent donc aucun événement dispute.*. Un remboursement déclenché par une alerte Ethoca émet l’événement standard refund.succeeded, et toute annulation d’abonnement associée émet l’événement d’abonnement habituel. Une déflection n’émet aucun événement.

Gestion des événements de litige

Lorsque dispute.opened est émis, le montant contesté est immédiatement bloqué. Utilisez l’événement pour mettre à jour vos enregistrements et, si vous prévoyez de le contester, rassembler les preuves dans le dashboard.
Handling dispute events
Vérifiez toujours la signature du webhook avant le traitement — consultez le guide des Webhooks pour la configuration. Le handler ci-dessus omet la vérification par souci de concision.
Vous disposez de 10 jours pour répondre à un litige après sa création. Consultez les bonnes pratiques pour répondre aux litiges pour connaître les preuves à rassembler et la façon de les formater.

Statut et étape du litige

L’objet de litige indique sa progression au moyen de deux champs :

Contenu associé

Managing Disputes

Comment répondre aux litiges, soumettre des preuves et comment RDR protège votre taux de litiges.

Handle Payment Failures

Détectez et récupérez les paiements échoués avant qu’ils ne deviennent des litiges.

Schéma de la charge utile du Webhook

amount
string
requis

The amount involved in the dispute, represented as a string to accommodate precision.

brand_id
string
requis

Brand id this dispute belongs to

business_id
string
requis

The unique identifier of the business involved in the dispute.

created_at
string<date-time>
requis

The timestamp of when the dispute was created, in UTC.

currency
string
requis

The currency of the disputed amount, represented as an ISO 4217 currency code.

customer
object
requis

The customer who filed the dispute

dispute_id
string
requis

The unique identifier of the dispute.

dispute_stage
enum<string>
requis

The current stage of the dispute process.

Options disponibles:
pre_dispute,
dispute,
pre_arbitration
dispute_status
enum<string>
requis

The current status of the dispute.

Options disponibles:
dispute_opened,
dispute_expired,
dispute_accepted,
dispute_cancelled,
dispute_challenged,
dispute_won,
dispute_lost
payment_id
string
requis

The unique identifier of the payment associated with the dispute.

payment_provider
enum<string>
requis

Which processor handled the underlying payment. stripe / adyen for BYOP routes (the merchant's own payment connector); dodo for everything Dodo processed itself.

Options disponibles:
stripe,
adyen,
dodo
is_resolved_by_rdr
boolean | null

Whether the dispute was resolved by Rapid Dispute Resolution

reason
string | null

Reason for the dispute

remarks
string | null

Remarks

Dernière modification le 26 septembre 2026