GitHub-rättighet

GitHub-rättigheten lägger till en betalande kund som en samarbetare i ett privat repository. Du väljer behörighetsnivån (pull, push, triage, maintain, eller admin) och Dodo Payments hanterar inbjudan, acceptansuppföljning och borttagning vid avbokning.

Vad som levereras

Kunden blir inbjuden till ditt GitHub-repository genom ett OAuth-flöde som länkar deras GitHub-konto till köpet.
När de accepterar, ger GitHub dem samarbetaråtkomst på den konfigurerade behörighetsnivån.
Avbokning, återbetalning eller manuell ångerrätt tar bort samarbetaren.

Vanliga användningar inkluderar källkodstillgängliga produkter, betalda mallar, kurskodsrepos och låsta klient-SDK.

Anslut GitHub

Open Entitlements

Gå till Rättigheter i din Dodo Payments-instrumentpanel och klicka på + för att starta en ny rättighet.

Pick GitHub

Välj GitHub Access som integration. Om GitHub inte är anslutet ännu, kommer du att uppmanas att Anslut GitHub.

Ny rättighetspanel som uppmanar handlaren att ansluta GitHub — Connect GitHub prompt before the install handoff.

När du klickar öppnas GitHub i en ny flik. Logga in och installera Dodo Payments GitHub App på organisationens eller användarkontot som äger repositoty. Du kan ge åtkomst till alla repositories eller bara de du avser att låsa.

GitHub installations- och auktoriseringssida med alternativen Alla repositories och Endast valda repositories — GitHub Install & Authorize page — choose which repositories the app can manage.

När GitHub omdirigeras tillbaka, ser du en bekräftelse på att kontot är anslutet.

GitHub Access anslutet framgångsrikt bekräftelsesida — Account connected — return to the Dodo Payments dashboard to continue.

Pick a repository and permission

Tillbaka i instrumentpanelen, välj repositoryn som rättigheten ska ge åtkomst till och välj behörighetsnivån. Repositoryväljaren visar endast repositories som GitHub-appen har åtkomst till. Ge rättigheten ett namn och klicka på Skapa Rättighet.

GitHub-rättighetsformulär med ansluten GitHub Access, repositoryväljare, behörighetsdrop-down, och namnfält — Creating a GitHub entitlement. Pick the repository and the permission you want customers to receive.

Save the entitlement

Spara och bifoga rättigheten till vilken produkt som helst. Kunder som köper den produkten får en GitHub-inbjudan vid leverans.

Behörighetsnivåer

GitHubs standard repository-behörigheter gäller:

Behörighet	Bäst för
`pull`	Endast lästillgång. Kunder kan klona, hämta, och visa repositot.
`triage`	Läsbehörighet plus möjlighet att hantera problem och pull requests.
`push`	Läs + skrivbehörighet. Kunder kan pusha grenar och öppna pull requests.
`maintain`	Push-behörighet plus hantering av repository-inställningar (exklusive känsliga).
`admin`	Full kontroll över repositot. Använd med försiktighet.

Ge den minsta privilegienivån som passar ditt användningsfall. De flesta betalinnehållsscenarier behöver endast pull.

Kundflöde

Kunden slutför kassaprocessen.
Dodo Payments skapar ett beviljande i pending status med en oauth_url för kunden att länka sitt GitHub-konto.
Kunden godkänner genom länken i deras e-post eller kundportal.
Dodo Payments bjuder in kundens GitHub-konto till repositot på den konfigurerade behörigheten. Beviljandet övergår till delivered när inbjudningen skapas.
Om prenumerationen avslutas, återbetalas eller återkallas, tas kunden bort som samarbetare.

Obligatorisk konfiguration

Fält	Obligatorisk	Beskrivning
`target_id`	Ja	Repositot som kunden ska bli inbjuden till. Instrumentpanelens repositoryväljare fyller i detta åt dig.
`permission`	Ja	En av `pull`, `push`, `triage`, `maintain`, `admin`.

Skapa via API

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

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

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("pull"),
    },
  ),
})

Webhooks

De vanliga entitlement_grant.* webhook-händelserna täcker GitHub-flödet:

entitlement_grant.created innehåller oauth_url för GitHub-auktorisering.
entitlement_grant.delivered utlöses när samarbetarinbjudan skapas.
entitlement_grant.failed utlöses med error_code: "github_permission_denied" (eller liknande) om GitHub-appen har förlorat åtkomst till repositot.

Felsökning

Repository picker is empty

Dodo Payments GitHub App måste vara installerad på organisationen eller användaren som äger repositot. Öppna Rättigheter → Integrationer → GitHub och installera om appen, se till att ge åtkomst till de relevanta repositories.

Grant fails with permission_denied

GitHub-appens installation har inte längre åtkomst till repositot, eller repositot har bytt namn/flyttats. Ge appen åtkomst igen och nästa beviljande kommer att lyckas.

Customer hasn't accepted the invite

Kunder måste acceptera GitHub-inbjudan från deras notifikationssida eller genom att klicka på länken i deras e-post. Tills de accepterar, förblir de “inbjudna” men kan inte klona repositot. Beviljandet är fortfarande delivered ur Dodo Payments perspektiv; inbjudan är vad vi utfärdar.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Vad som levereras

Anslut GitHub

Behörighetsnivåer

Kundflöde

Obligatorisk konfiguration

Skapa via API

Webhooks

Felsökning

​Vad som levereras

​Anslut GitHub

​Behörighetsnivåer

​Kundflöde

​Obligatorisk konfiguration

​Skapa via API

​Webhooks

​Felsökning

Vad som levereras

Anslut GitHub

Behörighetsnivåer

Kundflöde

Obligatorisk konfiguration

Skapa via API

Webhooks

Felsökning