GitHub अधिकार

​

क्या उपलब्ध कराया जाता है

• ग्राहक Customer Portal से अपना GitHub account connect करता है। इससे उसका GitHub account purchase से link हो जाता है।
• Dodo Payments उस account को आपके repository में configured permission level के साथ invite करता है। GitHub पर invitation स्वीकार करने के बाद ग्राहक को access मिल जाता है। यदि repository ग्राहक की own है, तो invitation की आवश्यकता नहीं होती।
• Cancellation, refund या manual revoke collaborator को हटा देता है और किसी भी pending invitation को cancel कर देता है।

​

GitHub कनेक्ट करें

1

Open Entitlements

Dodo Payments dashboard में Entitlements पर जाएँ और नया entitlement शुरू करने के लिए + पर click करें।

2

Pick GitHub

Integration के रूप में GitHub Access चुनें। यदि GitHub अभी तक connected नहीं है, तो Connect GitHub पर click करें।

GitHub एक नए tab में खुलता है। Sign in करें, फिर उस organization या user account पर Dodo Payments GitHub App install करें जो repository का owner है। आप app को All repositories या Only select repositories का access दे सकते हैं। यदि आप repositories चुनते हैं, तो उन सभी repositories को शामिल करें जिन्हें आप gate करना चाहते हैं।

जब GitHub वापस redirect करता है, तो एक confirmation page दिखता है कि account connected है।

3

Pick a Repository and Permission

Dashboard में वापस जाकर वह Repository चुनें जिस तक entitlement access देता है, फिर Permission level चुनें। Repository picker केवल उन repositories की सूची दिखाता है जिन तक GitHub App पहुँच सकता है। Entitlement के लिए Name दर्ज करें और Create Entitlement पर click करें।

4

Attach It to a Product

Entitlement को किसी भी product से attach करें। उस product को खरीदने वाले ग्राहकों को अपना GitHub account connect करने के बाद GitHub invitation प्राप्त होता है।

​

Permission levels

​

Customer flow

1. ग्राहक checkout पूरा करता है।
2. Dodo Payments, Pending स्थिति में एक grant बनाता है। Dodo Payments तुरंत GitHub authorization URL बनाने का प्रयास करता है और उसे oauth_url में संग्रहीत करता है। यदि यह विफल रहता है, तो ग्राहक द्वारा accept flow शुरू किए जाने तक oauth_url, null पर ही रहता है।
3. भुगतान पुष्टिकरण ईमेल entitlement को Action Required के रूप में सूचीबद्ध करता है और Customer Portal से लिंक करता है। पोर्टल में, ग्राहक Connect पर क्लिक करता है और GitHub के साथ authorization करता है। Authorization link 30 मिनट बाद समाप्त हो जाता है, और ग्राहक के वापस आने पर Customer Portal एक नया link बनाता है।
4. Dodo Payments, ग्राहक के GitHub account को configured permission के साथ repository में आमंत्रित करता है। Invitation बनाए जाने के बाद grant, Delivered पर चला जाता है। यदि GitHub invitation अस्वीकार करता है, तो grant deliver नहीं किया जाता।
5. यदि subscription cancel हो जाती है, payment refund कर दिया जाता है, या grant revoke कर दिया जाता है, तो Dodo Payments ग्राहक को collaborator के रूप में हटा देता है और किसी भी pending invitation को cancel कर देता है।

​

आवश्यक configuration

​

API के माध्यम से बनाएँ

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode',
});

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

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

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

// client is a *dodopayments.Client, for example from
// dodopayments.NewClient(option.WithEnvironmentTestMode()); ctx is a context.Context.
client.Entitlements.New(ctx, dodopayments.EntitlementNewParams{
  Name:            dodopayments.F("Code Share Repository"),
  IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeGitHub),
  IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
    dodopayments.IntegrationConfigGitHubConfigParam{
      TargetID:   dodopayments.F("acme/private-sdk"),
      Permission: dodopayments.F(dodopayments.GitHubPermissionPull),
    },
  ),
})

​

Webhooks

• entitlement_grant.created, status: "Pending" के साथ fire होता है। oauth_url में GitHub authorization URL पहले से मौजूद हो सकता है। यदि यह null है, तो ग्राहक द्वारा Customer Portal से accept flow शुरू करने पर इसमें value भर दी जाती है।
• entitlement_grant.delivered, collaborator invitation बनाए जाने के बाद fire होता है।
• entitlement_grant.revoked, access वापस लिए जाने पर fire होता है। यदि आप GitHub App uninstall करते हैं, तो Dodo Payments उस installation के pending और delivered grants को revocation_reason: platform_external के साथ revoke कर देता है।
• यदि Dodo Payments ग्राहक को repository में add नहीं कर पाता, तो entitlement_grant.failed, error_code: "GRANT_ACCESS_FAILED" के साथ fire होता है; उदाहरण के लिए, GitHub App का उस repository तक access समाप्त हो जाने पर।

​

समस्या निवारण