Licensnycklar

​

Vad är Licensnycklar?

• Programvarulicensering: Skrivbordsappar, plugins och CLIs
• Per-användarkontroller: Begränsa aktiveringar per användare eller enhet
• Digitala varor: Stänga av nedladdningar, uppdateringar eller premiumfunktioner

​

Skapa en Licensnyckel Entitlement

1

Open Entitlements

Gå till Entitlements i din Dodo Payments-instrumentpanel och klicka på + för att skapa en ny entitlement.

2

Choose License Key

Välj License Key som integration. Konfigurera hur varje utfärdad nyckel beter sig:

• Aktiveringsbegränsningar: Maximalt antal samtidiga aktiveringar per nyckel (t.ex., 1 för enanvändarlicens, 5 för teamlicenser, lämna tom för obegränsat).
• Varaktighet: Hur lång tid nyckeln förblir giltig efter utfärdande (t.ex., 30 dagar, 1 år). För prenumerationsutgivna nycklar, lämna tom; nycklar förblir giltiga så länge prenumerationen är aktiv.
• Aktiveringsinstruktioner: Kundanvisningar som skickas med nyckeln till e-post. Exempel: Paste the key in Settings → License eller Run: mycli activate <key>.

3

Save the entitlement

Spara. Entitlement är nu tillgänglig att koppla till vilken produkt som helst.

​

Koppla till Produkter

​

Hur nycklar utfärdas

​

Kvantitetsbeteende

• Prenumerationsprodukter utfärdar en nyckel per plats (subscriptions.quantity).
• Engångsprodukter utfärdar en nyckel per kassaartikel (product_cart.quantity).
• Manuella API-beviljanden utfärdar exakt en nyckel.

​

Aktivering, Validering, Inaktivering

​

Aktivera en licens

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"
  }'

​

Validera en licens

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" }'

​

Inaktivera en aktiveringsinstans

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

​

Hantera Nycklar

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

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);
}

​

Importera Befintliga Licensnycklar via API

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

​

Skillnaden mellan importerade och automatgenererade nycklar

​

Licensnycklar i 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,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-hantering

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);
}

​

Webhooks

​

Äldre Licensnycklar

​

Bästa Praxisen

• Håll aktiveringsgränserna klara: Välj rimliga standardvärden (1 för enanvändarappar, 3–5 för teamlicenser) och dokumentera dem.
• Ge precisa aktiveringsinstruktioner: Kunder klistrar in dessa från sina mejl, så exakta vägar och kommandon sparar supportärenden.
• Validera nycklar server-side: För nätverksanslutna produkter, validera via /licenses/validate istället för att cachea aktivering lokalt.
• Använd webhooks för återkallelse: Lyssna på entitlement_grant.revoked för att omedelbart inaktivera in-app funktioner när en kund avbokar eller får återbetalning.
• Testa med prenumerationer och engångstillfällen: Licensnyckelbeteende skiljer sig subtilt mellan de två, så testa båda innan du startar.

​

API-Management

​

Webbhooks

​

Legacy Licensnycklar

​

Best Practices

• Håll aktiveringsgränser tydliga: Välj rimliga standardvärden (1 för enanvändarappar, 3–5 för teamlicenser) och dokumentera dem.
• Ge precisa aktiveringsinstruktioner: Kunder klistrar in dessa från sin e-post, så exakta sökvägar och kommandon sparar supportärenden.
• Validera nycklar server-sida: För nätverksanslutna produkter, validera via /licenses/validate istället för att cachea aktiveringen lokalt.
• Använd webhooks för återkallande: Lyssna på entitlement_grant.revoked för att omedelbart inaktivera appfunktioner när en kund avbryter eller återbetalar.
• Testa med prenumerationer och engångsköp: Licensnyckelbeteendet skiljer sig subtilt mellan de två, så testa båda innan de tas i bruk.