Droit Discord

​

Ce qui est livré

• Le client connecte son compte Discord via un lien OAuth dans son email de livraison ou son portail client.
• Une fois autorisé, Dodo Payments l’ajoute à votre serveur (ou trouve son adhésion existante) et lui attribue le rôle que vous avez configuré.
• Si vous n’avez pas choisi de rôle spécifique, seule l’adhésion au serveur est accordée.

​

Connecter Discord

1

Open Entitlements

Dans votre tableau de bord Dodo Payments, allez à Droits et cliquez sur + pour démarrer un nouveau droit.

2

Pick Discord

Choisissez Accès Discord comme intégration. Si vous n’avez pas encore connecté Discord pour votre entreprise, vous serez invité à Connecter Discord.

En cliquant, Discord s’ouvre dans un nouvel onglet. Connectez-vous, choisissez le serveur que vous souhaitez restreindre, et confirmez les permissions du bot (Gérer les rôles, Expulser les membres, Créer une invitation) sur ce serveur.

Lorsque Discord redirige, vous verrez une confirmation que le serveur est connecté.

3

Pick a server and role

De retour dans le tableau de bord, sélectionnez le serveur (guild) que vous venez de connecter. Choisissez éventuellement un rôle à attribuer à la livraison, ou laissez-le vide pour accorder uniquement l’adhésion au serveur. Donnez un nom au droit et cliquez sur Créer un droit.

4

Save the entitlement

Enregistrez le droit. Il est maintenant disponible pour être attaché à n’importe quel produit.

​

Flux client

1. Le client termine l’achat.
2. Dodo Payments crée un droit avec le statut pending avec un oauth_url pointant vers Discord.
3. Le client reçoit un email avec un bouton “Rejoindre le Discord” (le lien OAuth). Le lien est également visible dans son portail client.
4. Après que le client a autorisé, le bot les ajoute au serveur et attribue le rôle configuré. Le droit passe à delivered.
5. Si l’abonnement est annulé, suspendu ou expire, ou si le marchand révoque manuellement, le bot retire le rôle et le droit passe à revoked.

​

Configuration requise

​

Créer 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 se déclenche avec status: "pending" et un oauth_url pour que le client autorise.
• entitlement_grant.delivered se déclenche une fois le rôle attribué.
• entitlement_grant.revoked se déclenche lorsque le rôle est retiré.

​

Dépannage