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.
| Waarde | Herkomst | Wat je applicatie ermee doet |
|---|---|---|
| seller_id | Licentie-instellingen van het product | Verwacht verkoper-ID vastzetten in de integratie |
| product_id | Licentie-instellingen van het product | Verwacht product-ID vastzetten; andere producten weigeren |
| license_key | Betaalde bestelling van de koper | Behandelen als toegangsbewijs en veilig lokaal opslaan |
| installation_id | Je applicatie | Eenmalig een willekeurige waarde van 16–200 tekens maken en bewaren |
| instance.id | Geslaagde activatierespons | Bewaren 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.
| Operatie | Pad | Verplichte velden in de body |
|---|---|---|
| Activeren | /api/v1/licenses/activate | seller_id, product_id, license_key, installation_id |
| Een installatie valideren | /api/v1/licenses/validate | seller_id, product_id, license_key, instance_id |
| Deactiveren | /api/v1/licenses/deactivate | seller_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.
| Situatie | Verwacht gedrag van de applicatie |
|---|---|
| Eerste activering | Instance opslaan en uitsluitend het bedoelde product ontgrendelen |
| Herhaalde activering met hetzelfde installation_id | Actieve instance hergebruiken; geen extra plek |
| Derde activering bij een limiet van twee | Limiet uitleggen en een vrijgave- of ondersteuningspad aanbieden |
| Geldige sleutel voor een andere verkoper of ander product | Toegang weigeren |
| Per ongeluk alleen de sleutel gecontroleerd | Niet behandelen als bewijs van een actieve installatie |
| Vrijgegeven instance opnieuw gevalideerd | Oud bewijs weigeren; bij heractivering een nieuwe instance gebruiken |
| Terugbetaling of geschil op de bestelling | Geen bevestigde toegang voor alle licenties van de bestelling |
| Timeout, ongeldige JSON of afwijkende identifiers | Geen bevestigde toegang; een bruikbare herstelmelding tonen |
| HTTP 422 of 429 | Invoer 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.


