Skip to main content
Als Ihr Merchant of Record verwaltet Dodo Payments den Streit- und Rückbuchungsprozess mit den Kartennetzwerken in Ihrem Namen. Diese Webhooks halten Ihre Systeme synchron, während ein Streitfall seinen Lebenszyklus durchläuft, sodass Sie den Zugriff widerrufen, Beweise sammeln und Ihre Unterlagen abgleichen können.

Streitfall-Webhook-Ereignisse

Ein Streitfall löst in jeder Phase seines Lebenszyklus ein Ereignis aus:
Streitfälle, die automatisch über Visa Rapid Dispute Resolution (RDR) gelöst werden, erscheinen als dispute.lost mit is_resolved_by_rdr: true. Dies ist zu erwarten — die Rückerstattung wurde automatisch ausgestellt, um eine formelle Rückbuchung zu vermeiden.
Ethoca-Benachrichtigungen und Abwehrmaßnahmen erstellen niemals einen Streitfall und lösen daher keine dispute.*-Ereignisse aus. Eine Rückerstattung aufgrund einer Ethoca-Benachrichtigung löst das standardmäßige refund.succeeded-Ereignis aus, und jede damit verknüpfte Kündigung eines Abonnements löst das übliche Abonnementereignis aus. Eine Abwehrmaßnahme löst kein Ereignis aus.

Verarbeitung von Streitfallereignissen

Wenn dispute.opened ausgelöst wird, wird der strittige Betrag sofort einbehalten. Verwenden Sie das Ereignis, um Ihre Aufzeichnungen zu aktualisieren, und sammeln Sie Belege im Dashboard, wenn Sie den Streitfall anfechten möchten.
Handling dispute events
Überprüfen Sie vor der Verarbeitung immer die Webhook-Signatur — Informationen zur Einrichtung finden Sie im Webhooks-Leitfaden. Der obige Handler lässt die Überprüfung der Kürze halber aus.
Sie haben 10 Tage Zeit, auf einen Streitfall zu reagieren, nachdem er erstellt wurde. Unter Best Practices für Streitfallantworten erfahren Sie, welche Belege Sie sammeln und wie Sie diese formatieren sollten.

Status und Phase des Streitfalls

Das Streitfallobjekt gibt seinen Fortschritt über zwei Felder an:

Verwandte Themen

Managing Disputes

Wie Sie auf Streitfälle reagieren und Belege einreichen und wie RDR Ihre Streitfallquote schützt.

Handle Payment Failures

Erkennen Sie fehlgeschlagene Zahlungen und stellen Sie diese wieder her, bevor sie zu Streitfällen werden.

Schema der Webhook-Nutzdaten

amount
string
erforderlich

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

brand_id
string
erforderlich

Brand id this dispute belongs to

business_id
string
erforderlich

The unique identifier of the business involved in the dispute.

created_at
string<date-time>
erforderlich

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

currency
string
erforderlich

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

customer
object
erforderlich

The customer who filed the dispute

dispute_id
string
erforderlich

The unique identifier of the dispute.

dispute_stage
enum<string>
erforderlich

The current stage of the dispute process.

Verfügbare Optionen:
pre_dispute,
dispute,
pre_arbitration
dispute_status
enum<string>
erforderlich

The current status of the dispute.

Verfügbare Optionen:
dispute_opened,
dispute_expired,
dispute_accepted,
dispute_cancelled,
dispute_challenged,
dispute_won,
dispute_lost
payment_id
string
erforderlich

The unique identifier of the payment associated with the dispute.

payment_provider
enum<string>
erforderlich

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

Verfügbare Optionen:
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

Zuletzt geändert am 26. September 2026