Skip to main content

​
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:
KeyDescription
product_idYour Lukittu product ID (required). Can be a single ID or a comma-separated list of product IDs.

​
Optional Metadata for Lukittu

The following metadata keys are optional and can be added as needed:
KeyTypeDescription
ip_limitNumberMaximum number of IPs allowed.
hwid_limitNumberNumber of concurrent users allowed.
expiration_daysNumberNumber of days until the license expires.
expiration_startACTIVATION or CREATIONDetermines when expiration starts (default: CREATION). Applicable if expiration_days is used.

​
Notes on Expiration and Subscriptions

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

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

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