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.

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 <head> section of your HTML page. From your FastSpring Popup Storefront, click PLACE ON YOUR WEBSITE to get the required code snippet.

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.

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.