Derechos de GitHub

​

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.

​

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.

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.

Cuando GitHub redirige de vuelta, verás una confirmación de que la cuenta está conectada.

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.

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

​

Flujo del cliente

1. El cliente completa el proceso de checkout.
2. Dodo Payments crea una concesión con estado Pending. Su oauth_url es null hasta que el cliente inicia el flujo de aceptación; en ese momento, se completa con una URL de autorización de GitHub.
3. El cliente autoriza mediante el enlace incluido en su correo electrónico o en el portal del cliente.
4. Dodo Payments invita la cuenta de GitHub del cliente al repositorio con el permiso configurado. La concesión pasa a Delivered una vez creada la invitación.
5. Si la suscripción se cancela, reembolsa o revoca, el cliente se elimina como colaborador.

​

Configuración requerida

​

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

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 se activa con status: "Pending" y oauth_url aún en null; la URL de autorización de GitHub se completa una vez que el cliente inicia el flujo de aceptación desde el correo electrónico de entrega o el portal del cliente.
• entitlement_grant.delivered se activa una vez creada la invitación al colaborador.
• entitlement_grant.failed se activa con error_code: "github_permission_denied" (o un valor similar) si la GitHub App pierde el acceso al repositorio.

​

Solución de problemas