> For the complete documentation index, see [llms.txt](https://docs.soraco.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.soraco.co/docs/3rd-party-integration/fastspring/fastspring-how-to-upgrade-a-license-from-fastspring.md). # FastSpring - How to upgrade a license from FastSpring If a customer purchased a specific version of your product or purchased specific features of your product and then decides to upgrade to a new version or to purchase additional features, you can configure FastSpring to upgrade the customer's license in QLM. ### Process Overview #### Provide existing Activation Key In order to perform an upgrade, the customer must provide his existing Activation Key during the ordering process. This is required so that the new order is associated to the existing license. You must therefore create an HTML page on your web site that prompts the user to enter his current Activation Key. #### FastSpring Checkout Once the Activation Key is entered, we will use FastSpring's SBL functions to initiate the checkout process. We will use SBL to specify which new features should be added or which version should the customer be upgraded to. #### FastSpring Fulfillment Finally we will modify the FastSpring fulfillment action to parse the data specified in the SBL payload and invoke the QLM License Server as required. ### Implementation #### Provide existing Activation Key The attached HtmlCode.html file contains a sample html page that displays a text field (Activation Key), a checkbox (to purchase the yearly maintenance plan if you offer one) and a button to start the check out process. The button invokes a Javascript that initates the checkout process. #### FastSpring Checkout For this process, you must first create a FastSpring Popup Storefront. You can find instructions on how to create a Popup Storefront in the FastSpring [help](https://docs.fastspring.com/video-tutorials/how-to-add-a-popup-storefront-to-your-website). In order to use FastSpring's SBL, you must first initiate the SBL library. This is done by adding the FastSpring initialization code to the \ section of your HTML page. From your FastSpring Popup Storefront, click PLACE ON YOUR WEBSITE to get the required code snippet. ![](https://support.soraco.co/hc/article_attachments/115018404106/mceclip0.png) Then, you must create the CheckoutFastSpring function that is invoked when the user clicks the checkout button. A sample implementation is provided in the Checkout.jscript attachment. Insert this script in your HTML page. #### FastSpring Fulfillment Finally, create a new product in FastSpring, for example, create the product "your-fastspring-upgrade-product-code". Add a fulfillment to your product as follows: * Click Add Fulfillment * Select (x) **Generate a License** * Select **Script (PHP or Javascript)** * Click Next * Set Output Format to **Single License Only** * Set License Name to **Not Name Based** * Set Script Type to **JavaScript** * Click **Create** * In the Script Source Code (JS) field, delete the existing code and replace it with the sample code included in the attachment "LicenseGeneratorFulfillment.jscript" * Update the URL as well as the URL arguments as required. Make sure to add the is\_user and is\_pwd arguments as described [here](https://support.soraco.co/hc/en-us/articles/201702694-How-to-define-the-user-password-associated-to-an-eCommerce-provider). To add features to a license, add the is\_features argument with the required features. To upgrade a license to the latest version, simply add the is\_majorversion and is\_minorversion arguments. * [HtmlCode.html](https://support.soraco.co/hc/en-us/article_attachments/115018403086)604 Bytes [Download](https://support.soraco.co/hc/en-us/article_attachments/115018403086) * [Checkout.jscript](https://support.soraco.co/hc/en-us/article_attachments/115018404126)861 Bytes [Download](https://support.soraco.co/hc/en-us/article_attachments/115018404126) * [LicenseGeneratorFulfillment.jscript](https://support.soraco.co/hc/en-us/article_attachments/115018569603)459 Bytes [Download](https://support.soraco.co/hc/en-us/article_attachments/115018569603) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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/fastspring/fastspring-how-to-upgrade-a-license-from-fastspring.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.