توفر مدفوعات دودو إشعارات ويب هوك في الوقت الفعلي لإبقائك على اطلاع بالأحداث الحرجة المتعلقة بالمعاملات، والاشتراكات، والاستردادات، والنزاعات، وإدارة مفاتيح الترخيص. فيما يلي دليل مفصل لهذه الأحداث، مصنفة من أجل الوضوح، مع نصائح واعتبارات للتنفيذ.
أحداث الدفع
| اسم الحدث | نوع الحدث | الوصف |
|---|
| 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.active | يشير إلى أن الاشتراك نشط الآن وتم جدولة الرسوم المتكررة. |
| Subscription Updated | subscription.updated | يتم تشغيله عند تحديث أي حقل في الاشتراك (مزامنة فورية بدون استعلام). |
| Subscription On Hold | subscription.on_hold | يتم تشغيله عندما يتم تعليق الاشتراك مؤقتاً بسبب فشل التجديد. |
| Subscription Renewed | subscription.renewed | يحدث عندما يتم تجديد الاشتراك بنجاح. |
| Subscription Plan Changed | subscription.plan_changed | يتم تشغيله عندما يتم ترقية الاشتراك أو تخفيضه أو تعديله بإضافات مختلفة. |
| Subscription Cancelled | subscription.cancelled | يتم تشغيله عند إلغاء الاشتراك من قبل التاجر أو العميل. |
| Subscription Failed | subscription.failed | يشير إلى فشل الاشتراك. هذا يعني أننا لم نتمكن من إنشاء تفويض. |
| Subscription Expired | subscription.expired | يتم تشغيله عندما يصل الاشتراك إلى نهاية مدته وينتهي. |
أحداث مفتاح الترخيص
| اسم الحدث | نوع الحدث | الوصف |
|---|
| License Key Created | license_key.created | يتم تشغيله عند إنشاء مفتاح ترخيص جديد لمنتج. |
أحداث الرصيد
| Event Name | Event Type | Description |
|---|
| Credit Added | credit.added | يتم تشغيله عند منح الأرصدة للعميل (الاشتراك، لمرة واحدة، إضافة، أو عبر واجهة برمجة التطبيقات). |
| Credit Deducted | credit.deducted | يحدث عند استهلاك الأرصدة من خلال الاستخدام أو الخصم اليدوي. |
| Credit Expired | credit.expired | يتم تشغيله عند انتهاء صلاحية الأرصدة غير المستخدمة بعد فترة الانتهاء المُعدّة. |
| Credit Rolled Over | credit.rolled_over | يحدث عندما تُنقل الأرصدة غير المستخدمة إلى منح جديدة عند نهاية الدورة. |
| Rollover Forfeited | credit.rollover_forfeited | يتم تشغيله عندما تُصادر الأرصدة لأن عدد إعادة التدوير الأقصى تم الوصول إليه. |
| Overage Charged | credit.overage_charged | يحدث عند تطبيق رسوم الاستخدام الزائد عن الرصيد الصفري. |
| Manual Adjustment | credit.manual_adjustment | يتم تشغيله عند إجراء تعديل يدوي في الرصيد (إضافة أو خصم). |
| Balance Low | credit.balance_low | يتم تشغيله عندما ينخفض رصيد الأرصدة إلى ما دون العتبة المُعدّة. |
Last modified on March 2, 2026
