Discord Entitlement

​

O que é entregue

• O cliente conecta sua conta Discord por meio de um link OAuth no e-mail de entrega ou portal do cliente.
• Uma vez autorizado, o Dodo Payments os adiciona ao seu servidor (ou encontra sua associação existente) e atribui o papel que você configurou.
• Se você não escolher um papel específico, apenas a associação ao servidor é concedida.

​

Conectar Discord

1

Open Entitlements

No painel do Dodo Payments, vá para Entitlements e clique em + para iniciar uma nova titularidade.

2

Pick Discord

Escolha Discord Access como a integração. Se você ainda não conectou o Discord para o seu negócio, será solicitado que Conecte o Discord.

Ao clicar, o Discord será aberto em uma nova aba. Faça login, escolha o servidor que deseja proteger e confirme as permissões do bot (Gerenciar Papéis, Expulsar Membros, Criar Convite) nesse servidor.

Quando o Discord redirecionar de volta, você verá uma confirmação de que o servidor está conectado.

3

Pick a server and role

De volta ao painel, selecione o servidor (guilda) que você acabou de conectar. Opcionalmente escolha um papel para atribuir na entrega, ou deixe em branco para conceder apenas a associação ao servidor. Dê um nome à titularidade e clique em Criar Titularidade.

4

Save the entitlement

Salve a titularidade. Agora está disponível para anexar a qualquer produto.

​

Fluxo do cliente

1. O cliente conclui o checkout.
2. Dodo Payments cria uma concessão com o status Pending. Seu oauth_url é null até que o cliente inicie o fluxo de aceitação, momento em que ele é preenchido com uma URL de autorização do Discord.
3. O cliente recebe um e-mail com um botão “Entrar no Discord” (o link OAuth). O link também fica visível no Customer Portal.
4. Depois que o cliente autoriza, o bot o adiciona ao servidor e atribui a função configurada. A concessão muda para Delivered.
5. Se a assinatura for cancelada, pausada ou expirar, ou se o merchant revogar manualmente, o bot remove a função e 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',
  },
});

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 é acionado com status: "Pending". oauth_url é null neste momento — ele é preenchido quando o cliente inicia o fluxo de aceitação a partir do e-mail de entrega ou do Customer Portal.
• entitlement_grant.delivered é acionado quando a função é atribuída.
• entitlement_grant.revoked é acionado quando a função é removida.

​

Solução de problemas