دليل أحداث الويب هوك

توفر مدفوعات دودو إشعارات ويب هوك في الوقت الفعلي لإبقائك على اطلاع بالأحداث الحرجة المتعلقة بالمعاملات، والاشتراكات، والاستردادات، والنزاعات، وإدارة مفاتيح الترخيص. فيما يلي دليل مفصل لهذه الأحداث، مصنفة من أجل الوضوح، مع نصائح واعتبارات للتنفيذ.

أحداث الدفع

اسم الحدث	نوع الحدث	الوصف
Payment Succeeded	`payment.succeeded`	يتم تشغيله عند معالجة دفعة بنجاح.
Payment Failed	`payment.failed`	يحدث عندما تفشل محاولة الدفع بسبب أخطاء، بطاقات مرفوضة، أو مشكلات أخرى.
Payment Processing	`payment.processing`	يشير إلى أن الدفع قيد المعالجة حالياً.
Payment Cancelled	`payment.cancelled`	يتم تشغيله عند إلغاء الدفع قبل اكتماله.

أحداث الاسترداد

اسم الحدث	نوع الحدث	الوصف
Refund Succeeded	`refund.succeeded`	يتم تشغيله عند معالجة استرداد بنجاح.
Refund Failed	`refund.failed`	يحدث عندما تفشل محاولة الاسترداد بسبب أخطاء في المعالجة أو مشكلات أخرى.

أحداث النزاع

اسم الحدث	نوع الحدث	الوصف
Dispute Opened	`dispute.opened`	يتم تشغيله عندما يبدأ العميل نزاعاً.
Dispute Expired	`dispute.expired`	يشير إلى أن النزاع انتهى دون تسوية.
Dispute Accepted	`dispute.accepted`	يتم تشغيله عندما يقبل التاجر النزاع.
Dispute Cancelled	`dispute.cancelled`	يحدث عندما يتم إلغاء النزاع بواسطة العميل أو النظام.
Dispute Challenged	`dispute.challenged`	يتم تشغيله عندما يتحدى التاجر النزاع.
Dispute Won	`dispute.won`	يشير إلى أن التاجر فاز بالنزاع بنجاح.
Dispute Lost	`dispute.lost`	يحدث عندما يخسر التاجر النزاع.

أحداث الاشتراك

اسم الحدث	نوع الحدث	الوصف
الاشتراك نشط	`subscription.active`	يشير إلى أن الاشتراك أصبح نشطًا الآن، وتمت جدولة الرسوم المتكررة.
تم تحديث الاشتراك	`subscription.updated`	يتم تشغيله عند تحديث أي حقل من حقول الاشتراك (مزامنة فورية دون polling).
الاشتراك معلّق	`subscription.on_hold`	يتم تشغيله عند وضع الاشتراك مؤقتًا قيد التعليق بسبب فشل التجديد.
تم إيقاف الاشتراك مؤقتًا	`subscription.paused`	يتم تشغيله عند إيقاف الاشتراك مؤقتًا.
تم استئناف الاشتراك	`subscription.unpaused`	يتم تشغيله عند استئناف اشتراك كان متوقفًا مؤقتًا.
تم تجديد الاشتراك	`subscription.renewed`	يحدث عند تجديد الاشتراك بنجاح.
تم تغيير خطة الاشتراك	`subscription.plan_changed`	يتم تشغيله عند ترقية الاشتراك أو تخفيضه أو تعديله باستخدام إضافات مختلفة.
تم تحديث طريقة دفع الاشتراك	`subscription.update_payment_method`	يتم إرساله عند تحديث طريقة دفع الاشتراك. ويتضمن بيانات Subscription.
تم إلغاء الاشتراك	`subscription.cancelled`	يتم تشغيله عند إلغاء الاشتراك من قِبل التاجر أو العميل.
فشل الاشتراك	`subscription.failed`	يشير إلى فشل الاشتراك. وهذا يعني أننا لم نتمكن من إنشاء تفويض.
انتهت صلاحية الاشتراك	`subscription.expired`	يتم تشغيله عند وصول الاشتراك إلى نهاية مدته وانتهاء صلاحيته.

أحداث مفتاح الترخيص

اسم الحدث	نوع الحدث	الوصف
License Key Created	`license_key.created`	يتم تشغيله عند إنشاء مفتاح ترخيص جديد لمنتج.

أحداث منح الاستحقاق

اسم الحدث	نوع الحدث	الوصف
منح تم إنشاؤه	`entitlement_grant.created`	تم إنشاء منحة استحقاق جديدة للعميل. تصل منح مفتاح الترخيص `delivered`؛ وتصل المنح التي تعتمد على OAuth (ديسكورد، جيت هاب، نوتيون) `pending`.
منح تم تسليمه	`entitlement_grant.delivered`	اكتملت تنفيذ المنحة — تم إصدار مفتاح الترخيص، حل روابط الملفات، أو منح الوصول إلى المنصة.
فشل المنح	`entitlement_grant.failed`	فشل في تنفيذ المنحة؛ تحقق من `error_code` و `error_message`.
منح تم إلغاؤه	`entitlement_grant.revoked`	تم سحب الوصول؛ تحقق من `revocation_reason` (حالة الاشتراك، الاسترداد، تغيير الخطة، أو يدويًا).

للحصول على مخططات التفاصيل، الأحداث النموذجية، والمرجع الكامل revocation_reason، انظر ويب هوك منح الاستحقاق.

أحداث الرصيد

اسم الحدث	نوع الحدث	الوصف
إضافة رصيد	`credit.added`	يتم تفعيله عند منح أرصدة للعميل (الاشتراك، مرة واحدة، الإضافات، أو API).
خصم الرصيد	`credit.deducted`	يحدث عند استهلاك الأرصدة من خلال الاستخدام أو الخصم اليدوي.
انتهاء صلاحية الرصيد	`credit.expired`	يتم تفعيله عند انتهاء صلاحية الأرصدة غير المستخدمة بعد فترة انتهاء صلاحية محددة.
ترحيل الرصيد	`credit.rolled_over`	يحدث عندما يتم ترحيل الأرصدة غير المستخدمة إلى منحة جديدة في نهاية الدورة.
فقدان الترحيل	`credit.rollover_forfeited`	يتم تفعيله عندما يتم خسارة الأرصدة لأن الحد الأقصى لترحيلها تم الوصول إليه.
تحميل زائد	`credit.overage_charged`	يحدث عندما يتم تطبيق رسوم إضافية على الاستخدام بعد الرصيد الصفري.
تعديل يدوي	`credit.manual_adjustment`	يتم تفعيله عندما يتم إجراء تعديل يدوي على الرصيد أو الخصم.
انخفاض الرصيد	`credit.balance_low`	يتم تفعيله عندما ينخفض رصيد الرصيد إلى ما دون الحد المكون.

أحداث الاسترداد

اسم الحدث	نوع الحدث	الوصف
تم اكتشاف إتمام الشراء المتروك	`abandoned_checkout.detected`	يتم تفعيله عند اكتشاف إتمام شراء غير مكتمل أو فاشل بعد 60 دقيقة.
استرداد إتمام الشراء المتروك	`abandoned_checkout.recovered`	يحدث عندما يكمل العميل الدفع عبر رابط استرداد.

لمخططات الحمولة التفصيلية، ووصف الحقول، وأمثلة المعالج، انظر Webhook للاستعادة.

أحداث التحصيل

اسم الحدث	نوع الحدث	الوصف
بداية التحصيل	`dunning.started`	يتم تفعيله عندما تبدأ محاولة لتحصيل الاشتراك الذي تم تعليقه أو إلغاؤه.
استرداد التحصيل	`dunning.recovered`	يحدث عندما يقوم العميل بتحديث طريقة الدفع الخاصة بهم وتنجح الشحنة الناتجة.

للحصول على مخططات الحمولة التفصيلية، وصف الحقل، وأمثلة المعالج، انظر ويب هوك الاسترداد.

أحداث Payout

تتتبّع هذه الأحداث حركة أموالك من Dodo Payments إلى حسابك المصرفي، بما يعكس حالات Payout الظاهرة في لوحة المعلومات. الحمولة هي كائن Payout له البنية نفسها لإدخال من GET /payouts.

اسم الحدث	نوع الحدث	الوصف
Payout Created	`payout.created`	يتم تشغيله عند إنشاء Payout، سواء بواسطة دورة Payout التلقائية أو خارج الدورة.
Payout In Progress	`payout.in_progress`	يحدث عند حلول تاريخ استحقاق Payout وبدء معالجة Payout.
Payout On Hold	`payout.on_hold`	يتم تشغيله عند إيقاف Payout مؤقتًا أو وضعه قيد المراجعة.
Payout Successful	`payout.success`	يحدث عند معالجة Payout إلى حسابك المصرفي بنجاح.
Payout Failed	`payout.failed`	يتم تشغيله عند فشل Payout. وتُضاف الأموال والرسوم مجددًا إلى محفظتك.

لا تفترض أن أحداث Payout نهائية أو مرتبة ترتيبًا صارمًا. يمكن أن يصل payout.failed بشكل مشروع بعد payout.success عندما يعيد أحد البنوك التحويل، كما يمكن أن يصل payout.success بعد payout.failed عند استرداد Payout فاشل لاحقًا. تعامل دائمًا مع الحالة الموجودة في الحمولة باعتبارها الحالة الحالية.

كان يتم إصدار payout.created سابقًا باسم payout.not_initiated. إذا كانت لديك نقطة نهاية موجودة تُجري التصفية باستخدام payout.not_initiated، فحدّث عامل التصفية إلى payout.created حتى يستمر في المطابقة.

للاطلاع على مخططات الحمولة التفصيلية وأوصاف الحقول وأمثلة المعالجات، راجع Payout Webhooks. صُممت أحداث webhook هذه لتزويد التجار بالتحديثات المهمة اللازمة لإدارة عملياتهم بفعالية. نفّذ معالجات قوية لكل حدث ذي صلة في تكامل webhook الخاص بك لضمان وظائف سلسة وموثوقة.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

أحداث الدفع

أحداث الاسترداد

أحداث النزاع

أحداث الاشتراك

أحداث مفتاح الترخيص

أحداث منح الاستحقاق

أحداث الرصيد

أحداث الاسترداد

أحداث التحصيل

أحداث Payout

​أحداث الدفع

​أحداث الاسترداد

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

​أحداث الاشتراك

​أحداث مفتاح الترخيص

​أحداث منح الاستحقاق

​أحداث الرصيد

​أحداث الاسترداد

​أحداث التحصيل

​أحداث Payout

أحداث الدفع

أحداث الاسترداد

أحداث النزاع

أحداث الاشتراك

أحداث مفتاح الترخيص

أحداث منح الاستحقاق

أحداث الرصيد

أحداث الاسترداد

أحداث التحصيل

أحداث Payout