Skip to main content
يضيف استحقاق Discord العميل الذي أجرى عملية دفع إلى خادمك (ويُسند إليه دورًا اختياريًا) فور تفعيل اشتراكه أو إتمام عملية الشراء لمرة واحدة. يؤدي الإلغاء واسترداد الأموال وتغييرات الخطة إلى سحب الدور تلقائيًا.

ما الذي يتم تسليمه

  • يربط العميل حساب Discord الخاص به من خلال رابط OAuth في رسالة التسليم الإلكترونية أو بوابة العملاء.
  • بعد منح الإذن، يضيفه Dodo Payments إلى خادمك (أو يعثر على عضويته الحالية) ويسند إليه الدور الذي أعددته.
  • إذا لم تختر دورًا محددًا، فسيتم منح عضوية الخادم فقط.
يُعد هذا التكامل مثاليًا للمجتمعات المدفوعة ومزايا الداعمين وقنوات الوصول متعددة المستويات.

ربط Discord

1

Open Entitlements

في لوحة تحكم Dodo Payments، انتقل إلى الاستحقاقات وانقر على + لبدء استحقاق جديد.
2

Pick Discord

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

Connect Discord prompt before the OAuth handoff.

يؤدي النقر للمتابعة إلى فتح Discord في علامة تبويب جديدة. سجّل الدخول، واختر الخادم الذي تريد تقييد الوصول إليه، وأكّد أذونات bot (إدارة الأدوار، وطرد الأعضاء، وإنشاء دعوة) على ذلك الخادم.
شاشة Discord OAuth تسأل إلى أي خادم تريد إضافة bot الخاص بـ Dodo Paymentsشاشة تأكيد أذونات bot في Discord

Discord OAuth: pick the server, then confirm the bot's permissions on it.

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

Server connected — return to the Dodo Payments dashboard to continue.

3

Pick a server and role

في لوحة التحكم، اختر الخادم (guild) الذي ربطته للتو. ويمكنك اختياريًا اختيار دور لإسناده عند التسليم، أو ترك الحقل فارغًا لمنح عضوية الخادم فقط. أدخل اسمًا للاستحقاق وانقر على إنشاء الاستحقاق.
استحقاق جديد - نموذج الوصول إلى Discord مع خادم مرتبط، ومحدد خادم، وقائمة أدوار منسدلة، وحقل اسم
4

Save the entitlement

احفظ الاستحقاق. أصبح متاحًا الآن لإرفاقه بأي منتج.

تدفق العميل

  1. يُكمل العميل عملية الدفع.
  2. ينشئ Dodo Payments منحة بحالة pending، مع وجود oauth_url يشير إلى Discord.
  3. يتلقى العميل رسالة إلكترونية تتضمن زر “الانضمام إلى Discord” (رابط OAuth). ويظهر الرابط أيضًا في بوابة العملاء الخاصة به.
  4. بعد منح العميل الإذن، يضيفه bot إلى الخادم ويسند إليه الدور المُعد. تنتقل المنحة إلى delivered.
  5. إذا أُلغي الاشتراك أو أُوقف مؤقتًا أو انتهت صلاحيته، أو إذا ألغاه التاجر يدويًا، يزيل bot الدور وتنتقل المنحة إلى revoked.
تأكد من أن دور bot الخاص بـ Dodo Payments موضوع فوق الدور الذي تمنحه. يمنع Discord bots من إسناد أدوار ذات ترتيب أعلى من ترتيبها.

الإعدادات المطلوبة

الإنشاء عبر API

Webhooks

اشترك في أحداث webhook الخاصة بـ entitlement_grant.* لتتبع منح Discord:
  • يتم تشغيل entitlement_grant.created مع status: "pending" وoauth_url ليمنح العميل الإذن.
  • يتم تشغيل entitlement_grant.delivered بعد إسناد الدور.
  • يتم تشغيل entitlement_grant.revoked عند إزالة الدور.

استكشاف الأخطاء وإصلاحها

تظل المنحة في pending حتى يُكمل العميل تدفق OAuth. تحقّق من قائمة منح الاستحقاق وتأكد من نقره على رابط OAuth. أعد إرسال رسالة التسليم الإلكترونية عند الحاجة.
تأكد من بقاء bot الخاص بـ Dodo Payments في الخادم، ومن امتلاكه إذن Manage Roles، ومن وضعه فوق الدور الذي يتم إسناده. تؤدي إعادة حفظ الاستحقاق إلى إعادة تشغيل عملية التحقق.
ينشر Discord عمليات إزالة الأدوار فورًا، لكن قد يخزّن عميل Discord المحلي لدى العميل النتيجة مؤقتًا. ينبغي له إعادة الاتصال أو التحديث؛ إذ إن الحالة على الخادم صحيحة.
آخر تعديل في ٢١ يوليو ٢٠٢٦