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 eine Zuweisung im pending-Status mit einem oauth_url, der auf Discord verweist.
3. Der Kunde erhält eine E-Mail mit einem „Discord beitreten“-Button (dem OAuth-Link). Der Link ist auch in seinem Kundenportal sichtbar.
4. Nachdem der Kunde autorisiert hat, fügt der Bot sie dem Server hinzu und weist die konfigurierte Rolle zu. Die Zuweisung wechselt zu delivered.
5. Wenn das Abonnement gekündigt, pausiert oder abgelaufen ist oder wenn der Händler manuell widerruft, entfernt der Bot die Rolle und die Zuweisung 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" und einem oauth_url für den Kunden zur Autorisierung ausgelöst.
• entitlement_grant.delivered wird ausgelöst, sobald die Rolle zugewiesen ist.
• entitlement_grant.revoked wird ausgelöst, wenn die Rolle entfernt wird.

​

Fehlerbehebung