Lizenzschlüssel

​

Was sind Lizenzschlüssel?

• Softwarelizenzierung: Desktop-Apps, Plugins und CLIs.
• Sitzbasierte Kontrollen: Aktivierungen pro Benutzer oder Gerät begrenzen.
• Digitale Güter: Downloads, Updates oder Premiumfunktionen freischalten.

​

Erstellen Sie eine License Key-Berechtigung

1

Open Entitlements

Gehen Sie im Dashboard zu Entitlements und klicken Sie auf +, um ein Entitlement zu erstellen.

2

Choose License Key

Wählen Sie License Keys, geben Sie einen Name ein und konfigurieren Sie, wie sich jeder ausgestellte Schlüssel verhalten soll:

• Fulfillment Mode: Automatic (Standard) generiert jeden Schlüssel und sendet ihn per E-Mail. Mit Manual können Sie jeden Schlüssel selbst bereitstellen. Siehe Manual Fulfillment.
• Activations Limit: die maximale Anzahl aktiver Aktivierungen pro Schlüssel, zum Beispiel 1 für einen einzelnen Benutzer oder 5 für eine Teamlizenz. Wählen Sie Unlimited, um kein Limit festzulegen.
• License Length: wie lange ein Schlüssel nach seiner Ausstellung gültig bleibt, zum Beispiel 30 Tage oder 1 Jahr, oder No expiration. Wählen Sie bei Abonnementprodukten No expiration: Für ein Abonnement ausgestellte Schlüssel haben kein Ablaufdatum, und ihre Gültigkeit folgt dem Abonnementstatus.
• Activation Message: optionale, an Kunden gerichtete Anweisungen mit bis zu 2.500 Zeichen, die in der E-Mail zum Schlüssel enthalten sind. Zum Beispiel: Paste the key in Settings → License oder Run: mycli activate <key>.

3

Save the Entitlement

Klicken Sie auf Create Entitlement. Sie können das Entitlement nun jedem beliebigen Produkt hinzufügen.

​

An Produke anhängen

​

Wie Schlüssel ausgegeben werden

​

Verhalten bei Mengen

• Abonnementprodukte stellen einen Schlüssel pro Sitz aus (subscriptions.quantity).
• Einmalige Produkte stellen einen Schlüssel pro Einheit des Warenkorbpostens aus (product_cart.quantity).
• Manuelle API-Grants stellen genau einen Schlüssel aus.

​

Fulfillment Mode

• auto (Standard, Automatic im Dashboard): Dodo Payments generiert den Schlüssel bei Zahlung oder Abonnement und sendet ihn per E-Mail. Dies entspricht dem Verhalten in der Tabelle oben und gilt, wenn fulfillment_mode nicht angegeben wird.
• manual (Manual im Dashboard): Für jede gekaufte Einheit wird ein Pending-Grant ohne Schlüssel erstellt, und Sie stellen jeden Schlüsselwert selbst bereit. Siehe Manual Fulfillment.

​

Manuelles Fulfillment

​

Wann sollte es verwendet werden?

• Eigene Schlüssel verwenden: Ihre Anwendung, ein Desktopprodukt oder Ihr eigener Lizenzserver generiert den Schlüssel.
• Drittanbieter: Sie verkaufen von einem vorgelagerten Anbieter ausgestellte Schlüssel weiter, zum Beispiel einen Spieleschlüssel, ein API-Credential oder eine Lizenz für eine Partnerplattform.
• Begrenzter Bestand: Sie geben Codes aus einem vorab zugewiesenen Pool einzeln aus.
• Manuelle Prüfung: Sie möchten einen Kauf prüfen, bevor Sie den Zugriff freigeben.

​

Manuelles Fulfillment aktivieren

// `client` is a DodoPayments instance created with your API key.
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"
    }
  }'

​

Grants mit ausstehendem Fulfillment finden

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

​

Den Schlüssel zustellen

curl -X POST https://test.dodopayments.com/grants/entg_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 und Deaktivierung

​

Eine Lizenz aktivieren

import DodoPayments from 'dodopayments';

// The license endpoints don't check the token, but the SDK requires a value.
// Never ship your secret API key in client software.
const client = new DodoPayments({ bearerToken: 'public', environment: 'test_mode' });

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

console.log(response.id);

from dodopayments import DodoPayments

# The license endpoints don't check the token, but the SDK requires a value.
client = DodoPayments(bearer_token="public", environment="test_mode")

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

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

// Uses the client from the activation example.
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: 'lki_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);
}

​

Vorhandene 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',
});

​

Unterschiede zwischen den Schlüsselquellen

​

Lizenzschlüssel in der Return 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%2CLK-002&email=customer%40example.com

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

​

API-Verwaltung

​

Webhooks

​

Legacy-Lizenzschlüssel

​

Best Practices

• Wählen Sie klare Aktivierungslimits: Verwenden Sie Standardwerte wie 1 für Einzelbenutzer-Apps oder 3–5 für Teamlizenzen und dokumentieren Sie diese für Ihre Kunden.
• Formulieren Sie präzise Aktivierungsnachrichten: Kunden kopieren sie aus der Lizenzschlüssel-E-Mail. Genaue Pfade und Befehle vermeiden Supportanfragen.
• Validieren Sie Schlüssel über die API: Rufen Sie bei netzwerkverbundenen Produkten /licenses/validate auf, anstatt sich auf eine lokal zwischengespeicherte Aktivierung zu verlassen.
• Verwenden Sie Webhooks für Widerrufe: Verarbeiten Sie entitlement_grant.revoked, um In-App-Funktionen zu deaktivieren, wenn ein Kunde kündigt oder eine Rückerstattung erhält.
• Testen Sie Abonnements und einmalige Käufe: Das Verhalten von Lizenzschlüsseln unterscheidet sich zwischen beiden, beispielsweise laufen Abonnementschlüssel nicht ab. Testen Sie daher beide Varianten, bevor Sie live gehen.