Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
Le droit Discord ajoute un client payant à votre serveur (et éventuellement lui attribue un rôle) dès que son abonnement devient actif ou que son achat unique est validé. Les annulations, remboursements et changements de plan révoquent le rôle automatiquement.
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
Open Entitlements
Dans votre tableau de bord Dodo Payments, allez à Droits et cliquez sur + pour démarrer un nouveau droit.
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é.




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.

Flux client
- Le client termine l’achat.
- Dodo Payments crée un droit avec le statut
pendingavec unoauth_urlpointant vers Discord. - Le client reçoit un email avec un bouton “Rejoindre le Discord” (le lien OAuth). Le lien est également visible dans son portail client.
- Après que le client a autorisé, le bot les ajoute au serveur et attribue le rôle configuré. Le droit passe à
delivered. - 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
| Champ | Obligatoire | Description |
|---|---|---|
guild_id | Oui | L’ID du serveur Discord. Le sélecteur de tableau de bord le remplit pour vous. |
role_id | Non | Le rôle à attribuer lors de la livraison. Omettre pour un accès réservé à l’adhésion. |
Créer via API
Webhooks
Abonnez-vous aux événements de webhookentitlement_grant.* pour suivre les droits Discord :
entitlement_grant.createdse déclenche avecstatus: "pending"et unoauth_urlpour que le client autorise.entitlement_grant.deliveredse déclenche une fois le rôle attribué.entitlement_grant.revokedse déclenche lorsque le rôle est retiré.
Dépannage
Customer never sees the role assigned
Customer never sees the role assigned
Le droit est en
pending jusqu’à ce que le client termine le flux OAuth. Vérifiez la liste des droits d’entitlement et confirmez s’ils ont cliqué sur le lien OAuth. Renvoyez l’email de livraison si nécessaire.Grant moves to failed with permission errors
Grant moves to failed with permission errors
Assurez-vous que le bot Dodo Payments reste sur le serveur, a la permission
Manage Roles, et est positionné au-dessus du rôle en cours d’attribution. Réenregistrer le droit relance la validation.Customer cancelled but still has the role
Customer cancelled but still has the role
Discord propage les suppressions de rôle immédiatement, mais le client Discord local du client peut mettre en cache. Ils doivent se reconnecter ou actualiser ; l’état côté serveur est correct.