Einführung

​

Was sind Entitlements?

​

Verfügbare Integrationen

​

Wie Berechtigungen funktionieren

​

Lebenszyklus der Berechtigung

​

Grant-Verhalten nach Ereignis

​

Erstelle dein erstes Entitlement

1

Open Entitlements

Gehe im Dashboard zu Entitlements und klicke auf +, um ein Entitlement zu erstellen.

2

Pick an Integration

Wähle den Integrationstyp: License Key, Digital Files, Feature Flag, Discord, GitHub, Telegram, Figma, Framer oder Notion. Bei einer Plattformintegration verbinde zuerst dein Konto, falls du dies noch nicht getan hast.

3

Configure Delivery

Fülle die Felder für die Integration aus. GitHub fragt beispielsweise nach einem Repository und einer Berechtigungsstufe, Discord nach einem Server und einer optionalen Rolle und License Key nach einem Aktivierungslimit und einer Lizenzlaufzeit.

4

Save

Klicke auf Create Entitlement. Du kannst das Entitlement jetzt jedem Produkt zuordnen.

​

Entitlements mit Produkten verknüpfen

​

Kundenerlebnis

​

E-Mail und Customer Portal

​

OAuth-basierte Bereitstellung

​

Widerruf

​

Grants verwalten

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
});

// List grants for an entitlement
const grants = await client.entitlements.grants.list('ent_abc123', {
  status: 'Delivered',
});

// Revoke a single grant
await client.entitlements.grants.revoke('entg_xyz789', {
  id: 'ent_abc123',
});

# Assumes client = DodoPayments(bearer_token=os.environ["DODO_PAYMENTS_API_KEY"])
grants = client.entitlements.grants.list(
    "ent_abc123",
    status="Delivered",
)

client.entitlements.grants.revoke(
    "entg_xyz789",
    id="ent_abc123",
)

// Assumes client := dodopayments.NewClient() and ctx := context.Background().
grants, err := client.Entitlements.Grants.List(
  ctx, "ent_abc123",
  dodopayments.EntitlementGrantListParams{
    Status: dodopayments.F(dodopayments.EntitlementGrantListParamsStatusDelivered),
  },
)
if err != nil {
  panic(err.Error())
}
fmt.Println(len(grants.Items))

_, err = client.Entitlements.Grants.Revoke(ctx, "ent_abc123", "entg_xyz789")

​

API-Verwaltung

​

Webhooks

​

Best Practices

• Verwende ein Entitlement pro Bereitstellungskanal. Teile ein Discord-Entitlement nicht über Produkte mit unterschiedlichen Rollenabsichten hinweg. Erstelle ein Entitlement pro Rolle, damit der Widerruf sauber bleibt.
• Teste zuerst im Testmodus. Erstelle das Entitlement, verknüpfe es mit einem Testprodukt, führe einen Checkout durch und beobachte, wie der Grant von Pending zu Delivered wechselt. Kündige anschließend das Testabonnement und bestätige, dass der Grant widerrufen wird.
• Höre auf entitlement_grant.delivered, nicht auf payment.succeeded. Eine Zahlung kann erfolgreich sein, bevor die Bereitstellung abgeschlossen ist, insbesondere bei OAuth-Abläufen. Warte, bis der Grant Delivered erreicht, bevor du abhängige Funktionen in deinen eigenen Systemen freischaltest. Ein Grant, der bei der Erstellung bereitgestellt wird, etwa ein automatisch erfüllter Lizenzschlüssel oder ein Feature Flag, wird stattdessen als entitlement_grant.created mit status: "Delivered" empfangen.
• Behandle entitlement_grant.failed als handlungsrelevant. Ein fehlgeschlagener Grant bedeutet, dass ein Kunde bezahlt, aber keinen Zugriff erhalten hat. Zeige diese Grants deinem Supportteam an oder löse eine erneute Ausstellung aus.
• Ordne revocation_reason deinen Kundenbindungsabläufen zu. Ein subscription_on_hold-Widerruf kann behoben werden, da der Kunde möglicherweise seine Karte aktualisiert. Ein manual-Widerruf ist beabsichtigt. Behandle sie in Kundenmitteilungen unterschiedlich.
• Entziehe den Zugriff nicht bei subscription.past_due. Dieses Ereignis startet eine Kulanzfrist, und der Kunde behält den Zugriff bis zum Ende des Zeitraums. Warte auf subscription.on_hold oder subscription.cancelled.