​
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:
1

Create a product in Lukittu

First, set up your product in the Lukittu platform.
2

Enable the Polymart integration

Activate the integration in your Lukittu dashboard.
3

Set up a purchase webhook

Configure Polymart to notify Lukittu of purchase events.
4

Create a license placeholder

Set up automatic license delivery for your customers.

​
Creating a Product in Lukittu

1

Navigate to Products

Go to the Products page in your Lukittu dashboard and click Add Product.
2

Add product details

Enter a name for your product and click Save.
3

Get the product ID

Open the page for your newly created product and copy the product’s ID.
You’ll need this ID when configuring your Polymart webhook.

​
Enabling Polymart Integration

Before setting up webhooks on Polymart, you need to enable the integration in your Lukittu dashboard:
1

Access Integrations Settings

Log in to your Lukittu dashboard and navigate to the Integrations tab.
2

Enable the Integration

Locate the Polymart integration option and toggle it to Active.
3

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:
1

Access Polymart Product Webhooks

Go to your product page on Polymart and click the Webhooks option.
2

Add New Webhook

Click the Add New Webhook button to create a webhook for your product.
3

Configure Webhook Events

Under “What events should your webhook receive?” select Purchases.
4

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.
5

Submit and Get Secret

Click the Submit button to save your webhook configuration. After submission, you’ll receive a webhook secret.
6

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:
1

Access Product Security Settings

Go to your product’s edit page on Polymart and locate the Security section.
2

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.
3

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.
4

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.
5

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:
ParameterTypeDescription
ipLimitNumberMaximum number of IPs allowed (must be a positive integer).
seatsNumberNumber of concurrent users allowed (must be at least 1).
expirationDaysNumberNumber of days until the license expires (must be at least 1).
expirationStartACTIVATION or CREATIONDetermines when expiration starts (default: CREATION). Applicable if expirationDays is used.
Example URL with custom parameters: 
https://app.lukittu.com/api/v1/integrations/polymart?teamId=YOUR_TEAM_ID&productId=YOUR_PRODUCT_ID&ipLimit=2&seats=1&expirationDays=30&expirationStart=CREATION