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 con stato Pending. Il suo oauth_url è null finché il cliente non avvia il flusso di accettazione; a quel punto viene valorizzato con un URL di autorizzazione Discord.
3. Il cliente riceve un’email con un pulsante “Join the Discord” (il link OAuth). Il link è visibile anche nel loro Customer Portal.
4. Dopo che il cliente ha autorizzato, il bot lo aggiunge al server e assegna il ruolo configurato. Il grant passa a Delivered.
5. Se l’abbonamento viene annullato, messo in pausa o scade, oppure se il commerciante 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". oauth_url è null in questo momento: viene valorizzato quando il cliente avvia il flusso di accettazione dalla propria email di consegna o dal Customer Portal.
• entitlement_grant.delivered viene attivato quando il ruolo viene assegnato.
• entitlement_grant.revoked viene attivato quando il ruolo viene rimosso.

​

Risoluzione dei problemi