Lizenzschlüssel

​

Was sind Lizenzschlüssel?

• Softwarelizenzierung: Desktop-Apps, Plugins und CLIs
• Pro-Benutzer-Kontrollen: Begrenzen Sie die Aktivierungen pro Benutzer oder Gerät
• Digitale Waren: Steuern Sie Downloads, Updates oder Premium-Funktionen

​

Erstellen Sie eine License Key-Berechtigung

1

Open Entitlements

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

2

Choose License Key

Wählen Sie License Key als Integration. Konfigurieren Sie, wie sich jeder ausgegebene Schlüssel verhält:

• Aktivierungslimit: Maximale gleichzeitige Aktivierungen pro Schlüssel (z.B. 1 für Einzelbenutzer, 5 für Teamlizenzen, leer lassen für unbegrenzt).
• Dauer: Wie lange der Schlüssel nach der Ausgabe gültig bleibt (z.B. 30 Tage, 1 Jahr). Für Abonnement-gestützte Schlüssel leer lassen; Schlüssel bleiben gültig, solange das Abonnement aktiv ist.
• Aktivierungsanweisungen: Kundengerichtete Anweisungen, die mit dem Schlüssel per E-Mail gesendet werden. Beispiele: Paste the key in Settings → License oder Run: mycli activate <key>.

3

Save the entitlement

Speichern. Die Berechtigung ist jetzt verfügbar, um sie mit jedem Produkt zu verknüpfen.

​

An Produke anhängen

​

Wie Schlüssel ausgegeben werden

​

Verhaltensweise der Menge

• Abonnementprodukte geben einen Schlüssel pro Sitzplatz aus (subscriptions.quantity).
• Einmalprodukte geben einen Schlüssel pro Warenkorbposition aus (product_cart.quantity).
• Manuelle API-Zuwendungen geben genau einen Schlüssel aus.

​

Erfüllungsmodus

• auto (default): Dodo Payments generiert den Schlüssel automatisch und sendet ihn per E-Mail, sobald eine Zahlung oder ein Abonnement erfolgt. Dies ist das oben beschriebene Verhalten und gilt, wenn fulfillment_mode weggelassen wird.
• manual: Beim Kauf wird eine Pending-Berechtigung ohne Schlüssel erstellt, und Sie geben jeden Schlüsselwert selbst an. Weitere Informationen finden Sie unten unter Manuelle Erfüllung.

​

Manuelle Erfüllung

​

Wann es zu verwenden ist

• Bring-your-own-keys: Der Schlüssel wird von Ihrer Anwendung, einem Desktop-Produkt oder Ihrem eigenen Lizenzserver generiert.
• Drittanbieter: Sie verkaufen Schlüssel eines externen Anbieters weiter (ein Spielschlüssel, eine API-Zugangsdaten, eine Partnerplattform).
• Begrenzter Bestand: Sie geben Codes aus einem vorab zugewiesenen Pool aus und möchten sie einzeln zuweisen.
• Manuelle Überprüfung: Sie möchten einen Kauf überprüfen, bevor Sie Zugriff gewähren.

​

Manuelle Erfüllung aktivieren

const entitlement = await client.entitlements.create({
  name: 'Pro License (Manual)',
  integration_type: 'license_key',
  integration_config: {
    fulfillment_mode: 'manual',
    activations_limit: 5,
    duration_count: 1,
    duration_interval: 'Year',
  },
});

curl -X POST https://test.dodopayments.com/entitlements \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pro License (Manual)",
    "integration_type": "license_key",
    "integration_config": {
      "fulfillment_mode": "manual",
      "activations_limit": 5,
      "duration_count": 1,
      "duration_interval": "Year"
    }
  }'

​

Berechtigungen finden, die auf Erfüllung warten

const pending = await client.customers.listEntitlementGrants('customer_id', {
  integration_type: 'license_key',
  status: 'Pending',
});

​

Den Schlüssel liefern

curl -X POST https://test.dodopayments.com/grants/grant_8VbC6JDZ/license-key \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "PRO-AAAA-BBBB-CCCC-DDDD",
    "activations_limit": 5,
    "expires_at": "2027-05-01T00:00:00Z"
  }'

​

Aktivierung, Validierung, Deaktivierung

​

Eine Lizenz aktivieren

import DodoPayments from 'dodopayments';

// No API key needed for public license endpoints
const client = new DodoPayments();

const response = await client.licenses.activate({
  license_key: 'PRO-AAAA-BBBB-CCCC-DDDD',
  name: 'Device Name',
});

console.log(response.id);

client.licenses.activate(
    license_key="PRO-AAAA-BBBB-CCCC-DDDD",
    name="Device Name",
)

curl -X POST https://test.dodopayments.com/licenses/activate \
  -H "Content-Type: application/json" \
  -d '{
    "license_key": "PRO-AAAA-BBBB-CCCC-DDDD",
    "name": "Device Name"
  }'

​

Eine Lizenz validieren

const response = await client.licenses.validate({
  license_key: 'PRO-AAAA-BBBB-CCCC-DDDD',
});

console.log(response.valid);

curl -X POST https://test.dodopayments.com/licenses/validate \
  -H "Content-Type: application/json" \
  -d '{ "license_key": "PRO-AAAA-BBBB-CCCC-DDDD" }'

​

Eine Aktivierungsinstanz deaktivieren

await client.licenses.deactivate({
  license_key: 'PRO-AAAA-BBBB-CCCC-DDDD',
  license_key_instance_id: 'instance_abc123',
});

​

Schlüssel verwalten

const grants = await client.entitlements.grants.list('ent_license_key_id', {
  status: 'Delivered',
});

for (const grant of grants.items) {
  console.log(grant.license_key.key, grant.license_key.activations_used);
}

​

Bestehende Lizenzschlüssel über die API importieren

const licenseKey = await client.licenseKeys.create({
  customer_id: 'cus_abc123',
  product_id: 'pdt_456',
  key: 'YOUR-EXISTING-LICENSE-KEY',
  activations_limit: 5,
  expires_at: '2026-12-31T23:59:59Z',
});

​

Wie sich Schlüssel je nach Quelle unterscheiden

​

Lizenzschlüssel in der Rückgabe-URL

https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001&email=customer%40example.com

https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001,LK-002&email=customer%40example.com

https://yoursite.com/return?subscription_id=sub_xxx&status=active&license_key=LK-001&email=customer%40example.com

​

API-Management

​

Webhooks

​

Legacy-Lizenzschlüssel

​

Best Practices

• Halte Aktivierungslimits klar: Wähle sinnvolle Standardwerte (1 für Einzelbenutzer-Apps, 3–5 für Teamlizenzen) und dokumentiere sie.
• Gib präzise Aktivierungsanweisungen: Kunden kopieren diese aus ihrer E-Mail. Genaue Pfade und Befehle reduzieren daher Supportanfragen.
• Validiere Schlüssel serverseitig: Verwende für Produkte mit Netzwerkverbindung /licenses/validate, statt die Aktivierung lokal zwischenzuspeichern.
• Verwende Webhooks für Widerrufe: Höre auf entitlement_grant.revoked, um In-App-Funktionen sofort zu deaktivieren, wenn ein Kunde kündigt oder eine Rückerstattung erhält.
• Teste mit Subscriptions und Einmalkäufen: Das Verhalten von Lizenzschlüsseln unterscheidet sich zwischen beiden leicht. Teste daher beide, bevor du live gehst.