Saltar al contenido 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.

El derecho de GitHub añade a un cliente que paga como colaborador en un repositorio privado. Tú eliges el nivel de permiso (pull, push, triage, maintain, o admin) y Dodo Payments se encarga de la invitación, el seguimiento de aceptación y la eliminación al cancelarse.

​
Qué se entrega

  • El cliente es invitado a tu repositorio de GitHub a través de un flujo OAuth que vincula su cuenta de GitHub con la compra.
  • Una vez aceptado, GitHub les otorga acceso como colaboradores en el nivel de permiso configurado.
  • La cancelación, el reembolso o la revocación manual eliminan al colaborador.
Usos comunes incluyen productos con código fuente disponible, plantillas de pago, repositorios de código de cursos y SDKs de clientes con restricciones.

​
Conectar GitHub

1

Open Entitlements

En tu panel de Dodo Payments, ve a Derechos y haz clic en + para iniciar un nuevo derecho.
2

Pick GitHub

Elige Acceso a GitHub como la integración. Si GitHub aún no está conectado, se te pedirá que Conectes GitHub.
Nuevo panel de derechos solicitando al comerciante que conecte GitHub
Al hacer clic se abre GitHub en una nueva pestaña. Inicia sesión, luego instala la aplicación de GitHub de Dodo Payments en la organización o cuenta de usuario que posee el repositorio. Puedes otorgar acceso a todos los repositorios o solo a aquellos que pretendes restringir.
Página de instalación y autorización de GitHub con opciones de Todos los repositorios y Solo repositorios seleccionados
Cuando GitHub redirige de vuelta, verás una confirmación de que la cuenta está conectada.
Página de confirmación de acceso a GitHub conectado con éxito
3

Pick a repository and permission

De vuelta en el panel, elige el repositorio al que el derecho debe otorgar acceso y selecciona el nivel de permiso. El selector de repositorios solo muestra aquellos a los que la aplicación de GitHub tiene acceso. Dale un nombre al derecho y haz clic en Crear Derecho.
Formulario de derechos de GitHub con acceso a GitHub conectado, selector de repositorios, menú desplegable de permisos y campo de nombre
4

Save the entitlement

Guarda y adjunta el derecho a cualquier producto. Los clientes que compren ese producto recibirán una invitación de GitHub al entregarse.

​
Niveles de permiso

Se aplican los permisos estándar del repositorio de GitHub:
PermisoMejor para
pullAcceso de solo lectura. Los clientes pueden clonar, obtener y ver el repositorio.
triageAcceso de lectura más la capacidad de gestionar problemas y solicitudes de extracción.
pushAcceso de lectura + escritura. Los clientes pueden hacer push de ramas y abrir solicitudes de extracción.
maintainAcceso de push más la gestión de configuraciones del repositorio (excluyendo las sensibles).
adminControl completo del repositorio. Úsalo con precaución.
Otorga el menor privilegio que se ajuste a tu caso de uso. La mayoría de los escenarios de contenido de pago solo necesitan pull.

​
Flujo del cliente

  1. El cliente completa la compra.
  2. Dodo Payments crea una concesión en estado pending con un oauth_url para que el cliente vincule su cuenta de GitHub.
  3. El cliente autoriza a través del enlace en su correo electrónico o portal de cliente.
  4. Dodo Payments invita a la cuenta de GitHub del cliente al repositorio en el permiso configurado. La concesión pasa a delivered una vez creada la invitación.
  5. Si la suscripción se cancela, se reembolsa o se revoca, el cliente es eliminado como colaborador.

​
Configuración requerida

CampoRequeridoDescripción
target_idSíEl repositorio al que invitar al cliente. El selector de repositorios del panel completa esto por ti.
permissionSíUno de pull, push, triage, maintain, admin.

​
Crear vía API

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

​
Webhooks

Los eventos de webhook estándar entitlement_grant.* cubren el flujo de GitHub:
  • entitlement_grant.created incluye el oauth_url para la autorización de GitHub.
  • entitlement_grant.delivered se activa una vez creada la invitación de colaborador.
  • entitlement_grant.failed se activa con error_code: "github_permission_denied" (o similar) si la aplicación de GitHub perdió acceso al repositorio.

​
Solución de problemas

La aplicación de GitHub de Dodo Payments debe estar instalada en la organización o usuario que posee el repositorio. Abre Derechos → Integraciones → GitHub y reinstala la aplicación, asegurándote de otorgar acceso a los repositorios relevantes.
La instalación de la aplicación de GitHub ya no tiene acceso al repositorio, o el repositorio fue renombrado/transferido. Re-otorga acceso a la aplicación y el próximo reotorgamiento tendrá éxito.
Los clientes deben aceptar la invitación de GitHub desde su página de notificaciones o haciendo clic en el enlace en su correo electrónico. Hasta que acepten, permanecerán “invitados” pero no podrán clonar el repositorio. Desde la perspectiva de Dodo Payments, la concesión aún es delivered; la invitación es lo que emitimos.
Last modified on May 14, 2026