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 finalise le paiement.
2. Dodo Payments crée une autorisation avec le statut Pending. Sa oauth_url est null jusqu’à ce que le client commence le flux d’acceptation, auquel moment elle est renseignée avec une URL d’autorisation Discord.
3. Le client reçoit un e-mail contenant un bouton « Rejoindre Discord » (le lien OAuth). Le lien est également visible dans son portail client.
4. Une fois que le client s’est autorisé, le bot l’ajoute au serveur et lui attribue le rôle configuré. L’autorisation passe à Delivered.
5. Si l’abonnement est annulé, mis en pause ou expire, ou si le marchand le révoque manuellement, le bot retire le rôle et l’autorisation 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". oauth_url est null à ce stade — elle est renseignée une fois que le client commence le flux d’acceptation depuis son e-mail de livraison ou son portail client.
• 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