الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

استحقاق 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
النقر يفتح GitHub في علامة تبويب جديدة. قم بتسجيل الدخول، ثم قم بتثبيت تطبيق Dodo Payments GitHub على حساب المنظمة أو المستخدم الذي يمتلك المستودع. يمكنك منح الوصول إلى جميع المستودعات أو فقط تلك التي تنوي حمايتها.
GitHub Install and Authorize page with All repositories and Only select repositories options
عندما يعود التوجيه من GitHub، ستشاهد تأكيدًا بأن الحساب متصل.
GitHub Access connected successfully confirmation page
3

Pick a repository and permission

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

Save the entitlement

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

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

تطبق أذونات المستودع القياسية لـ GitHub:
إذنالأفضل لـ
pullوصول للقراءة فقط. يمكن للعملاء استنساخ وتحميل ومشاهدة المستودع.
triageوصول للقراءة بالإضافة إلى القدرة على إدارة المشكلات وطلبات السحب.
pushوصول للقراءة والكتابة. يمكن للعملاء دفع الفروع وفتح طلبات السحب.
maintainوصول للدفع بالإضافة إلى إدارة إعدادات المستودع (باستثناء الحساسة منها).
adminالسيطرة الكاملة على المستودع. استخدم بحذر.
امنح الحد الأدنى من الامتيازات التي تتناسب مع حالتك. معظم سيناريوهات المحتوى المدفوع تحتاج فقط pull.

تدفق العميل

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

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

الحقلمطلوبالوصف
target_idنعمالمستودع لدعوة العميل إليه. يقوم منتقي المستودع في لوحة التحكم بملء هذا نيابة عنك.
permissionنعمأحد pull، push، triage، maintain، admin.

الإنشاء عبر API

const entitlement = await client.entitlements.create({
  name: 'Code Share Repository',
  integration_type: 'github',
  integration_config: {
    target_id: 'acme/private-sdk',
    permission: 'pull',
  },
});

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؛ الدعوة هي ما نصدره.
Last modified on May 22, 2026