Polymart Integration
Lukittu automatically delivers licenses to your customers when they purchase
through Polymart.
Implementation Overview
Follow these steps to configure licensing for the products you sell using Polymart:Creating a Product in Lukittu
Enabling Polymart Integration
Before setting up webhooks on Polymart, you need to enable the integration in your Lukittu dashboard:Add Integration Secrets
The Polymart integration requires two secrets: - Webhook Secret:
You’ll get this after creating your webhook on Polymart. - Signing
Secret: You’ll get this when setting up the license placeholder.
Both secrets are required for the integration to work properly.
You’ll add them after completing the webhook and placeholder setup
in the following steps.
Setting Up Purchase Webhook
Follow these steps to configure the purchase webhook that will automatically issue licenses:Set Webhook URL
Enter the following URL:
https://app.lukittu.com/api/v1/integrations/polymart?teamId=YOUR_TEAM_ID&productId=YOUR_PRODUCT_ID Replace YOUR_TEAM_ID with your Lukittu team’s ID and
YOUR_PRODUCT_ID with the Lukittu product ID you copied earlier.To find your Team ID, go to the Lukittu dashboard and navigate to
Team → Settings.
Submit and Get Secret
Click the Submit button to save your webhook configuration. After
submission, you’ll receive a webhook secret.
Setting Up External License Placeholder
To enable automatic license delivery to customers via placeholders, you need to set up a license placeholder in Polymart:Access Product Security Settings
Go to your product’s edit page on Polymart and locate the Security
section.
Configure External API Placeholder
In the Security section, select External API as your custom
placeholder type.
The “Key” field can be anything you want - it’s just an identifier
for Polymart.
Set API Endpoint
Enter the following URL in the API endpoint field:
https://app.lukittu.com/api/v1/integrations/polymart/placeholder?teamId=YOUR_TEAM_ID Replace YOUR_TEAM_ID with your Lukittu team ID.To find your Team ID, go to the Lukittu dashboard and navigate to
Team → Settings.
Optional License Configuration
The following query parameters can be added to your webhook URL to customize license properties:| Parameter | Type | Description |
|---|---|---|
ipLimit | Number | Maximum number of IPs allowed (must be a positive integer). |
hwidLimit | Number | Number of concurrent users allowed (must be at least 1). |
expirationDays | Number | Number of days until the license expires (must be at least 1). |
expirationStart | ACTIVATION or CREATION | Determines when expiration starts (default: CREATION). Applicable if expirationDays is used. |