GitHub-rättighet

​

Vad som levereras

• Kunden ansluter sitt GitHub-konto från Customer Portal. Detta kopplar kundens GitHub-konto till köpet.
• Dodo Payments bjuder in kontot till ditt repository på den konfigurerade behörighetsnivån. Kunden får åtkomst efter att ha accepterat inbjudan på GitHub. Om kunden äger repositoryt behövs ingen inbjudan.
• Annullering, återbetalning eller manuell återkallelse tar bort collaborator och annullerar eventuella väntande inbjudningar.

​

Anslut GitHub

1

Open Entitlements

I Dodo Payments-dashboarden går du till Entitlements och klickar på + för att starta ett nytt entitlement.

2

Pick GitHub

Välj GitHub Access som integration. Om GitHub inte är anslutet ännu klickar du på Connect GitHub.

GitHub öppnas i en ny flik. Logga in och installera sedan Dodo Payments GitHub App på den organisation eller det användarkonto som äger repositoryt. Du kan ge appen åtkomst till All repositories eller Only select repositories. Om du väljer repositoryn inkluderar du alla repositoryn som du vill begränsa åtkomsten till.

När GitHub omdirigerar tillbaka visas en bekräftelsesida som visar att kontot är anslutet.

3

Pick a Repository and Permission

Tillbaka i dashboarden väljer du det Repository som entitlementet ger åtkomst till och väljer sedan behörighetsnivån Permission. Repository-väljaren listar endast repositoryn som GitHub App har åtkomst till. Ange ett Name för entitlementet och klicka på Create Entitlement.

4

Attach It to a Product

Koppla entitlementet till valfri produkt. Kunder som köper produkten får en GitHub-inbjudan efter att de har anslutit sitt GitHub-konto.

​

Behörighetsnivåer

​

Kundflöde

1. Kunden slutför checkouten.
2. Dodo Payments skapar ett grant med statusen Pending. Dodo Payments försöker skapa en GitHub-auktoriserings-URL direkt och lagrar den i oauth_url. Om det misslyckas förblir oauth_url null tills kunden startar accept-flödet.
3. E-postmeddelandet som bekräftar betalningen listar entitlementen som Action Required och länkar till Customer Portal. I portalen klickar kunden på Connect och auktoriserar med GitHub. En auktoriseringslänk upphör att gälla efter 30 minuter, och Customer Portal genererar en ny när kunden återkommer.
4. Dodo Payments bjuder in kundens GitHub-konto till repot med den konfigurerade behörigheten. Grantet övergår till Delivered när inbjudan har skapats. Om GitHub avvisar inbjudan levereras inte grantet.
5. Om prenumerationen avslutas, betalningen återbetalas eller grantet återkallas tar Dodo Payments bort kunden som collaborator och avbryter alla väntande inbjudningar.

​

Obligatorisk konfiguration

​

Skapa via 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 utlöses med status: "Pending". oauth_url kan redan innehålla GitHub-auktoriserings-URL:en. Om den är null fylls den i när kunden startar accept-flödet från Customer Portal.
• entitlement_grant.delivered utlöses när collaborator-inbjudan har skapats.
• entitlement_grant.revoked utlöses när åtkomsten återkallas. Om du avinstallerar GitHub App återkallar Dodo Payments väntande och levererade grants för den installationen med revocation_reason: platform_external.
• entitlement_grant.failed utlöses med error_code: "GRANT_ACCESS_FAILED" om Dodo Payments inte kan lägga till kunden i repot, till exempel eftersom GitHub App har förlorat åtkomsten till det.

​

Felsökning