Entitlement Discord

​

Cosa viene fornito

• Il cliente collega il proprio account Discord tramite un link OAuth nell’email di consegna o nel customer portal.
• Dopo l’autorizzazione, Dodo Payments lo aggiunge al tuo server (o trova la sua iscrizione esistente) e assegna il ruolo configurato.
• Se non hai scelto un ruolo specifico, viene concesso il solo accesso al server.

​

Collega Discord

1

Open Entitlements

Nel dashboard di Dodo Payments, vai su Entitlements e fai clic su + per iniziare un nuovo entitlement.

2

Pick Discord

Scegli Discord Access come integrazione. Se non hai ancora collegato Discord alla tua attività, ti verrà richiesto di fare clic su Connect Discord.

Facendo clic si apre Discord in una nuova scheda. Accedi, seleziona il server che vuoi proteggere e conferma i permessi del bot (Manage Roles, Kick Members, Create Invite) su quel server.

Quando Discord reindirizza alla pagina precedente, vedrai una conferma che il server è collegato.

3

Pick a server and role

Tornato nel dashboard, seleziona il server (guild) che hai appena collegato. Facoltativamente, scegli un ruolo da assegnare al momento della consegna oppure lascia il campo vuoto per concedere solo l’accesso al server. Assegna all’entitlement un nome e fai clic su Create Entitlement.

4

Save the entitlement

Salva l’entitlement. Ora è disponibile per essere associato a qualsiasi prodotto.

​

Flusso del cliente

1. Il cliente completa il checkout.
2. Dodo Payments crea un grant nello stato pending con un oauth_url che punta a Discord.
3. Il cliente riceve un’email con un pulsante “Join the Discord” (il link OAuth). Il link è visibile anche nel customer portal.
4. Dopo l’autorizzazione del cliente, il bot lo aggiunge al server e assegna il ruolo configurato. Il grant passa a delivered.
5. Se l’abbonamento viene cancellato, messo in pausa o scade, oppure se il merchant lo revoca manualmente, il bot rimuove il ruolo e il grant passa a revoked.

​

Configurazione richiesta

​

Crea tramite 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"),
    },
  ),
})

​

Webhook

• entitlement_grant.created viene attivato con status: "pending" e un oauth_url che il cliente può utilizzare per autorizzarsi.
• entitlement_grant.delivered viene attivato dopo l’assegnazione del ruolo.
• entitlement_grant.revoked viene attivato quando il ruolo viene rimosso.

​

Risoluzione dei problemi