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:1
Create a product in Lukittu
First, set up your product in the Lukittu platform.
2
Create the same product in Stripe
Configure an identical product in your Stripe dashboard.
3
Add custom metadata attributes
Connect your Stripe product to Lukittu using metadata fields.
4
Set up a webhook endpoint
Configure Stripe to notify Lukittu of purchase events.
5
Add API credentials to Lukittu
Complete the integration by adding your Stripe API key and webhook
secret.
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 Stripe product’s metadata.
Creating a Stripe Product for Lukittu
Follow these steps to create and configure a Stripe product for use with Lukittu:1
Access the Stripe Dashboard
Navigate to the Product Catalog section on your Stripe dashboard.
2
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.
3
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. |
hwid_limit | 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
Subscription-Based Products
Subscription-Based Products
Do not use any expiration-related metadata (
expiration_days, expiration_start).Lukittu automatically handles license expiration for subscription-based products. If a payment is not received, the license will expire automatically at the end of the billing period.One-Time Payment Products
One-Time Payment Products
Expiration metadata can be used as outlined above to define license
durations.
Adding a Stripe Webhook
1
Search for Webhooks
Use the search bar on your Stripe dashboard to search for Webhooks.
2
Create a New Event Destination
Click Add endpoint to create a new webhook. Set the Endpoint URL
to:
https://app.lukittu.com/api/v1/integrations/stripe?teamId=YOUR_TEAM_ID 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.
3
Configure Webhook Events
Select Listen to events on your account. Add the following events to
the webhook: -
invoice.paid - customer.subscription.deleted -
customer.subscription.created - customer.subscription.updated -
checkout.session.completed4
Save the Webhook
After configuring the events, save the newly created webhook.
5
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
1
Navigate to API Keys in Stripe
Go to the API Keys section on your Stripe dashboard.
2
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.com3
Create and Copy the Key
Click Create Restricted Key. Copy the generated key.
4
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
1
Navigate to the Integrations Section
Log in to your Lukittu dashboard and go to Integrations → Stripe
Integration.
2
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.3
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!
Testing Your Integration
Optional Testing Procedure (Recommended)
Optional Testing Procedure (Recommended)
-
Switch to Test Mode in Stripe
- Enable Test Mode on your Stripe dashboard.
- Repeat the steps to set up API keys, webhooks, and products in this isolated environment.
-
Test Transactions
- Use Stripe’s test credit cards to simulate payments and validate your integration.
-
Transition to Production
- Once testing is complete and successful, replicate the setup in Live Mode to start selling.