Titolo GitHub

​

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.

​

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.

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.

Quando GitHub reindirizza indietro, vedrai una conferma che l’account è connesso.

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.

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

​

Flusso del cliente

1. Il cliente completa il checkout.
2. Dodo Payments crea un grant con stato Pending. Il suo oauth_url è null finché il cliente non avvia il flusso di accettazione; a quel punto viene popolato con un URL di autorizzazione GitHub.
3. Il cliente esegue l’autorizzazione tramite il link contenuto nella propria email o nel customer portal.
4. Dodo Payments invita l’account GitHub del cliente al repository con il livello di autorizzazione configurato. Il grant passa a Delivered una volta creata l’invito.
5. Se l’abbonamento viene annullato, rimborsato o revocato, il cliente viene rimosso come collaboratore.

​

Configurazione richiesta

​

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',
  },
});

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

• entitlement_grant.created viene attivato con status: "Pending" e oauth_url ancora null; l’URL di autorizzazione GitHub viene popolato quando il cliente avvia il flusso di accettazione dalla propria email di consegna o dal customer portal.
• entitlement_grant.delivered viene attivato una volta creata l’invito al collaboratore.
• entitlement_grant.failed viene attivato con error_code: "github_permission_denied" (o un valore simile) se la GitHub App perde l’accesso al repository.

​

Risoluzione dei problemi