# Stripe - How to integrate QLM with Stripe Checkout If you use Stripe Checkout as an eCommerce provider, QLM integrates seamlessly with Stripe Checkout's ordering system. To have Stripe invoke QLM during an order, do the following in the Stripe Control Panel: ### Configure the webhook * Login to Stripe.com and go to your Dashboard * Click the Settings icon (gear) on the top right * Click the Developers item and ensure that Workbench is ON * Expand the Developers section at the bottom of your browser (click the ^ button) * Click Webhooks * Click "Add destination" * Select "Events from" Your account * Select an API Version * In the "Events" section, select the following items: * For regular products * checkout.session.completed * For subscription products * customer.subscription.deleted * invoice.payment\_succeeded * Click "Continue" * Enter a destination name such as: QLM * In the Endpoint URL field, enter the URL to your QLM License Server and append the following to the URL: /QlmWebHookHandler?is\_vendor=stripe\&is\_user=\\&is\_pwd=\ where: \: As defined in the QLM Management Console / Manage Keys / 3rd Party Extensions \: As defined in the QLM Management Console / Manage Keys / 3rd Party Extensions Example: ; * Click Create destination ### Get Your Stripe Secret Key QLM requires the Stripe Secret Key to communicate with Stripe. To get the Stripe Secret Key: * Login to Stripe.com and go to your Dashboard * Click the Settings icon (gear) on the top right * Click the Developers item * Expand the Developers section at the bottom of your browser * In the Overview section, click "Manage API Keys" * Get the Secret Key ### Enable Stripe in QLM * Launch the QLM Management Console * Go to the Manage Keys tab * Click 3rd party extensions * Select Stripe * Check the "Enabled" checkbox * Set the API Key to the value of the Stripe Secret Key * Click Ok ### Regular Products * Create a new product of type "One-time purchase products" and set the required fields. * In the Metadata section of the product, add the following entries: | is\_productid | 1 | | ---------------------------- | ------------- | | is\_majorversion | 1 | | is\_minorversion | 0 | | is\_licensemodel | permanent | | is\_vendor | stripe | | is\_emailtemplate | 1. New Order | | is\_features | 0:1 | | is\_send\_mail (as of v18.1) | true \| false | where * is\_productid = your product id as defined in QLM * is\_majorversion = your product's major version as defined in QLM * is\_minorversion = your product's minor version as defined in QLM * is\_features = semi-comma-separated list of feature sets and their corresponding values. Example: is\_features=0:3;1:1. This means that in feature set 0, features 1 + 2 are enabled and in feature set 1, feature 1 is enabled. * is\_user = As defined in Manage Keys / 3rd Party Extensions * is\_pwd = As defined in Manage Keys / 3rd Party Extensions * is\_emailtemplate = email template to use when sending the email to the user. Email templates can be created from the QLM Management Console / Manage Keys / Email Templates * is\_licensemodel = permanent | trial | subscription * is\_send\_mail: instructs QLM to send an email after processing the order
### Subscription Products * Create a new product of type "Recurring products" and set the required fields. * In the Metadata section of the product, add the following entries: | is\_productid | 1 | | -------------------------------------- | ---------------------------------------- | | is\_majorversion | 1 | | is\_minorversion | 0 | | is\_licensemodel | subscription | | is\_vendor | stripe | | is\_emailtemplate | \ | | is\_renewal\_emailtemplate | \ | | is\_features | 0:1 | | is\_send\_mail ( as of v18.1) | true \| false | | is\_send\_renewal\_mail ( as of v18.1) | true \| false | where * is\_productid = your product id as defined in QLM * is\_majorversion = your product's major version as defined in QLM * is\_minorversion = your product's minor version as defined in QLM * is\_features = semi-comma-separated list of feature sets and their corresponding values. Example: is\_features=0:3;1:1. This means that in feature set 0, features 1 + 2 are enabled and in feature set 1, feature 1 is enabled. * is\_user = As defined in Manage Keys / 3rd Party Extensions * is\_pwd = As defined in Manage Keys / 3rd Party Extensions * is\_emailtemplate = email template to use when sending the initial order email to the user. Email templates can be created from the QLM Management Console / Manage Keys / Email Templates * is\_renewal\_emailtemplate = email template to use when sending the renewal email to the user * is\_licensemodel = permanent | trial | subscription * is\_send\_mail: instructs QLM to send an email after processing the initial order * is\_send\_renewal\_mail: instructs QLM to send an email after processing the renewal ### Enable Stripe Checkout To enable Stripe Checkout: * In the Stripe dashboard, go to Settings * Click "Checkout settings" * Click "Enable client-only integration ![mceclip0.png](https://support.soraco.co/hc/article_attachments/360065073492/mceclip0.png) Once Stripe Checkout is enabled, enter **your** web site domain name in the Domains field: ![mceclip1.png](https://support.soraco.co/hc/article_attachments/360065254111/mceclip1.png) ### Create the Stripe Checkout button * In the Stripe dashboard, go to Products * Select your product * In the Pricing section, for a given price, click "..." then select "Get Checkout code snippet". If you do not have a Price item, add one. * In the Checkout snippet generator window, update the Success URL and Cancel URL to point to valid URLs * Copy the generated code and save it in a file on your desktop then publish it to your web site
### Testing an order * Open the file saved in the previous step from a URL (do not test from your local machine) * Click the Checkout button and place an order * Once the order is completed, the following will occur: * A new user will be automatically added to the QLM database based on the information collected during the ordering process. * An activation key will be created in the QLM database and associated with the user. * An email will be sent to the user with the order information and activation keys In order for QLM License Server to send emails, you need to configure your SMTP server. Detailed instructions can be found in this [article](https://support.soraco.co/hc/en-us/articles/207894796-How-to-configure-QLM-to-send-mail-using-SMTP), in the section **Configure the QLM License Server to send emails using SMTP.** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.soraco.co/docs/3rd-party-integration/stripe-how-to-integrate-qlm-with-stripe-checkout.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.