Droit Discord

​

Ce qui est fourni

• Le client connecte son compte Discord depuis le Customer Portal. L’e-mail de confirmation du paiement indique que le droit Action Required et contient un lien vers le portail.
• Après son autorisation, le bot Dodo Payments l’ajoute à votre serveur ou détecte son appartenance existante, puis lui attribue le rôle que vous avez configuré.
• Si vous ne sélectionnez aucun rôle, le client devient uniquement membre du serveur.

​

Connecter Discord

1

Open Entitlements

Dans le tableau de bord Dodo Payments, accédez à Entitlements et cliquez sur + pour commencer un nouveau droit.

2

Pick Discord

Choisissez Discord Access comme intégration. Si Discord n’est pas encore connecté pour votre entreprise, cliquez sur Connect Discord.

Discord s’ouvre dans un nouvel onglet. Connectez-vous, sélectionnez le serveur dont vous souhaitez restreindre l’accès, puis approuvez les permissions du bot sur ce serveur : Manage Roles, Kick Members et Create Invite.

Lorsque Discord vous redirige vers le tableau de bord, une page de confirmation indique que le serveur est connecté.

3

Pick a Server and Role

De retour dans le tableau de bord, sélectionnez le Server que vous avez connecté. Pour attribuer un rôle lors de la fourniture, sélectionnez-le sous Role. Pour accorder uniquement l’appartenance au serveur, laissez Role défini sur No specific role. Saisissez un Name pour le droit, puis cliquez sur Create Entitlement.

4

Attach It to a Product

Le droit est enregistré et peut être associé à n’importe quel produit. Consultez Associer des droits à des produits.

​

Parcours client

1. Le client termine le checkout.
2. Dodo Payments crée une attribution avec le statut Pending. Dodo Payments essaie immédiatement de créer une URL d’autorisation Discord et la stocke dans oauth_url. En cas d’échec, oauth_url reste null jusqu’à ce que le client démarre le flux d’acceptation.
3. L’e-mail de confirmation du paiement répertorie l’avantage comme Action requise et contient un lien vers le Customer Portal. Dans le portail, le client clique sur Connecter pour l’avantage.
4. Le client autorise Dodo Payments sur Discord. Le bot l’ajoute au serveur et lui attribue le rôle configuré, et l’attribution passe à Delivered.
5. Lorsque l’attribution est révoquée (l’abonnement est annulé, mis en pause, suspendu ou arrive à expiration, le paiement unique est remboursé, ou vous révoquez l’attribution), le bot supprime le rôle et retire le client du serveur. L’attribution passe à Revoked.

​

Configuration requise

​

Créer via l’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 se déclenche avec status: "Pending". oauth_url peut déjà contenir l’URL d’autorisation. S’il contient null, il est renseigné lorsque le client démarre le flux d’acceptation depuis le Customer Portal.
• entitlement_grant.delivered se déclenche une fois que le client a rejoint le serveur et que le rôle lui a été attribué.
• entitlement_grant.revoked se déclenche lorsque le rôle est supprimé et que le client est retiré du serveur.

​

Dépannage