امنح العملاء حق الوصول كمساهم في مستودع GitHub خاص بمستوى الإذن الذي تختاره، وقم بالإلغاء تلقائيًا عند الإلغاء.
استحقاق GitHub يضيف العميل الذي يقوم بالدفع كمساهم في مستودع خاص. يمكنك اختيار مستوى الإذن (pull، push، triage، maintain، أو admin) ويتولى Dodo Payments عملية الدعوة، تتبع القبول، والإزالة عند الإلغاء.
في لوحة التحكم على Dodo Payments، انتقل إلى الاستحقاقات وانقر على + لبدء استحقاق جديد.
2
Pick GitHub
اختر الوصول إلى GitHub كتكامل. إذا لم يكن GitHub متصلاً بعد، ستتم مطالبتك بـ اتصال GitHub.
Connect GitHub prompt before the install handoff.
النقر يفتح GitHub في علامة تبويب جديدة. قم بتسجيل الدخول، ثم قم بتثبيت تطبيق Dodo Payments GitHub على حساب المنظمة أو المستخدم الذي يمتلك المستودع. يمكنك منح الوصول إلى جميع المستودعات أو فقط تلك التي تنوي حمايتها.
GitHub Install & Authorize page — choose which repositories the app can manage.
عندما يعود التوجيه من GitHub، ستشاهد تأكيدًا بأن الحساب متصل.
Account connected — return to the Dodo Payments dashboard to continue.
3
Pick a repository and permission
عد إلى لوحة التحكم، اختر المستودع الذي يجب أن يمنح الاستحقاق الوصول إليه واختر مستوى الإذن. يعرض منتقي المستودعات فقط المستودعات التي يملك تطبيق GitHub الوصول إليها. امنح الاستحقاق اسمًا وانقر على إنشاء استحقاق.
Creating a GitHub entitlement. Pick the repository and the permission you want customers to receive.
4
Save the entitlement
احفظ واربط الاستحقاق بأي منتج. العملاء الذين يشترون هذا المنتج يتلقون دعوة GitHub عند التسليم.
تنشئ Dodo Payments منحة بالحالة Pending. وتظل قيمة oauth_url الخاصة بها هي null حتى يبدأ العميل مسار القبول، وعندها تتم تعبئتها بعنوان URL للتفويض من GitHub.
يفوّض العميل عبر الرابط الموجود في بريده الإلكتروني أو في Customer Portal.
تدعو Dodo Payments حساب GitHub الخاص بالعميل إلى المستودع باستخدام الإذن المُكوَّن. تنتقل المنحة إلى Delivered بمجرد إنشاء الدعوة.
إذا تم إلغاء الاشتراك أو ردّ المبلغ أو إبطاله، تتم إزالة العميل من قائمة المتعاونين.
يتم إطلاق entitlement_grant.created مع status: "Pending"، بينما تظل قيمة oauth_url هي null؛ ويتم تعبئة عنوان URL للتفويض من GitHub بمجرد أن يبدأ العميل مسار القبول من بريد التسليم الإلكتروني أو Customer Portal.
يتم إطلاق entitlement_grant.delivered بمجرد إنشاء دعوة المتعاون.
يتم إطلاق entitlement_grant.failed مع error_code: "github_permission_denied" (أو ما شابه) إذا فقد GitHub App إمكانية الوصول إلى المستودع.
يجب تثبيت تطبيق Dodo Payments GitHub على المنظمة أو المستخدم الذي يمتلك المستودع. افتح الاستحقاقات → التكاملات → GitHub وأعد تثبيت التطبيق مع التأكد من منح الوصول إلى المستودعات ذات الصلة.
Grant fails with permission_denied
لا يملك تثبيت تطبيق GitHub الوصول إلى المستودع بعد الآن، أو تم إعادة تسمية/نقل المستودع. أعد منح الوصول إلى التطبيق وستنجح المحاولة التالية.
Customer hasn't accepted the invite
يجب على العملاء قبول دعوة GitHub من صفحة الإشعارات لديهم أو بالنقر على الرابط الموجود في بريدهم الإلكتروني. وإلى أن يقبلوها، يظلون في حالة “مدعوّ”، لكن لا يمكنهم استنساخ المستودع. ولا تزال المنحة في الحالة Delivered من منظور Dodo Payments؛ فالدعوة هي ما نصدره.
