تلقَّ إشعارات فورية عند وقوع الأحداث في <Frame>. أتمت سير العمل وحافظ على مزامنة أنظمتك من خلال تسليم الأحداث فورًا.
توفر Webhooks إشعارات فورية عند وقوع أحداث محددة في حسابك على Dodo Payments. استخدم Webhooks لأتمتة سير العمل، وتحديث قاعدة بياناتك، وإرسال الإشعارات، والحفاظ على مزامنة أنظمتك.
يتبع تنفيذ Webhook لدينا مواصفة Standard Webhooks، مما يضمن التوافق مع أفضل ممارسات المجال ومكتبات Webhook الحالية.
انتقل إلى لوحة تحكم DodoPayments، ثم انتقل إلى Developer > Webhooks.
2
Create Webhook Endpoint
انقر على Add Webhook لإنشاء نقطة نهاية Webhook جديدة.
3
Add Endpoint URL
أدخل عنوان URL الذي تريد تلقي أحداث Webhook عليه.
4
Select Events to Receive
اختر الأحداث المحددة التي يجب أن تستمع إليها نقطة نهاية Webhook، وذلك بتحديدها من قائمة الأحداث.
ستؤدي الأحداث المحددة فقط إلى تشغيل Webhooks لنقطة النهاية لديك، مما يساعدك على تجنب حركة المرور والمعالجة غير الضروريتين.
5
Get Secret Key
احصل على Secret Key الخاص بـ Webhook من صفحة الإعدادات. ستستخدمه للتحقق من صحة Webhooks المستلمة.
حافظ على أمان مفتاح Webhook السري، ولا تكشفه مطلقًا في التعليمات البرمجية من جانب العميل أو في المستودعات العامة.
6
Rotate Secret (Optional)
عند الحاجة، يمكنك تدوير السر الخاص بـ Webhook لتعزيز الأمان. انقر على زر Rotate Secret في إعدادات Webhook.
سيؤدي تدوير السر إلى انتهاء صلاحيته واستبداله بسر جديد. سيظل السر القديم صالحًا خلال الساعات الأربع والعشرين التالية فقط. بعد ذلك، سيفشل التحقق باستخدام السر القديم.
استخدم تدوير السر دوريًا أو فورًا إذا شككت في اختراق السر الحالي.
إذا فشل تسليم Webhook، تعيد Dodo Payments المحاولة تلقائيًا باستخدام تأخير أُسّي لتجنب إغراق نظامك.
المحاولة
التأخير
الوصف
1
فورًا
تحدث إعادة المحاولة الأولى فورًا
2
5 ثوانٍ
المحاولة الثانية بعد تأخير قصير
3
5 دقائق
المحاولة الثالثة مع زيادة التأخير الأُسّي
4
30 دقيقة
المحاولة الرابعة مع استمرار التأخير الأُسّي
5
ساعتان
المحاولة الخامسة مع تأخير ممتد
6
5 ساعات
المحاولة السادسة مع تأخير أطول
7
10 ساعات
المحاولة السابعة مع أقصى تأخير
8
10 ساعات
المحاولة الأخيرة - يُعلَّم Webhook على أنه فاشل إذا لم تنجح
الحد الأقصى هو 8 محاولات إعادة لكل حدث Webhook. على سبيل المثال، إذا فشل Webhook ثلاث مرات قبل نجاحه، فسيكون إجمالي وقت التسليم نحو 35 دقيقة و5 ثوانٍ بدءًا من المحاولة الأولى.
استخدم لوحة تحكم Dodo Payments لإعادة محاولة الرسائل الفردية يدويًا أو استرداد جميع الرسائل الفاشلة دفعةً واحدة في أي وقت.
نوع المورد. أحد الأنواع التالية: Payment أو Subscription أو Refund أو Dispute أو LicenseKey أو CreditLedgerEntry أو CreditBalanceLow أو AbandonedCheckout أو DunningAttempt أو EntitlementGrant.
تختلف الحقول الإضافية حسب نوع الحدث. راجع وثائق الحدث المحدد للاطلاع على المخططات الكاملة.
أعِد توجيه أحداث Webhook الحقيقية من حساب وضع الاختبار إلى خادم التطوير المحلي لديك في الوقت الفعلي:
dodo wh listen
يفتح CLI اتصال WebSocket بـ Dodo Payments ويعيد توجيه كل حدث Webhook إلى نقطة النهاية المحلية لديك (مثل http://localhost:3000/webhook)، مع الحفاظ على جميع الترويسات، بما في ذلك ترويسات التوقيع لاختبار التحقق.
يعمل المستمع فقط مع مفاتيح API الخاصة بـ test mode. شغّل dodo login وحدد Test Mode قبل استخدام هذا الأمر.
أرسل payloads وهمية لـ Webhook إلى أي نقطة نهاية دون إنشاء معاملات حقيقية:
dodo wh trigger
تتيح لك هذه الأداة التفاعلية الاختيار من جميع أنواع الأحداث المدعومة، وترسل payloads وهمية واقعية إلى نقطة النهاية لديك. وتعمل في حلقة كي تتمكن من اختبار أحداث متعددة في جلسة واحدة.
لا تحمل payloads Webhook الوهمية من dodo wh trigger توقيعًا. استخدم unsafe_unwrap() بدلًا من unwrap() في معالج Webhook أثناء الاختبار فقط.
ابقَ على اطلاع بصحة Webhook لديك من خلال إشعارات البريد الإلكتروني التلقائية. عندما يبدأ تسليم Webhook بالفشل أو تتوقف نقطة النهاية عن الاستجابة، ستتلقى تنبيهات عبر البريد الإلكتروني لتتمكن من معالجة المشكلات بسرعة والحفاظ على تشغيل تكاملاتك بسلاسة.
انتقل إلى لوحة تحكم Dodo Payments وانتقل إلى Dashboard → Webhooks → Alerting.
2
Enable Email Notifications
فعّل Email notifications لبدء تلقي التنبيهات حول مشكلات تسليم Webhook.
3
Configure Email Address
أدخل عنوان البريد الإلكتروني الذي تريد تلقي تنبيهات Webhook عليه. سنرسل إشعارات إلى هذا العنوان عند وقوع أحداث معينة في إعداد Webhooks لديك، مثل مشكلات التسليم التي قد تؤثر في تكاملاتك.
فعّل التنبيهات عبر البريد الإلكتروني لاكتشاف مشكلات تسليم Webhook مبكرًا والحفاظ على تكاملات موثوقة. ستتلقى إشعارًا عند فشل عمليات التسليم أو عدم استجابة نقطة النهاية.
هل أنت مستعد لنشر معالج Webhook في بيئة الإنتاج؟ نوفر أدلة خاصة بكل منصة لمساعدتك على نشر Webhooks لدى موفري الخدمات السحابية المشهورين، مع أفضل الممارسات لكل منصة.
Vercel
انشر Webhooks على Vercel باستخدام الدوال serverless
Cloudflare Workers
شغّل Webhooks على شبكة Cloudflare الطرفية
Supabase Edge Functions
ادمج Webhooks مع Supabase
Netlify Functions
انشر Webhooks كدوال serverless على Netlify
يتضمن كل دليل خاص بمنصة إعداد البيئة، والتحقق من التوقيع، وخطوات النشر الخاصة بموفر الخدمة المعني.