Terug naar Blog
Softwarelicenties valideren: handleiding voor de License API
Verkopen

Softwarelicenties valideren: handleiding voor de License API

Bouw een licentieflow met activering, installatievalidatie en deactivering. Inclusief requestvelden en testmatrix voor de PayRequest License API.

17 november 20269 min lezen
P
PayRequest Team
Software licensing workflow editors

Een softwarelicentiesleutel geeft pas gecontroleerde toegang wanneer je applicatie die sleutel controleert. PayRequest kan na bevestigde betaling een sleutel uitgeven; je software moet een installatie activeren, het instance-ID bewaren en die installatie valideren voordat de betaalde functie wordt ontgrendeld. Een geslaagde checkout en een geldige installatie zijn verschillende toestanden.

Deze handleiding is voor ontwikkelaars die een desktopapp, extensie of plugin eenmalig verkopen. We vertalen de documentatie van de License API naar een requestoverzicht en releasecontrole. Het uitgewerkte voorbeeld is een ontwerpvoorbeeld, geen verslag van een geteste klantbetaling.

Begin met één product en een duidelijke toegangsaanspraak

Stel: je verkoopt een desktoptool voor €39 met twee actieve installaties en levenslange geldigheid. De prijs en instellingen zijn illustratief. Levenslang betekent dat er geen vervaldatum is ingesteld. Het omzeilt geen terugbetaling, geschil of uitgeschakelde licentie en belooft geen levenslange software-updates.

Maak een betaald, eenmalig License- of Digital Product-product. Schakel Generate license keys in, zet het maximum op twee actieve installaties en laat de geldigheid voor dit voorbeeld leeg. Sla dit op voordat de eerste bestelling wordt aangemaakt. Ook een onbetaalde checkout zet de voorwaarden vast; maak een nieuw product als je die later wilt wijzigen.

Na bevestigde betaling krijgt iedere gekochte eenheid één sleutel. Een digitaal product kan zowel het bestand als de licentiesleutel leveren. De koper vindt de sleutel in de bevestigingsmail en in het account van de primaire koper in het klantenportaal. Contactgebruikers kunnen sleutels niet bekijken. Bestaande bestellingen krijgen niet achteraf licenties.

Houd verkoper, product, installatie en instance uit elkaar

Deze identifiers voorkomen verschillende fouten. Verkoper en product bepalen welke aankoop je app mag ontgrendelen; de installatie identificeert deze kopie van de app; de instance is het bewijs dat de licentieservice teruggeeft.

WaardeHerkomstWat je applicatie ermee doet
seller_idLicentie-instellingen van het productVerwacht verkoper-ID vastzetten in de integratie
product_idLicentie-instellingen van het productVerwacht product-ID vastzetten; andere producten weigeren
license_keyBetaalde bestelling van de koperBehandelen als toegangsbewijs en veilig lokaal opslaan
installation_idJe applicatieEenmalig een willekeurige waarde van 16–200 tekens maken en bewaren
instance.idGeslaagde activatieresponsBewaren als instance_id voor validatie en deactivering

Leid het installatie-ID niet af van een e-mailadres, serienummer of hardwarevingerafdruk. Een opgeslagen willekeurige UUID is een mogelijke implementatie. Als je opslag wordt gewist en een nieuw ID maakt, ziet de licentieservice een andere installatie. Bied daarom een herstelpad via deactivering of ondersteuning door de verkoper.

Je hoeft geen geheime verkopers-API-sleutel in de verspreide applicatie op te nemen. De sleutel van de koper is daarmee niet openbaar: houd hem uit analytics, foutrapporten, screenshots en logs. Zet de verwachte IDs vast in code of vertrouwde configuratie; laat een ingevoerde sleutel geen andere verkoper of ander product kiezen.

Verstuur activering als POST-request

Alle drie de operaties gebruiken HTTPS op https://payrequest.app. Verstuur Accept: application/json en plaats de gegevens in de requestbody. Gebruik bij formuliercodering Content-Type: application/x-www-form-urlencoded en codeer iedere waarde afzonderlijk; plak onbewerkte gebruikersinvoer niet in één lange tekenreeks.

OperatiePadVerplichte velden in de body
Activeren/api/v1/licenses/activateseller_id, product_id, license_key, installation_id
Een installatie valideren/api/v1/licenses/validateseller_id, product_id, license_key, instance_id
Deactiveren/api/v1/licenses/deactivateseller_id, product_id, license_key, instance_id

Bij activering mag je ook instance_name meesturen, bijvoorbeeld “Werklaptop”. Gebruik geen persoonsgegeven als label. Controleer bij succes valid: true en activated: true, verifieer de verkoper- en product-IDs in het licentieobject en bewaar instance.id. De respons bevat ook de activatielimiet, het gebruik en de vervaldatum; null betekent levenslange geldigheid.

Opnieuw activeren met hetzelfde stabiele installatie-ID geeft de bestaande actieve instance terug zonder een extra plek te gebruiken. Dat helpt wanneer activering wel slaagde, maar de netwerkrespons verloren ging. Gebruik bij de nieuwe poging het bewaarde installatie-ID en genereer niet steeds een nieuw ID.

Valideer de installatie voordat je toegang bevestigt

POST de sleutel, vastgezette verkoper- en product-IDs en het opgeslagen instance_id naar het validatie-endpoint. Vereis valid: true en validated: true. Weiger afwijkende identifiers en ongeldige responsstructuren. Een netwerkfout bewijst niet dat toegang geldig is.

Je kunt ook zonder instance_id alleen de sleutel controleren. Dat controleert de licentie, maar bewijst niet dat een installatie actief is. Verkoop je twee installaties, dan is zo’n sleutelcontrole onvoldoende om die grens te handhaven. Gebruik het instance-ID bij iedere toegangsbeslissing die een geactiveerde installatie vereist.

Geef een begrijpelijke melding, bijvoorbeeld “We konden deze licentie niet bevestigen. Maak verbinding en probeer opnieuw.” Ontgrendel de betaalde functie niet op basis van alleen een HTTP-status. Wacht tot de respons aan je validatievoorwaarden voldoet, of pas een offline respijtperiode toe die je zelf expliciet hebt ingebouwd.

Geef een installatie vrij zonder het oude bewijs te hergebruiken

Een deactiveringsactie verstuurt dezelfde verkoper-, product- en sleutelwaarden plus instance_id. Een geslaagde respons bevat deactivated: true en maakt een plek vrij. Bewaar bij een latere activering het nieuwe instance-ID. Het vorige bewijs blijft ongeldig.

In ons voorbeeld vullen Laptop A en Desktop B de twee plekken. Een derde apparaat mag niet activeren. Deactiveer Laptop A en activeer vervolgens het derde apparaat met zijn eigen stabiele installatie-ID. Controleer dat het oude instance-ID van Laptop A niet meer valideert en dat Desktop B zijn eigen actieve instance behoudt.

Als verkoper kun je licenties op de productpagina ook uit- of inschakelen en afzonderlijke installaties vrijgeven. Opnieuw inschakelen omzeilt geen vervaldatum, teruggedraaide betaling of schorsing van de verkoper.

Neem fouttoestanden mee in je releasecontrole

Dit is een voorgestelde acceptatiematrix voor je integratie. Voer de controles uit met je eigen gecontroleerde betaalde product en terugbetalingsproces voordat je verkoopt. Noteer resultaten zonder de volledige sleutels vast te leggen.

SituatieVerwacht gedrag van de applicatie
Eerste activeringInstance opslaan en uitsluitend het bedoelde product ontgrendelen
Herhaalde activering met hetzelfde installation_idActieve instance hergebruiken; geen extra plek
Derde activering bij een limiet van tweeLimiet uitleggen en een vrijgave- of ondersteuningspad aanbieden
Geldige sleutel voor een andere verkoper of ander productToegang weigeren
Per ongeluk alleen de sleutel gecontroleerdNiet behandelen als bewijs van een actieve installatie
Vrijgegeven instance opnieuw gevalideerdOud bewijs weigeren; bij heractivering een nieuwe instance gebruiken
Terugbetaling of geschil op de bestellingGeen bevestigde toegang voor alle licenties van de bestelling
Timeout, ongeldige JSON of afwijkende identifiersGeen bevestigde toegang; een bruikbare herstelmelding tonen
HTTP 422 of 429Invoer corrigeren of wachten; geen automatische verzoeklus

De drie operaties delen limieten van 60 verzoeken per minuut per IP en per sleutel. Roep ze niet bij iedere UI-render aan. Bepaal wanneer validatie nodig is, voorkom dubbele gelijktijdige verzoeken en wacht na HTTP 429. Maak van een mislukte controle niet stilzwijgend een geslaagde controle.

Terugbetalingen en geschillen blokkeren alle licenties van de betreffende bestelling. Een gedeeltelijke terugbetaling bepaalt niet automatisch welke gekochte eenheden toegang houden. Beloof dus geen verdeling per eenheid die deze functie niet uitvoert. Een offline respijtperiode stelt handhaving van intrekking uit en moet je zelf bouwen. Offline ondertekende licenties zijn geen onderdeel van de functie.

Weet wat deze integratie niet levert

PayRequest ondersteunt momenteel eenmalige aankopen, 1–100 installaties per sleutel, maximaal 100 gekochte eenheden per bestelregel en levenslange of vaste geldigheid. Abonnementslicenties, import van bestaande Lemon Squeezy-sleutels, automatische software-updates en offline ondertekende licenties zijn niet inbegrepen.

Gebruik je al een andere provider? Een andere checkout past de validatiecode in geïnstalleerde apps niet aan. Gebruik het aparte migratieplan voor Lemon Squeezy-licenties om bestaande kopers mee te nemen voordat je endpoints vervangt.

Begin bij de softwarelicentiefunctie en maak één betaald product waarvan je de voorwaarden en installatielimiet helder kunt uitleggen. Digitale producten zijn beschikbaar op Free met 2% standaard betaalkosten, maximaal €25 per transactie. Actieve Premium (€5/maand) en Business (€20/maand) verwijderen de standaard platformkosten; providerkosten en uitzonderingen voor commissiebetalingen blijven apart. Bekijk de abonnementen voordat je kiest.

Redactionele werkwijze: AI-ondersteund schrijfwerk en een conceptuele illustratie, gecontroleerd aan de hand van de productdocumentatie. Voorbeeld en acceptatiematrix zijn implementatieadvies, geen klantresultaten of verslag van uitgevoerde productie-API-tests.

Frequently Asked Questions

Beschermt sleutelgeneratie mijn app automatisch?

Nee. Je software moet activering en validatie integreren en zelf de toegang afdwingen. Alleen een geleverde sleutel beschermt een betaalde functie niet.

Waarom instance_id meesturen als de sleutel geldig is?

Een controle van alleen de sleutel bewijst niet dat een installatie actief is. Voor installatielimieten moet je valideren met het actieve instance-ID.

Kan een levenslange licentie ongeldig worden?

Ja. Levenslang betekent geen ingestelde vervaldatum. Terugbetalingen, geschillen, uitschakeling en andere controles kunnen bevestigde toegang alsnog blokkeren.

Deel dit artikel