Passer au contenu principal

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.

Le droit GitHub ajoute un client payant en tant que collaborateur sur un dépôt privé. Vous choisissez le niveau de permission (pull, push, triage, maintain, ou admin) et Dodo Payments gère l’invitation, le suivi de l’acceptation et la suppression en cas d’annulation.

​
Ce qui est livré

  • Le client est invité à votre dépôt GitHub via un flux OAuth qui lie leur compte GitHub à l’achat.
  • Une fois qu’ils acceptent, GitHub leur accorde l’accès collaborateur au niveau de permission configuré.
  • L’annulation, le remboursement ou la révocation manuelle supprime le collaborateur.
Les utilisations courantes incluent les produits à code source ouvert, les modèles payants, les dépôts de code de cours et les SDK clients protégés.

​
Connecter GitHub

1

Open Entitlements

Dans votre tableau de bord Dodo Payments, allez à Droits et cliquez sur + pour commencer un nouveau droit.
2

Pick GitHub

Choisissez Accès GitHub comme intégration. Si GitHub n’est pas encore connecté, il vous sera demandé de Connecter GitHub.
Nouveau panneau de droit demandant au marchand de connecter GitHub
En cliquant dessus, GitHub s’ouvre dans un nouvel onglet. Connectez-vous, puis installez l’application GitHub Dodo Payments sur l’organisation ou le compte utilisateur qui possède le dépôt. Vous pouvez accorder l’accès à tous les dépôts ou seulement à ceux que vous souhaitez protéger.
Page d'installation et d'autorisation de GitHub avec options Tous les dépôts et Seuls les dépôts sélectionnés
Lorsque GitHub redirige en retour, vous verrez une confirmation que le compte est connecté.
Page de confirmation de connexion réussie de l'Accès GitHub
3

Pick a repository and permission

De retour dans le tableau de bord, choisissez le dépôt auquel le droit doit accorder l’accès et sélectionnez le niveau de permission. Le sélecteur de dépôt n’affiche que les dépôts auxquels l’application GitHub a accès. Donnez un nom au droit et cliquez sur Créer un droit.
Formulaire de droit GitHub avec Accès GitHub connecté, sélecteur de dépôt, menu déroulant de permission et champ de nom
4

Save the entitlement

Enregistrez et attachez le droit à tout produit. Les clients qui achètent ce produit reçoivent une invitation GitHub lors de la livraison.

​
Niveaux de permission

Les permissions standard des dépôts GitHub s’appliquent :
PermissionIdéal pour
pullAccès en lecture seule. Les clients peuvent cloner, récupérer et consulter le dépôt.
triageAccès en lecture plus possibilité de gérer les problèmes et les pull requests.
pushAccès en lecture + écriture. Les clients peuvent pousser des branches et ouvrir des pull requests.
maintainAccès au push plus gestion des paramètres du dépôt (à l’exception des paramètres sensibles).
adminContrôle total du dépôt. À utiliser avec précaution.
Accordez le moins de privilèges possible qui convient à votre cas d’utilisation. La plupart des scénarios de contenu payant n’ont besoin que de pull.

​
Flux client

  1. Le client termine l’achat.
  2. Dodo Payments crée une subvention avec le statut pending avec un oauth_url pour que le client puisse lier son compte GitHub.
  3. Le client autorise via le lien dans son e-mail ou portail client.
  4. Dodo Payments invite le compte GitHub du client au dépôt avec la permission configurée. La subvention passe à delivered une fois l’invitation créée.
  5. Si l’abonnement est annulé, remboursé ou révoqué, le collaborateur est retiré.

​
Configuration requise

ChampRequisDescription
target_idOuiLe dépôt auquel inviter le client. Le sélecteur de dépôt du tableau de bord le remplit pour vous.
permissionOuiL’un de pull, push, triage, maintain, admin.

​
Créer via l’API

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

​
Webhooks

Les événements webhook standard entitlement_grant.* couvrent le flux GitHub :
  • entitlement_grant.created inclut le oauth_url pour l’autorisation GitHub.
  • entitlement_grant.delivered est déclenché une fois l’invitation du collaborateur créée.
  • entitlement_grant.failed est déclenché avec error_code: "github_permission_denied" (ou similaire) si l’application GitHub a perdu l’accès au dépôt.

​
Dépannage

L’application GitHub Dodo Payments doit être installée sur l’org ou l’utilisateur qui possède le dépôt. Ouvrez Droits → Intégrations → GitHub et réinstallez l’application, en veillant à accorder l’accès aux dépôts pertinents.
L’installation de l’application GitHub n’a plus accès au dépôt, ou le dépôt a été renommé/transféré. Accordez à nouveau l’accès à l’application et la prochaine demande de réattribution réussira.
Les clients doivent accepter l’invitation GitHub depuis leur page de notifications ou en cliquant sur le lien dans leur e-mail. Tant qu’ils n’acceptent pas, ils restent “invités” mais ne peuvent pas cloner le dépôt. La subvention est encore delivered du point de vue de Dodo Payments ; c’est l’invitation que nous émettons.
Last modified on May 14, 2026