BuiltByBit Integration
Lukittu supports BuiltByBit by providing a fully automatic licensing experience for your resources.
BuiltByBit Integration
Lukittu automatically delivers licenses to your customers when they purchase through BuiltByBit.
Implementation Overview
Follow these steps to configure licensing for the products you sell using BuiltByBit:
Create a product in Lukittu
First, set up your product in the Lukittu platform.
Enable the BuiltByBit integration
Activate the integration in your Lukittu dashboard.
Set up a purchase webhook
Configure BuiltByBit 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.
You’ll need this ID when configuring your BuiltByBit webhook.
Enabling BuiltByBit Integration
Before setting up webhooks on BuiltByBit, 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 BuiltByBit integration option and toggle it to Active.
Copy the Secret
Copy the generated Secret as you’ll need it for the webhook setup.
Keep this secret secure as it authenticates your webhook requests.
Setting Up Purchase Webhook
Follow these steps to configure the purchase webhook that will automatically issue licenses:
Access BuiltByBit Webhooks
Go to the BuiltByBit webhooks dashboard and click the Create webhook button.
Configure Webhook Settings
Enter a descriptive name for the webhook. Select Purchase from the Trigger dropdown. Choose Only apply to certain resources and select the specific resource(s) you want to license.
Set Webhook URL
Enter the following URL:
Replace YOUR_TEAM_ID
with your Lukittu team’s ID.
To find your Team ID, go to the Lukittu dashboard and navigate to Team → Settings.
Configure Webhook Format
Select Custom for Template, POST for Method, and application/json for Content Type.
Set Webhook Body
Copy and paste the following JSON template:
Customize Webhook Data
Replace YOUR_BUILT_BY_BIT_SECRET
with the integration secret from your Lukittu dashboard. Replace YOUR_LUKITTU_PRODUCT_ID
with the product ID you copied earlier.
The fields ipLimit
, seats
, expirationDays
, and expirationStart
are optional configuration parameters. Leave them as null
if you don’t need them, or set appropriate values based on your licensing requirements.
Save the Webhook
Click the Save button to create your purchase webhook.
Optional License Configuration
The following parameters can be customized in the webhook JSON:
Key | Type | Description |
---|---|---|
ipLimit | Number | Maximum number of IPs allowed. |
seats | Number | Number of concurrent users allowed. |
expirationDays | Number | Number of days until the license expires. |
expirationStart | ACTIVATION or CREATION | Determines when expiration starts (default: CREATION ). Applicable if expirationDays is used. |
Setting Up License Placeholder
To enable automatic license delivery to your customers, you need to create a license placeholder:
Access BuiltByBit Placeholders
Go to the BuiltByBit placeholders page and click the Create placeholder button.
Configure Placeholder Settings
Enter a descriptive placeholder name (e.g., %%*__LUKITTU_LICENSE_KEY__%%
). Select External license key from the Type dropdown.
Set Placeholder URL
Enter the following URL:
Replace YOUR_TEAM_ID
with your Lukittu team’s ID.
Set Secret
Enter the BuiltByBit integration secret you created on your Lukittu dashboard.
Save the Placeholder
Click the Save button to create your license placeholder.