Autorización de Discord

​

Qué se entrega

• El cliente conecta su cuenta de Discord a través de un enlace OAuth en su correo de entrega o en el portal del cliente.
• Una vez autorizados, Dodo Payments los añade a tu servidor (o encuentra su membresía existente) y asigna el rol que configuraste.
• Si no elegiste un rol específico, solo se otorga la membresía del servidor.

​

Conectar Discord

1

Open Entitlements

En tu panel de Dodo Payments, ve a Entitlements y haz clic en + para comenzar una nueva autorización.

2

Pick Discord

Elige Acceso a Discord como la integración. Si aún no has conectado Discord para tu negocio, se te pedirá que Conectes Discord.

Al hacer clic se abre Discord en una nueva pestaña. Inicia sesión, elige el servidor que deseas restringir y confirma los permisos del bot (Administrar Roles, Expulsar Miembros, Crear Invitación) en ese servidor.

Cuando Discord redirija de regreso, verás una confirmación de que el servidor está conectado.

3

Pick a server and role

De nuevo en el panel, selecciona el servidor (guild) que acabas de conectar. Opcionalmente, elige un rol para asignar en la entrega, o déjalo en blanco para otorgar solo membresía del servidor. Dale un nombre a la autorización y haz clic en Crear Autorización.

4

Save the entitlement

Guarda la autorización. Ahora está disponible para adjuntar a cualquier producto.

​

Flujo del cliente

1. El cliente completa el proceso de pago.
2. Dodo Payments crea un grant con el 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 Discord.
3. El cliente recibe un correo electrónico con un botón “Join the Discord” (el enlace de OAuth). El enlace también está visible en su customer portal.
4. Después de que el cliente autoriza, el bot lo añade al servidor y le asigna el rol configurado. El grant pasa a Delivered.
5. Si la suscripción se cancela, se pausa o caduca, o si el merchant la revoca manualmente, el bot elimina el rol y el grant pasa a Revoked.

​

Configuración requerida

​

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

client.entitlements.create(
    name="Patrons Discord Role",
    integration_type="discord",
    integration_config={
        "guild_id": "123456789012345678",
        "role_id": "987654321098765432",
    },
)

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 es null en este punto; se completa cuando el cliente inicia el flujo de aceptación desde su correo electrónico de entrega o customer portal.
• entitlement_grant.delivered se activa una vez asignado el rol.
• entitlement_grant.revoked se activa cuando se elimina el rol.

​

Resolución de problemas