Vai al contenuto principale

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.

Il diritto GitHub aggiunge un cliente pagante come collaboratore su un repository privato. Scegli il livello di autorizzazione (pull, push, triage, maintain, o admin) e Dodo Payments gestisce l’invito, il monitoraggio dell’accettazione e la rimozione in caso di cancellazione.

​
Cosa viene consegnato

  • Il cliente viene invitato al tuo repository GitHub tramite un flusso OAuth che collega il suo account GitHub all’acquisto.
  • Una volta accettato, GitHub concede loro l’accesso come collaboratori al livello di autorizzazione configurato.
  • La cancellazione, il rimborso o la revoca manuale rimuove il collaboratore.
Gli usi comuni includono prodotti con codice sorgente disponibile, modelli a pagamento, repository di codice per corsi e SDK client con accesso limitato.

​
Connetti GitHub

1

Open Entitlements

Nel tuo dashboard Dodo Payments, vai a Diritti e fai clic su + per avviare un nuovo diritto.
2

Pick GitHub

Scegli Accesso GitHub come integrazione. Se GitHub non è ancora connesso, ti verrà richiesto di Connettere GitHub.
Pannello di nuovo diritto che invita il commerciante a connettere GitHub
Facendo clic si apre GitHub in una nuova scheda. Accedi, quindi installa l’app GitHub Dodo Payments sull’organizzazione o sull’account utente che possiede il repository. Puoi concedere l’accesso a tutti i repository o solo a quelli che intendi limitare.
Pagina Installa e Autorizza GitHub con opzioni Tutti i repository e Solo selezionati
Quando GitHub reindirizza indietro, vedrai una conferma che l’account è connesso.
Pagina di conferma Accesso GitHub connesso con successo
3

Pick a repository and permission

Torna al dashboard, scegli il repository a cui il diritto deve concedere l’accesso e seleziona il livello di autorizzazione. Il selettore di repository mostra solo i repository a cui l’app GitHub ha accesso. Dai un nome al diritto e fai clic su Crea Diritto.
Modulo diritto GitHub con Accesso GitHub connesso, selettore di repository, menu a discesa delle autorizzazioni e campo nome
4

Save the entitlement

Salva e allega il diritto a qualsiasi prodotto. I clienti che acquistano quel prodotto riceveranno un invito GitHub alla consegna.

​
Livelli di autorizzazione

Si applicano le autorizzazioni standard del repository GitHub:
AutorizzazioneMigliore per
pullAccesso in sola lettura. I clienti possono clonare, recuperare e visualizzare il repo.
triageAccesso di lettura più la possibilità di gestire problemi e richieste di pull.
pushAccesso in lettura + scrittura. I clienti possono inviare modifiche e aprire richieste di pull.
maintainAccesso invio più gestione delle impostazioni del repository (esclusi quelli sensibili).
adminControllo completo del repository. Usare con cautela.
Concedi il minimo privilegio che si adatta al tuo caso d’uso. La maggior parte degli scenari a pagamento richiede solo pull.

​
Flusso del cliente

  1. Il cliente completa il checkout.
  2. Dodo Payments crea un diritto in stato pending con un oauth_url per consentire al cliente di collegare il proprio account GitHub.
  3. Il cliente autorizza tramite il collegamento nell’email o nel portale clienti.
  4. Dodo Payments invita l’account GitHub del cliente al repository al livello di autorizzazione configurato. Il diritto passa a delivered una volta creata l’invito.
  5. Se l’abbonamento viene cancellato, rimborsato o revocato, il cliente viene rimosso come collaboratore.

​
Configurazione richiesta

CampoNecessarioDescrizione
target_idSìIl repository a cui invitare il cliente. Il selettore del repository del dashboard lo riempie per te.
permissionSìUno di pull, push, triage, maintain, admin.

​
Creare tramite API

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

​
Webhooks

Gli eventi standard del webhook entitlement_grant.* coprono il flusso GitHub:
  • entitlement_grant.created include l’oauth_url per l’autorizzazione GitHub.
  • entitlement_grant.delivered viene attivato una volta creata l’invito del collaboratore.
  • entitlement_grant.failed viene attivato con error_code: "github_permission_denied" (o simile) se l’app GitHub ha perso l’accesso al repository.

​
Risoluzione dei problemi

L’app GitHub Dodo Payments deve essere installata sull’org o sull’utente che possiede il repository. Apri Diritti → Integrazioni → GitHub e reinstalla l’app, assicurandoti di concedere l’accesso ai repository pertinenti.
L’installazione dell’app GitHub non ha più accesso al repository, o il repository è stato rinominato/trasferito. Concedi nuovamente l’accesso all’app e il prossimo re-grant avrà successo.
I clienti devono accettare l’invito GitHub dalla loro pagina notifiche o facendo clic sul collegamento nella loro email. Finché non accettano, rimangono “invitati” ma non possono clonare il repo. Il diritto è ancora delivered dal punto di vista di Dodo Payments; l’invito è ciò che emettiamo.
Last modified on May 14, 2026