Derechos de GitHub

​

Qué se entrega

• El cliente conecta su cuenta de GitHub desde el Customer Portal. Esto vincula su cuenta de GitHub con la compra.
• Dodo Payments invita a esa cuenta a tu repositorio con el nivel de permiso configurado. El cliente obtiene acceso después de aceptar la invitación en GitHub. Si el cliente es propietario del repositorio, no se necesita ninguna invitación.
• La cancelación, el reembolso o una revocación manual elimina al colaborador y cancela cualquier invitación pendiente.

​

Conectar GitHub

1

Open Entitlements

En el panel de Dodo Payments, ve a Entitlements y haz clic en + para comenzar un nuevo entitlement.

2

Pick GitHub

Elige GitHub Access como integración. Si GitHub aún no está conectado, haz clic en Connect GitHub.

GitHub se abre en una pestaña nueva. Inicia sesión e instala Dodo Payments GitHub App en la organización o cuenta de usuario propietaria del repositorio. Puedes conceder acceso a All repositories o Only select repositories. Si seleccionas repositorios, incluye todos los repositorios cuyo acceso quieras restringir.

Cuando GitHub redirige de vuelta, una página de confirmación muestra que la cuenta está conectada.

3

Pick a Repository and Permission

De vuelta en el panel, selecciona el Repository al que el entitlement concede acceso y, después, selecciona el nivel de Permission. El selector de repositorios solo muestra los repositorios a los que GitHub App puede acceder. Introduce un Name para el entitlement y haz clic en Create Entitlement.

4

Attach It to a Product

Asocia el entitlement a cualquier producto. Los clientes que compren ese producto recibirán una invitación de GitHub después de conectar su cuenta de GitHub.

​

Niveles de permiso

​

Flujo del cliente

1. El cliente completa el checkout.
2. Dodo Payments crea una concesión con el estado Pending. Dodo Payments intenta crear de inmediato una URL de autorización de GitHub y la almacena en oauth_url. Si esto falla, oauth_url permanece en null hasta que el cliente inicia el flujo de aceptación.
3. El correo electrónico de confirmación del pago muestra la concesión como Acción requerida y enlaza al Customer Portal. En el portal, el cliente hace clic en Conectar y autoriza con GitHub. Un enlace de autorización caduca después de 30 minutos, y el Customer Portal genera uno nuevo cuando el cliente regresa.
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. Si GitHub rechaza la invitación, la concesión no se entrega.
5. Si se cancela la suscripción, se reembolsa el pago o se revoca la concesión, Dodo Payments elimina al cliente como colaborador y cancela cualquier invitación pendiente.

​

Configuración necesaria

​

Crear vía API

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode',
});

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

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

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

// client is a *dodopayments.Client, for example from
// dodopayments.NewClient(option.WithEnvironmentTestMode()); ctx is a context.Context.
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(dodopayments.GitHubPermissionPull),
    },
  ),
})

​

Webhooks

• entitlement_grant.created se activa con status: "Pending". oauth_url puede contener ya la URL de autorización de GitHub. Si es null, se completa una vez que el cliente inicia el flujo de aceptación desde el Customer Portal.
• entitlement_grant.delivered se activa una vez creada la invitación al colaborador.
• entitlement_grant.revoked se activa cuando se retira el acceso. Si desinstalas la GitHub App, Dodo Payments revoca las concesiones pendientes y entregadas de esa instalación con revocation_reason: platform_external.
• entitlement_grant.failed se activa con error_code: "GRANT_ACCESS_FAILED" si Dodo Payments no puede añadir al cliente al repositorio, por ejemplo, porque la GitHub App perdió el acceso a este.

​

Solución de problemas