Hoppa till huvudinnehåll

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-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

1

Open Entitlements

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

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
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
När GitHub omdirigeras tillbaka, ser du en bekräftelse på att kontot är anslutet.
GitHub Access anslutet framgångsrikt bekräftelsesida
3

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
4

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örighetBäst för
pullEndast lästillgång. Kunder kan klona, hämta, och visa repositot.
triageLäsbehörighet plus möjlighet att hantera problem och pull requests.
pushLäs + skrivbehörighet. Kunder kan pusha grenar och öppna pull requests.
maintainPush-behörighet plus hantering av repository-inställningar (exklusive känsliga).
adminFull 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

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

Obligatorisk konfiguration

FältObligatoriskBeskrivning
target_idJaRepositot som kunden ska bli inbjuden till. Instrumentpanelens repositoryväljare fyller i detta åt dig.
permissionJaEn 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',
  },
});

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

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.
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.
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.
Last modified on May 14, 2026