Sell course access and enrol learners automatically after a completed payment. In order to establish a connection between Promote and the Stripe, an initial configuration must be performed on both platforms. This article will guide you through that configuration step by step.
Content in this article
Integration Overview
What this integration does
The Stripe integration connects your Stripe products to Promote programs. When a learner completes a purchase in Stripe, they are automatically enrolled in the matching Promote program and receive an invitation email. No manual work is required.
The integration works with both self-paced individual programs and cohort-based programs with fixed start dates. You can also optionally collect separate participant details at checkout, making it easy to purchase a seat on behalf of someone else.
Why use it?
Stripe is a widely used and flexible payment platform. With this integration, your learners move smoothly from checkout into their training program without delays or manual steps.
It is especially useful for organisations that:
- sell training at scale
- support team or group purchases
- want their payment and learning systems to work seamlessly together
Ready to get started? Follow the step-by-step setup guide below.
Stripe Integration Configuration
1. Creating an API key in Stripe
In order to connect Stripe to Promote you need to create an API key that allows Promote to communicate with Stripe.
- Go to https://dashboard.stripe.com/apikeys
- Click Create restricted key
- Click 'Continue'
- Name the key Promote under Name
- Add your Promote URL to URL “[yourdomain].promotelogin.com”
- Click “Create restricted key”
- Copy the key for step 2 of the "Stripe Integration Configuration", see below
2. Enabling the Stripe connector in Promote
To enable automatic enrollments via payments, this integration requires setup in both your payment provider and Promote. If you’d like to enable payment integration for your Promote site, please contact Promote Support at support@promoteint.com. We will guide you through the setup process.
3. Program Configuration
Once a connection has been established between the two platforms, a Promote program can be linked to a Stripe product to allow automatic enrollment for any users who purchased a product via Stripe.
Self-paced programs
- In Stripe create a product to represent a seat in your program
- From the product, copy the code displayed as Product ID
- Log on to Promote
- Find the program you want to link the Stripe product to
- For self-paced e-learning content it is also recommended to set
- Learner interaction and communication - Individual program
- Timeline type - Individual start/end date
- In the program settings, you will find Integrations further down
- Paste the Product ID you copied from Stripe, into the Identifier field
- Select Stripe in the Integration field
- Click Save changes
Your Stripe product is now connected to your Promote program. When a user purchases the product they will automatically be added to the program and they will be able to access the program immediately since it is configured to allow access without invitation emails and have individual start dates.
The user will have access to the program for 12 months from the day they register.
Cohort programs
- In Stripe create a product to represent a seat in your program
- From the product, copy the code displayed as Product ID
- Log on to Promote
- Find the program you want to link the Stripe product to
- For cohort programs it is also recommended to set
- Learner interaction and communication - Cohort program
- Timeline type - Program start/end date
- Under Integrations
- Paste the Product ID you copied from Stripe, into the Identifier field
- Select Stripe in the Integration field
- Click Save changes
Your Stripe product is now connected to your Promote program. When a user purchases the product they will automatically be added to the program.
Please note that when a program has a start date set in Promote, the user will not be able to visit the program until it opens. With the information provided in the confirmation email, they can however sign in to Promote and see the upcoming program listed.
4. Participant registration information
By default, when a user purchases a course via Stripe a learner will be added to the program in Promote using the email address and cardholder name provided in the transaction.
If you want to separate the information used for the program registration from the information used for the payment, you can add custom fields for this in Stripe. This will for example allow purchasing a course for someone else or use a different email address for the Promote registration and invoice.
To add the custom fields please follow these steps:
- Go to https://dashboard.stripe.com/payment-links
- Edit the existing payment link for your product or if you have not yet created one, click the +New button to create it
- Click on Advanced Options to display all options
- Check the Add Custom Fields option
- Enter Participant's first name as Label name
- Click Add another field
- Enter Participant's last name as Label name
- Click Add another field
- Enter Participant's email as Label name
- Click Update link (or Create link) to save your changes
Important information about custom fields
Field label names: The custom fields have exactly the labels listed in steps 5, 7, and 9 above. When done, please verify that your Advanced options look like this:
Ensure custom fields are mandatory
When using the custom fields they should never be Marked as optional. If the fields are set to optional and left empty by the user, the registration in Promote will fail even if the purchase is completed.
If this would happen you can either refund the purchase in Stripe or manually add the user in Promote.
5. Email program invitations
When a user is added to the program after completing a purchase in Stripe, an invitation email will be sent from Promote by default, to the email provided for the payment.
If you don't want invitation emails to be sent, you can configure this for each product in Stripe:
- Go to the product page for that specific product in Stripe;
- On the right side of the page there's a Metadata option
- Click the edit icon to add new metadata
- Insert a key called invite - it needs to be lowercase;
- Insert the value false - it needs to be lowercase
- Click Save
A purchase of this product will now no longer trigger an email invitation from Promote.
Since the default setting when completing a purchase in Promote is to send an invitation, and this setting is per product, it's necessary to set this to false for all the products where you don't want invitations to be sent.