Discord Entitlement

​

O que é entregue

• O cliente conecta a conta do Discord pelo Customer Portal. O e-mail de confirmação do pagamento marca o entitlement como Action Required e inclui um link para o portal.
• Depois que o cliente autoriza, o bot do Dodo Payments o adiciona ao seu servidor ou encontra a associação existente e atribui a função que você configurou.
• Se você não escolher uma função, o cliente recebe apenas a associação ao servidor.

​

Conectar Discord

1

Open Entitlements

No dashboard do Dodo Payments, acesse Entitlements e clique em + para iniciar um novo entitlement.

2

Pick Discord

Escolha Discord Access como integração. Se o Discord ainda não estiver conectado à sua empresa, clique em Connect Discord.

O Discord será aberto em uma nova aba. Entre, escolha o servidor que deseja proteger e aprove as permissões do bot nesse servidor: Manage Roles, Kick Members e Create Invite.

Quando o Discord redirecionar de volta, uma página de confirmação mostrará que o servidor está conectado.

3

Pick a Server and Role

De volta ao dashboard, selecione o Server que você conectou. Para atribuir uma função na entrega, selecione-a em Role. Para conceder apenas a associação ao servidor, mantenha Role definido como No specific role. Insira um Name para o entitlement e clique em Create Entitlement.

4

Attach It to a Product

O entitlement foi salvo e está disponível para ser associado a qualquer produto. Consulte Associar Entitlements a produtos.

​

Fluxo do cliente

1. O cliente conclui o checkout.
2. Dodo Payments cria uma concessão com o status Pending. Dodo Payments tenta criar imediatamente uma URL de autorização do Discord e a armazena em oauth_url. Se isso falhar, oauth_url permanece como null até que o cliente inicie o fluxo de aceitação.
3. O e-mail de confirmação do pagamento lista o benefício como Ação necessária e inclui um link para o Customer Portal. No portal, o cliente clica em Conectar no benefício.
4. O cliente autoriza Dodo Payments no Discord. O bot o adiciona ao servidor e atribui a função configurada, e a concessão muda para Delivered.
5. Quando a concessão é revogada (a assinatura é cancelada, pausada, colocada em espera ou expira, o pagamento único é reembolsado ou você revoga a concessão), o bot remove a função e remove o cliente do servidor. A concessão muda para Revoked.

​

Configuração necessária

​

Criar via 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 é acionado com status: "Pending". oauth_url pode já conter a URL de autorização. Se for null, ele será preenchido assim que o cliente iniciar o fluxo de aceitação pelo Customer Portal.
• entitlement_grant.delivered é acionado assim que o cliente entra no servidor e a função é atribuída.
• entitlement_grant.revoked é acionado quando a função é removida e o cliente é removido do servidor.

​

Solução de problemas