Skip to main content
باعتبارك تاجر السجل، تدير ددو بايمنتس عملية النزاع واسترداد المبالغ المدفوعة مع شبكات البطاقات نيابة عنك. تحافظ هذه الويب هوك على مزامنة أنظمتك أثناء انتقال النزاع من خلال دورة حياته حتى تتمكن من إلغاء الوصول وجمع الأدلة وتسوية سجلاتك.

أحداث webhook للنزاع

يبعث النزاع حدثًا في كل مرحلة من مراحل دورة حياته:
النزاعات التي تم حلها تلقائياً من خلال Visa Rapid Dispute Resolution (RDR) تظهر كـ dispute.lost مع is_resolved_by_rdr: true. هذا متوقع — تم إصدار الاسترداد تلقائيًا لمنع استرداد رسمي.
لا تُنشئ تنبيهات Ethoca وعمليات الإبطال نزاعًا مطلقًا، ولذلك لا تُصدر أي أحداث dispute.*. ويُصدر ردّ أموال تنبيه Ethoca الحدث القياسي refund.succeeded، كما يُصدر إلغاء أي اشتراك مرتبط حدث الاشتراك المعتاد. ولا تُصدر عملية الإبطال أي حدث.

معالجة أحداث النزاعات

عند إصدار dispute.opened، يتم حجز المبلغ محل النزاع فورًا. استخدم الحدث لتحديث سجلاتك، وإذا كنت تنوي الاعتراض عليه، فاجمع الأدلة من لوحة المعلومات.
Handling dispute events
تحقق دائمًا من توقيع webhook قبل المعالجة — راجع دليل Webhooks لمعرفة الإعداد. يتجاهل المعالج أعلاه التحقق للاختصار.
لديك 10 أيام للرد على النزاع بعد إنشائه. راجع أفضل ممارسات الرد على النزاعات لمعرفة الأدلة التي ينبغي جمعها وكيفية تنسيقها.

حالة النزاع ومرحلته

يعرض كائن النزاع مستوى تقدمه من خلال حقلين:

ذات صلة

Managing Disputes

كيفية الرد على النزاعات وتقديم الأدلة، وكيف يحميك RDR من ارتفاع معدل النزاعات لديك.

Handle Payment Failures

اكتشف المدفوعات الفاشلة واستردّها قبل أن تتحول إلى نزاعات.

مخطط حمولة Webhook

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

آخر تعديل في ٢٦ سبتمبر ٢٠٢٦