Skip to main content
आपके Merchant of Record के रूप में, Dodo Payments आपके behalf पर कार्ड नेटवर्क के साथ विवाद और चार्जबैक प्रक्रिया को प्रबंधित करती है। ये webhooks आपके सिस्टम को विवद के जीवनचक्र के माध्यम से सुरक्षा में रखते हैं ताकि आप पहुंच वापस ले सकें, साक्ष्य इकट्ठा कर सकें, और अपने रिकॉर्ड को मेल कर सकें।

विवाद वेबहुक इवेंट्स

एक विवाद अपने जीवनचक्र के प्रत्येक चरण में एक घटना उत्पन्न करता है:
Visa Rapid Dispute Resolution (RDR) के माध्यम से स्वचालित रूप से हल किए गए विवाद dispute.lost के रूप में प्रकट होते हैं is_resolved_by_rdr: true के साथ। यह अपेक्षित है — औपचारिक चार्जबैक को रोकने के लिए स्वचालित रूप से धनवापसी जारी की गई थी।
Ethoca alerts और [deflections](/features/transactions/disputes#deflections कभी भी कोई विवाद नहीं बनाते, इसलिए वे कोई dispute.* event emit नहीं करते। Ethoca alert का refund standard refund.succeeded event ट्रिगर करता है, और उससे जुड़े किसी subscription का cancellation सामान्य subscription event ट्रिगर करता है। Deflection कोई event ट्रिगर नहीं करता।

Dispute Events को संभालना

जब dispute.opened ट्रिगर होता है, तो विवादित राशि तुरंत रोक दी जाती है। अपने रिकॉर्ड अपडेट करने के लिए event का उपयोग करें और, यदि आप इसे contest करना चाहते हैं, तो dashboard में evidence एकत्र करें।
Handling dispute events
Processing से पहले हमेशा webhook signature सत्यापित करें — setup के लिए Webhooks guide देखें। ऊपर दिया गया handler संक्षिप्तता के लिए verification को छोड़ देता है।
विवाद बनाए जाने के बाद आपके पास उसका जवाब देने के लिए 10 days होते हैं। एकत्र किए जाने वाले evidence और उसे format करने का तरीका जानने के लिए Dispute Response Best Practices देखें।

Dispute Status और Stage

Dispute object दो fields के माध्यम से अपनी progress की जानकारी देता है:

संबंधित

Managing Disputes

विवादों का जवाब कैसे दें, evidence कैसे submit करें, और RDR आपकी dispute rate की सुरक्षा कैसे करता है।

Handle Payment Failures

Failed payments का disputes बनने से पहले पता लगाएँ और उन्हें recover करें।

Webhook Payload Schema

amount
string
आवश्यक

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

brand_id
string
आवश्यक

Brand id this dispute belongs to

business_id
string
आवश्यक

The unique identifier of the business involved in the dispute.

created_at
string<date-time>
आवश्यक

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

currency
string
आवश्यक

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

customer
object
आवश्यक

The customer who filed the dispute

dispute_id
string
आवश्यक

The unique identifier of the dispute.

dispute_stage
enum<string>
आवश्यक

The current stage of the dispute process.

उपलब्ध विकल्प:
pre_dispute,
dispute,
pre_arbitration
dispute_status
enum<string>
आवश्यक

The current status of the dispute.

उपलब्ध विकल्प:
dispute_opened,
dispute_expired,
dispute_accepted,
dispute_cancelled,
dispute_challenged,
dispute_won,
dispute_lost
payment_id
string
आवश्यक

The unique identifier of the payment associated with the dispute.

payment_provider
enum<string>
आवश्यक

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

उपलब्ध विकल्प:
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

अंतिम संशोधन 26 सितंबर 2026