Polymart Integration
Lukittu supports Polymart by providing a fully automatic licensing experience for your resources.
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:
Create a product in Lukittu
First, set up your product in the Lukittu platform.
Enable the Polymart integration
Activate the integration in your Lukittu dashboard.
Set up a purchase webhook
Configure Polymart to notify Lukittu of purchase events.
Create a license placeholder
Set up automatic license delivery for your customers.
Creating a Product in Lukittu
Navigate to Products
Go to the Products page in your Lukittu dashboard and click Add Product.
Add product details
Enter a name for your product and click Save.
Get the product ID
Open the page for your newly created product and copy the product’s ID.
Enabling Polymart Integration
Before setting up webhooks on Polymart, you need to enable the integration in your Lukittu dashboard:
Access Integrations Settings
Log in to your Lukittu dashboard and navigate to the Integrations tab.
Enable the Integration
Locate the Polymart integration option and toggle it to Active.
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:
Access Polymart Product Webhooks
Go to your product page on Polymart and click the Webhooks option.
Add New Webhook
Click the Add New Webhook button to create a webhook for your product.
Configure Webhook Events
Under “What events should your webhook receive?” select Purchases.
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.
Add Webhook Secret to Lukittu
Copy the webhook secret provided by Polymart and paste it into the “Webhook Secret” field in the Polymart integration section of your Lukittu dashboard.
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.
Copy API Signing Secret
At the bottom of the card, you’ll find an API signing secret.
Copy this secret value - you’ll need to add it to Lukittu.
Add Signing Secret to Lukittu
Return to your Lukittu dashboard’s Integrations section and paste the API signing secret into the Signing Secret field of the Polymart integration.
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). |
seats | 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. |
Example URL with custom parameters: