Hoppa till huvudinnehåll
Utfärda unika nycklar för din programvara eller digitala varor, kontrollera aktiveringarna och återkalla åtkomst vid behov. Licensnycklar passar bra med prenumerationer och engångsköp.

Vad är licensnycklar?

Licensnycklar är unika token som auktoriserar åtkomst till din produkt. De är idealiska för:
  • 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

Nyckelfördelar

  • Åtkomstkontroll: Definiera utgångsdatum och aktiveringsgränser
  • Operativ synlighet: Spåra användning, enheter och historik
  • Säkerhet och support: Inaktivera, återaktivera och granska snabbt

Skapa licensnycklar

1

Create a License Key

Gå till din Dodo Payments-instrumentpanel och öppna avsnittet Licensnycklar. Välj alternativet för att skapa en ny licensnyckel.
2

Configure License Key Settings

Ange hur dina licensnycklar ska utfärdas och användas genom att specificera dessa fält:
  • License Key Expiry Date: Definiera hur länge nyckeln är giltig. Välj en specifik tidsperiod (till exempel 30 dagar eller 1 år), eller välj “no expiry” för en evigt giltig nyckel.
  • Activation Limit: Ange det maximala antalet samtidiga aktiveringar per nyckel. Använd ett specifikt nummer för scenarier som enanvändare (1) eller teamlicenser (5), eller välj “unlimited” för att inte ha någon aktiveringsgräns.
  • Activation Instructions: Ge tydliga aktiveringssteg för dina kunder, som också skickas via e-post tillsammans med licensnyckeln. Exempel: “Klistra in nyckeln i Inställningar → Licens” eller “Kör: mycli activate <key>”.
3

Review and Save

Kontrollera alla ifyllda uppgifter. När du är klar, spara licensnyckelkonfigurationen för att slutföra nyckelskapandet.
Använd realistiska instruktioner och inkludera supportlänkar för att minska aktiveringsärenden.
Skapar en licensnyckel i Dodo Payments-instrumentpanelen

Hantera och övervaka

Licensnyckelsavsnittet ger en omfattande översikt över all aktivitet med licensnycklar och gör det möjligt för dig att hantera och övervaka licenser effektivt.

Nyckelinformation

Visa detaljerad information för varje licensnyckel:
  • Nyckeldetaljer: Licensnyckelvärde, associerat produktnamn, kundinformation (customer_id) och inköpsdatum
  • Användningsaktivitet: Antal aktiveringar, aktiveringsdatum och tider, samt status (aktiv, utgången, inaktiverad)
  • Utgång och gränser: Nyckelns utgångsdatum, kvarvarande aktiveringsantal och aktuella aktiveringsinstanser
Licensnyckelinformation

Tillgängliga åtgärder

Du kan utföra följande åtgärder på licensnycklar:
  • Inaktivera licensnyckel: Omedelbart inaktivera en nyckel för att förhindra ytterligare användning
  • Aktivera nyckel: Återaktivera en tidigare inaktiverad licensnyckel
  • Visa aktiveringsinstanser: Se alla associerade aktiveringsinstanser för en viss licensnyckel
Åtgärder för licensnyckel

Fördelar

  • Spåra aktivitet med licensnycklar i realtid
  • Identifiera potentiellt missbruk eller obehöriga aktiveringar
  • Förenkla kundsupport genom att tillhandahålla detaljerade användningsregister vid avvikelse

API-hantering

Använd dessa API:er för att aktivera, validera, lista och uppdatera licensnycklar och deras aktiveringsinstanser.
Publika slutpunkter: aktivera, avaktivera och validera licensslutpunkterna är publika och kräver ingen API-nyckel. Detta gör att du kan anropa dem direkt från dina klientapplikationer, skrivbordsprogram eller CLI:er utan att exponera dina API-uppgifter.

Integreringsexempel

Aktivera en licens

Dessa slutpunkter kräver ingen API-nyckel och kan anropas direkt från dina klientapplikationer.
import DodoPayments from 'dodopayments';

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

const response = await client.licenses.activate({ 
  license_key: 'license_key', 
  name: 'Device Name' 
});

console.log(response.id);

Validera en licens

import DodoPayments from 'dodopayments';

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

const response = await client.licenses.validate({ 
  license_key: '2b1f8e2d-c41e-4e8f-b2d3-d9fd61c38f43' 
});

console.log(response.valid);

Licensnycklar i retur-URL

När en kund slutför ett köp av en produkt med licensnycklar aktiverat, läggs licensnyckeln automatiskt till i din return_url som en frågeparameter. Detta gör att du kan visa nyckeln direkt på din bekräftelsesida utan att göra ett extra API-anrop.
https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001&email=customer%40example.com
Om köpet genererar flera licensnycklar (t.ex. kvantitet > 1) separeras de med kommatecken:
https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001,LK-002&email=customer%40example.com
För prenumerationer används subscription_id istället för payment_id:
https://yoursite.com/return?subscription_id=sub_xxx&status=active&license_key=LK-001&email=customer%40example.com
Parsa parametern license_key på din retur-sida för att visa nyckeln omedelbart för kunderna, vilket förbättrar upplevelsen efter köpet.

Bästa praxis

  • Håll gränserna tydliga: Välj rimliga standardvärden för utgångsdatum och aktiveringar
  • Vägled användare: Ge precisa aktiveringsinstruktioner och självhjälpsdokumentation
  • Automatisera kontroller: Validera nycklar server-side innan åtkomst ges
  • Övervaka händelser: Använd webhooks för att upptäcka missbruk och automatisera återkallelser