Entitlement Discord

​

Cosa viene fornito

• Il cliente collega il proprio account Discord dal Customer Portal. L’email di conferma del pagamento contrassegna l’entitlement come Azione richiesta e include un link al portale.
• Dopo l’autorizzazione, il bot di Dodo Payments lo aggiunge al tuo server oppure individua la sua appartenenza esistente e assegna il ruolo configurato.
• Se non selezioni un ruolo, il cliente ottiene solo l’appartenenza 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 Discord non è ancora connesso per la tua attività, fai clic su Connect Discord.

Discord si apre in una nuova scheda. Accedi, scegli il server che vuoi proteggere e approva le autorizzazioni del bot su quel server: Manage Roles, Kick Members e Create Invite.

Quando Discord reindirizza alla pagina precedente, una pagina di conferma mostra che il server è connesso.

3

Pick a Server and Role

Tornato nel dashboard, seleziona il Server che hai connesso. Per assegnare un ruolo al momento della consegna, selezionalo in Role. Per concedere solo l’appartenenza al server, lascia Role impostato su No specific role. Inserisci un Name per l’entitlement e fai clic su Create Entitlement.

4

Attach It to a Product

L’entitlement è stato salvato ed è disponibile per essere associato a qualsiasi prodotto. Consulta Associare gli entitlement ai prodotti.

​

Flusso del cliente

1. Il cliente completa il checkout.
2. Dodo Payments crea un grant con stato Pending. Dodo Payments prova a creare subito un URL di autorizzazione Discord e lo memorizza in oauth_url. Se l’operazione non riesce, oauth_url rimane null finché il cliente non avvia il flusso di accettazione.
3. L’e-mail di conferma del pagamento indica l’entitlement come Azione richiesta e rimanda al Customer Portal. Nel portale, il cliente fa clic su Connetti sull’entitlement.
4. Il cliente autorizza Dodo Payments su Discord. Il bot lo aggiunge al server e assegna il ruolo configurato, mentre il grant passa a Delivered.
5. Quando il grant viene revocato (l’abbonamento viene annullato, messo in pausa, sospeso o scade, il pagamento una tantum viene rimborsato oppure revochi il grant), il bot rimuove il ruolo e rimuove il cliente dal server. Il grant passa a Revoked.

​

Configurazione richiesta

​

Creazione 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',
  },
});

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

​

Webhook

• entitlement_grant.created viene attivato con status: "Pending". oauth_url potrebbe contenere già l’URL di autorizzazione. Se è null, viene valorizzato quando il cliente avvia il flusso di accettazione dal Customer Portal.
• entitlement_grant.delivered viene attivato quando il cliente entra nel server e il ruolo viene assegnato.
• entitlement_grant.revoked viene attivato quando il ruolo viene rimosso e il cliente viene rimosso dal server.

​

Risoluzione dei problemi