Discord-Berechtigung

​

Was bereitgestellt wird

• Der Kunde verbindet sein Discord-Konto über das Customer Portal. In der E-Mail zur Zahlungsbestätigung wird die Berechtigung als Action Required markiert und auf das Portal verwiesen.
• Nach der Autorisierung fügt der Dodo Payments-Bot den Kunden zu Ihrem Server hinzu oder findet seine bestehende Mitgliedschaft und weist ihm die von Ihnen konfigurierte Rolle zu.
• Wenn Sie keine Rolle auswählen, erhält der Kunde nur die Servermitgliedschaft.

​

Discord verbinden

1

Open Entitlements

Gehen Sie im Dodo Payments-Dashboard zu Entitlements und klicken Sie auf +, um eine neue Berechtigung zu erstellen.

2

Pick Discord

Wählen Sie Discord Access als Integration aus. Wenn Discord für Ihr Unternehmen noch nicht verbunden ist, klicken Sie auf Connect Discord.

Discord wird in einem neuen Tab geöffnet. Melden Sie sich an, wählen Sie den Server aus, den Sie schützen möchten, und genehmigen Sie die Berechtigungen des Bots auf diesem Server: Manage Roles, Kick Members und Create Invite.

Wenn Discord zurückleitet, bestätigt eine Bestätigungsseite, dass der Server verbunden ist.

3

Pick a Server and Role

Wählen Sie im Dashboard den verbundenen Server aus. Um bei der Bereitstellung eine Rolle zuzuweisen, wählen Sie sie unter Role aus. Um ausschließlich die Servermitgliedschaft zu gewähren, lassen Sie Role auf No specific role gesetzt. Geben Sie unter Name einen Namen für die Berechtigung ein und klicken Sie auf Create Entitlement.

4

Attach It to a Product

Die Berechtigung wird gespeichert und kann jedem Produkt zugewiesen werden. Weitere Informationen finden Sie unter Berechtigungen Produkten zuweisen.

​

Kundenablauf

1. Der Kunde schließt den Checkout ab.
2. Dodo Payments erstellt eine Berechtigung im Status Pending. Dodo Payments versucht sofort, eine Discord-Autorisierungs-URL zu erstellen, und speichert sie in oauth_url. Falls dies fehlschlägt, bleibt oauth_url auf null, bis der Kunde den Annahmeablauf startet.
3. Die E-Mail zur Zahlungsbestätigung führt die Berechtigung als Aktion erforderlich auf und enthält einen Link zum Customer Portal. Dort klickt der Kunde bei der Berechtigung auf Verbinden.
4. Der Kunde autorisiert Dodo Payments in Discord. Der Bot fügt ihn zum Server hinzu und weist ihm die konfigurierte Rolle zu. Die Berechtigung wechselt zu Delivered.
5. Wenn die Berechtigung widerrufen wird (das Abonnement gekündigt, pausiert, ausgesetzt oder abgelaufen ist, die einmalige Zahlung erstattet wurde oder Sie die Berechtigung widerrufen), entfernt der Bot die Rolle und den Kunden aus dem Server. Die Berechtigung wechselt zu Revoked.

​

Erforderliche Konfiguration

​

Über die API erstellen

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 wird mit status: "Pending" ausgelöst. oauth_url kann die Autorisierungs-URL bereits enthalten. Wenn der Wert null ist, wird er ausgefüllt, sobald der Kunde den Annahmeablauf über das Customer Portal startet.
• entitlement_grant.delivered wird ausgelöst, sobald der Kunde dem Server beigetreten ist und die Rolle zugewiesen wurde.
• entitlement_grant.revoked wird ausgelöst, wenn die Rolle entfernt und der Kunde aus dem Server entfernt wurde.

​

Fehlerbehebung