Discord-Berechtigung

​

Was geliefert wird

• Der Kunde verbindet sein Discord-Konto über einen OAuth-Link in seiner Liefer-E-Mail oder im Kundenportal.
• Sobald sie autorisieren, fügt Dodo Payments sie Ihrem Server hinzu (oder findet ihre bestehende Mitgliedschaft) und weist die von Ihnen konfigurierte Rolle zu.
• Wenn Sie keine spezifische Rolle ausgewählt haben, wird nur die Servermitgliedschaft gewährt.

​

Discord verbinden

1

Open Entitlements

Gehen Sie in Ihrem Dodo Payments-Dashboard zu Berechtigungen und klicken Sie auf +, um eine neue Berechtigung zu starten.

2

Pick Discord

Wählen Sie Discord-Zugang als Integration. Wenn Sie Discord noch nicht für Ihr Unternehmen verbunden haben, werden Sie aufgefordert, Discord zu verbinden.

Durch Klicken öffnet sich Discord in einem neuen Tab. Melden Sie sich an, wählen Sie den Server aus, den Sie schützen möchten, und bestätigen Sie die Berechtigungen des Bots (Rollen verwalten, Mitglieder kicken, Einladung erstellen) auf diesem Server.

Wenn Discord zurückleitet, sehen Sie eine Bestätigung, dass der Server verbunden ist.

3

Pick a server and role

Zurück im Dashboard wählen Sie den Server (Gilde), den Sie gerade verbunden haben. Optional wählen Sie eine Rolle, die bei Lieferung zugewiesen werden soll, oder lassen sie leer, um nur die Servermitgliedschaft zu gewähren. Geben Sie der Berechtigung einen Namen und klicken Sie auf Berechtigung erstellen.

4

Save the entitlement

Speichern Sie die Berechtigung. Sie steht nun zur Anbindung an beliebige Produkte zur Verfügung.

​

Kundenablauf

1. Der Kunde schließt den Checkout ab.
2. Dodo Payments erstellt einen grant mit dem Status Pending. Sein oauth_url ist null, bis der Kunde den accept flow startet. Zu diesem Zeitpunkt wird er mit einer Discord-Autorisierungs-URL befüllt.
3. Der Kunde erhält eine E-Mail mit einer Schaltfläche „Join the Discord“ (dem OAuth-Link). Der Link ist auch im Customer Portal sichtbar.
4. Nachdem der Kunde die Autorisierung erteilt hat, fügt der Bot ihn dem Server hinzu und weist ihm die konfigurierte Rolle zu. Der grant wechselt zu Delivered.
5. Wenn das Abonnement gekündigt, pausiert oder abgelaufen ist oder der Merchant es manuell widerruft, entfernt der Bot die Rolle und der grant wechselt zu Revoked.

​

Erforderliche Konfiguration

​

Erstellen über 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 wird mit status: "Pending" ausgelöst. oauth_url ist zu diesem Zeitpunkt null – er wird ausgefüllt, sobald der Kunde den accept flow über seine Zustellungs-E-Mail oder das Customer Portal startet.
• entitlement_grant.delivered wird ausgelöst, sobald die Rolle zugewiesen wurde.
• entitlement_grant.revoked wird ausgelöst, wenn die Rolle entfernt wird.

​

Fehlerbehebung