Stripe Integration
Lukittu supports Stripe by automatically delivering licenses to customers via email upon purchase.
Stripe Integration
Lukittu automatically delivers licenses to your customers via email when they purchase through Stripe.
Implementation Overview
Follow these steps to configure licensing for the products you sell using Stripe:
Create a product in Lukittu
First, set up your product in the Lukittu platform.
Create the same product in Stripe
Configure an identical product in your Stripe dashboard.
Add custom metadata attributes
Connect your Stripe product to Lukittu using metadata fields.
Set up a webhook endpoint
Configure Stripe to notify Lukittu of purchase events.
Add API credentials to Lukittu
Complete the integration by adding your Stripe API key and webhook secret.
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 Stripe product’s metadata.
Creating a Stripe Product for Lukittu
Follow these steps to create and configure a Stripe product for use with Lukittu:
Access the Stripe Dashboard
Navigate to the Product Catalog section on your Stripe dashboard.
Add a Product
Click the Add a Product button. Enter a product name.
Use the same name as your Lukittu product for consistency and easier identification.
Locate Metadata Options
Find the More Options dropdown. Open the dropdown and locate the Metadata section.
Metadata allows you to add custom data to your Stripe product. Lukittu uses this metadata to map Stripe products to its backend.
Required Metadata for Lukittu
Add the following metadata key-value pairs to your product:
| Key | Description |
|---|---|
product_id | Your Lukittu product ID (required for identification). |
Optional Metadata for Lukittu
The following metadata keys are optional and can be added as needed:
| Key | Type | Description |
|---|---|---|
ip_limit | Number | Maximum number of IPs allowed. |
seats | Number | Number of concurrent users allowed. |
expiration_days | Number | Number of days until the license expires. |
expiration_start | ACTIVATION or CREATION | Determines when expiration starts (default: CREATION). Applicable if expiration_days is used. |
Notes on Expiration and Subscriptions
Adding a Stripe Webhook
Search for Webhooks
Use the search bar on your Stripe dashboard to search for Webhooks.
Create a New Event Destination
Click Add endpoint to create a new webhook. Set the Endpoint URL to:
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 Events
Select Listen to events on your account. Add the following events to the webhook:
invoice.paidcustomer.subscription.deletedcustomer.subscription.createdcustomer.subscription.updatedcheckout.session.completed
Save the Webhook
After configuring the events, save the newly created webhook.
Retrieve the Webhook Signing Secret
Once saved, Stripe will generate a Signing Secret for the webhook.
The signing secret starts with whsec_. You will need this signing
secret to complete the Stripe integration in Lukittu.
Adding a Restricted API Key to Lukittu
Navigate to API Keys in Stripe
Go to the API Keys section on your Stripe dashboard.
Create a New Restricted Key
Click Create Restricted Key. In the dialog:
- Purpose: Select “Providing this key to another website.”
- Name: Enter a name for the key (e.g.,
Lukittu). - URL: Set the URL to:
https://app.lukittu.com
Create and Copy the Key
Click Create Restricted Key. Copy the generated key.
Add the Key to Lukittu
Log in to your Lukittu dashboard. Go to the Stripe Integration section. Paste the copied API key into the appropriate field.
Finishing the Integration
Navigate to the Integrations Section
Log in to your Lukittu dashboard and go to Integrations → Stripe Integration.
Enter API Key and Webhook Signing Secret
Provide the restricted API key you created earlier. Enter the
webhook signing secret (starting with whsec_) from the Stripe
webhook configuration.
Verify the Integration
If everything was set up correctly, your Stripe integration should now be fully functional. You can start generating payment links for your Stripe products and selling your software!