Skip to main content
استحقاق GitHub يضيف العميل الذي يقوم بالدفع كمساهم في مستودع خاص. يمكنك اختيار مستوى الإذن (pull، push، triage، maintain، أو admin) ويتولى Dodo Payments عملية الدعوة، تتبع القبول، والإزالة عند الإلغاء.

ما الذي يُقدم

  • تتم دعوة العميل إلى مستودع GitHub الخاص بك عبر تدفق OAuth الذي يربط حساب GitHub الخاص بهم بالشراء.
  • بمجرد قبولهم، يمنحهم GitHub الوصول كمساهم بمستوى الإذن الذي تم تكوينه.
  • الإلغاء أو الاسترداد أو الإلغاء اليدوي يزيل المساهم.
تشمل الاستخدامات الشائعة المنتجات المتاحة المصدر، القوالب المدفوعة، مستودعات الكود الخاصة بالدورات، وSDKs العملاء المحمية.

الاتصال بـ GitHub

1

Open Entitlements

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

Pick GitHub

اختر الوصول إلى GitHub كتكامل. إذا لم يكن GitHub متصلاً بعد، ستتم مطالبتك بـ اتصال GitHub.
New entitlement panel prompting the merchant to connect GitHub

Connect GitHub prompt before the install handoff.

النقر يفتح GitHub في علامة تبويب جديدة. قم بتسجيل الدخول، ثم قم بتثبيت تطبيق Dodo Payments GitHub على حساب المنظمة أو المستخدم الذي يمتلك المستودع. يمكنك منح الوصول إلى جميع المستودعات أو فقط تلك التي تنوي حمايتها.
GitHub Install and Authorize page with All repositories and Only select repositories options

GitHub Install & Authorize page — choose which repositories the app can manage.

عندما يعود التوجيه من GitHub، ستشاهد تأكيدًا بأن الحساب متصل.
GitHub Access connected successfully confirmation page

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

3

Pick a repository and permission

عد إلى لوحة التحكم، اختر المستودع الذي يجب أن يمنح الاستحقاق الوصول إليه واختر مستوى الإذن. يعرض منتقي المستودعات فقط المستودعات التي يملك تطبيق GitHub الوصول إليها. امنح الاستحقاق اسمًا وانقر على إنشاء استحقاق.
GitHub entitlement form with connected GitHub Access, repository selector, permission dropdown, and name field

Creating a GitHub entitlement. Pick the repository and the permission you want customers to receive.

4

Save the entitlement

احفظ واربط الاستحقاق بأي منتج. العملاء الذين يشترون هذا المنتج يتلقون دعوة GitHub عند التسليم.

مستويات الإذن

تطبق أذونات المستودع القياسية لـ GitHub:
امنح الحد الأدنى من الامتيازات التي تتناسب مع حالتك. معظم سيناريوهات المحتوى المدفوع تحتاج فقط pull.

تدفق العميل

  1. يُكمل العميل عملية الدفع.
  2. تنشئ Dodo Payments منحة بالحالة Pending مع oauth_url للعميل لربط حسابه على GitHub.
  3. يفوّض العميل الوصول من خلال الرابط الموجود في بريده الإلكتروني أو في بوابة العميل.
  4. تدعو Dodo Payments حساب العميل على GitHub إلى المستودع باستخدام مستوى الأذونات المُعدّ. تنتقل المنحة إلى الحالة Delivered بمجرد إنشاء الدعوة.
  5. إذا تم إلغاء الاشتراك أو ردّ المبلغ أو سحبه، تتم إزالة العميل من قائمة المتعاونين.

التكوين المطلوب

الإنشاء عبر API

Webhooks

تشمل أحداث Webhook القياسية غطاء تدفق GitHub:
  • entitlement_grant.created يتضمن oauth_url للتصريح عبر GitHub.
  • entitlement_grant.delivered يتم إطلاقه بمجرد إنشاء دعوة المساهم.
  • entitlement_grant.failed يتم إطلاقه مع error_code: "github_permission_denied" (أو ما شابه) إذا فقد تطبيق GitHub الوصول إلى المستودع.

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

يجب تثبيت تطبيق Dodo Payments GitHub على المنظمة أو المستخدم الذي يمتلك المستودع. افتح الاستحقاقات → التكاملات → GitHub وأعد تثبيت التطبيق مع التأكد من منح الوصول إلى المستودعات ذات الصلة.
لا يملك تثبيت تطبيق GitHub الوصول إلى المستودع بعد الآن، أو تم إعادة تسمية/نقل المستودع. أعد منح الوصول إلى التطبيق وستنجح المحاولة التالية.
يجب على العملاء قبول دعوة GitHub من صفحة الإشعارات لديهم أو بالنقر على الرابط الموجود في بريدهم الإلكتروني. وإلى أن يقبلوها، يظلون في حالة “مدعوّ”، لكن لا يمكنهم استنساخ المستودع. ولا تزال المنحة في الحالة Delivered من منظور Dodo Payments؛ فالدعوة هي ما نصدره.
آخر تعديل في ٦ أغسطس ٢٠٢٦