Autorización de Discord

​

Qué se entrega

• El cliente conecta su cuenta de Discord desde el Customer Portal. El correo de confirmación del pago marca la entitlement como Action Required y enlaza al portal.
• Después de autorizar, el bot de Dodo Payments lo añade a tu servidor o encuentra su membresía existente y le asigna el rol que configuraste.
• Si no eliges un rol, el cliente solo obtiene la membresía del servidor.

​

Conectar Discord

1

Open Entitlements

En el dashboard de Dodo Payments, ve a Entitlements y haz clic en + para iniciar una nueva entitlement.

2

Pick Discord

Elige Discord Access como integración. Si Discord todavía no está conectado para tu empresa, haz clic en Connect Discord.

Discord se abre en una pestaña nueva. Inicia sesión, elige el servidor que quieres proteger y aprueba los permisos del bot en ese servidor: Manage Roles, Kick Members y Create Invite.

Cuando Discord redirige de vuelta, una página de confirmación muestra que el servidor está conectado.

3

Pick a Server and Role

De vuelta en el dashboard, selecciona el Server que conectaste. Para asignar un rol al entregar, selecciónalo en Role. Para conceder únicamente la membresía del servidor, deja Role establecido en No specific role. Introduce un Name para la entitlement y haz clic en Create Entitlement.

4

Attach It to a Product

La entitlement se guarda y está disponible para asociarla a cualquier producto. Consulta Asociar entitlements a productos.

​

Flujo del cliente

1. El cliente completa el checkout.
2. Dodo Payments crea un grant en estado Pending. Dodo Payments intenta crear de inmediato una URL de autorización de Discord y la almacena en oauth_url. Si 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 el entitlement como Acción requerida y enlaza al Customer Portal. En el portal, el cliente hace clic en Conectar en el entitlement.
4. El cliente autoriza a Dodo Payments en Discord. El bot lo añade al servidor y le asigna el rol configurado, y el grant pasa a Delivered.
5. Cuando se revoca el grant (se cancela, pausa, suspende o vence la suscripción, se reembolsa el pago único o revocas el grant), el bot elimina el rol y al cliente del servidor. El grant pasa a Revoked.

​

Configuración necesaria

​

Crear mediante 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: 'Patrons Discord Role',
  integration_type: 'discord',
  integration_config: {
    guild_id: '123456789012345678',
    role_id: '987654321098765432',
  },
});

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="Patrons Discord Role",
    integration_type="discord",
    integration_config={
        "guild_id": "123456789012345678",
        "role_id": "987654321098765432",
    },
)

// 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("Patrons Discord Role"),
  IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeDiscord),
  IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
    dodopayments.IntegrationConfigDiscordConfigParam{
      GuildID: dodopayments.F("123456789012345678"),
      RoleID:  dodopayments.F("987654321098765432"),
    },
  ),
})

​

Webhooks

• entitlement_grant.created se activa con status: "Pending". oauth_url puede contener ya la URL de autorización. Si es null, se completa cuando el cliente inicia el flujo de aceptación desde el Customer Portal.
• entitlement_grant.delivered se activa cuando el cliente se une al servidor y se asigna el rol.
• entitlement_grant.revoked se activa cuando se elimina el rol y el cliente se elimina del servidor.

​

Solución de problemas