Hoppa till huvudinnehåll

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.

Discord-rättigheten lägger till en betalande kund på din server (och tilldelar honom eventuellt en roll) så snart deras prenumeration blir aktiv eller deras engångsköp godkänns. Avbokningar, återbetalningar och planändringar återkallar rollen automatiskt.

Vad som levereras

  • Kunden kopplar sitt Discord-konto via en OAuth-länk i sitt leveransmejl eller kundportal.
  • När de godkänner, lägger Dodo Payments till dem i din server (eller hittar deras befintliga medlemskap) och tilldelar den roll du har konfigurerat.
  • Om du inte valt en specifik roll, beviljas endast servermedlemskap.
Denna integration är idealisk för betalda gemenskaper, stödjande förmåner och kanalåtkomst i olika nivåer.

Anslut Discord

1

Open Entitlements

I din Dodo Payments-instrumentpanel, gå till Rättigheter och klicka på + för att starta en ny rättighet.
2

Pick Discord

Välj Discord Access som integration. Om du ännu inte har anslutit Discord för ditt företag, uppmanas du att Anslut Discord.
New entitlement panel prompting the merchant to connect Discord
Genom att klicka öppnas Discord i en ny flik. Logga in, välj den server du vill begränsa åtkomst till, och bekräfta botens behörigheter (Hantera roller, Sparka medlemmar, Skapa inbjudan) på den servern.
Discord OAuth screen asking which server to add the Dodo Payments bot toDiscord bot permission confirmation screen
När Discord omdirigerar tillbaka, ser du en bekräftelse på att servern är ansluten.
Discord Access connected successfully confirmation page
3

Pick a server and role

Tillbaka i instrumentpanelen, välj den server (guild) du just anslutit. Välj eventuellt en roll att tilldela vid leverans, eller lämna det tomt för att endast bevilja servermedlemskap. Ge rättigheten ett namn och klicka Skapa rättighet.
New Entitlement - Discord Access form with connected server, server picker, role dropdown, and name field
4

Save the entitlement

Spara rättigheten. Den är nu tillgänglig att koppla till vilken produkt som helst.

Kundflöde

  1. Kunden avslutar köpet.
  2. Dodo Payments skapar en beviljning i pending status med en oauth_url som pekar på Discord.
  3. Kunden får ett mejl med en “Gå med i Discord”-knapp (OAuth-länken). Länken är också synlig i deras kundportal.
  4. Efter kundens godkännande, lägger boten till dem på servern och tilldelar den konfigurerade rollen. Beviljningen flyttas till delivered.
  5. Om prenumerationen annulleras, pausas eller löper ut, eller om köpmannen manuellt återkallar, tar boten bort rollen och beviljningen flyttas till revoked.
Se till att Dodo Payments-botens roll är placerad ovanför rollen du tilldelar. Discord förhindrar att bots tilldelar roller rankade högre än sin egen.

Nödvändig konfiguration

FältObligatorisktBeskrivning
guild_idJaDiscord-serverns ID. Instrumentpanelens väljare fyller i detta åt dig.
role_idNejRollen att tilldela vid leverans. Utelämna för enbart servermedlemskapstillträde.

Skapa 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',
  },
});

Webhooks

Prenumerera på entitlement_grant.* webhook-händelser för att spåra Discord-beviljningar:
  • entitlement_grant.created avfyras med status: "pending" och en oauth_url för kunden att godkänna.
  • entitlement_grant.delivered avfyras när rollen har tilldelats.
  • entitlement_grant.revoked avfyras när rollen tas bort.

Felsökning

Beviljningen är i pending tills kunden slutför OAuth-flödet. Kontrollera rättighetens lista över beviljningar och bekräfta om de klickade på OAuth-länken. Skicka om leveransmejlet vid behov.
Se till att Dodo Payments-boten förblir i servern, har Manage Roles behörighet, och är placerad ovanför rollen som tilldelas. Att spara om rättigheten kör validering igen.
Discord skickar direkt borttagningar av roller, men den lokala Discord-klienten hos kunden kan hålla cache. De bör återansluta eller uppdatera; server-sidans tillstånd är korrekt.
Last modified on May 14, 2026