FastSpring - How to integrate QLM with FastSpring (Classic) – Soraco Technologies

If you are using FastSpring as an eCommerce provider, QLM integrates seamlessly with FastSpring's ordering system.

After completing the steps below, when a customer purchases your product from FastSpring, FastSpring will automatically get a license key from the QLM web service and then update the QLM database with the license and customer information.

To integrate FastSpring with QLM, perform the following in the FastSpring Control Panel:

FastSpring Setup for a Basic Product

- Select your product in the FastSpring Control Panel
- Add a Fulfillment Action:
- On the Licenses tab, select "Remote" and click on Next
- Set the URL to: https://qlm3.net/qlmdemo/qlmLicenseServer/qlmservice.asmx/GetActivationKey?is_vendor=fastspring&is_productid=1&is_majorversion=1&is_minorversion=0&is_qlmversion=5.0.00
- You should update the URL above to point to your server and specify your product ID, major and minor version.
- Method: HTTP POST
- POST Encoding: UTF-8
- License Name Type: Person Full Name + Email Address
- Output Format: Plain Text, Single-Line License
- Click on Create
- Click on Save
- In the Fulfilment Actions section, click on Add
- Select Email / Web Notification and click Next
- Reuse Options: Reusable On Multiple Products
- Subject : #{orderItem.display} - Order #{order.reference}
- Email Text Contents : You can download #{orderItem.display} from: Soraco Technologies
- You can customize the Email Html and Web tabs as well.
- Sincerely,
- Should you have any questions please contact us at: sales@soraco.co
- http://soraco.co/products/qlm/qlmsetup5.exe
- Your Activation Key is: #{orderItem.fulfillment.license.outcome.licenses.list}
- Thank you for your purchase of #{orderItem.display}.
- Dear #{order.customer.fullName},

FastSpring Setup for Updating Contact Information

To transfer the contact information from FastSpring to QLM, follow the steps below:

From the FastSpring Control Panel Home page, click on the "Notify" icon in the top toolbar.
Click on Add Notification Rule.
Format: HTTP Remote Server Call.
Type: Order Notification.
Remote Server URL: https://qlm3.net/qlmdemo/qlmLicenseServer/qlmservice.asmx/UpdateUserInformation
Click on Next
In the HTTP Parameters section, click on Add Parameter.
Name: is_avkey
Value: #{orderItem.fulfillment.license.outcome.licenses.list}
Click on Add Parameter again.
Name: is_vendor
Value: fastspring
Optionally, add an is_user and is_pwd parameters to enforce authentication. The user and password can be specified from the QLM Application, under Manager Keys / Commerce Providers.

With the steps above completed, place a test order by clicking on the FastSpring Control Panel Home page, then Store Testing. Once your test order is completed, an activation key will be created in the QLM database along with the corresponding customer and order information.

FastSpring Setup for Maintenance Plan

If you sell a yearly maintenance plan to your customer, you can configure FastSpring to automatically update the maintenance plan expiry date in QLM.

Click on Products and Pages
Click on Create Subscription Product
Name: Yearly Maintenance Plan
Regular Period Length: 1 year
USD: xx
Click on Create
In the Fulfillment section, click on Add
Click on the License tab, select Remote and click Next
URL: https://qlm3.net/qlmdemo/qlmLicenseServer/qlmservice.asmx/RenewMaintenancePlan?is_vendor=fastspring&is_user=john&is_pwd=fast123
License Name Type: Person Full Name + Email
Click on Create
Click on Save
Click on the Home button
Click on Custom Fields
Click on Create Customer Field Configuration
Name: custom_referrer (THIS NAME IS FIXED, IT CANNOT BE CHANGED)
Click on Next
Display: Activation Key
Click on Add Form Field
Input Type: Textbox
Required: Yes
Name: custom_referrer
Question Text: Activation Key
Question Description: Enter your current activation key (starts with the letter A)
Click on Add
Click on Save
Click on Save
In the Conditions section, click on Edit
Select Order Environment Condition and click Next
Environment Tag Exists: is_maintenance_plan
Click on Create
Click on Save
Click on the Home page

To test the maintenance plan configuration:

Click on Store Testing
Click on Optional Parameters
Tags: is_maintenance_plan
Click on the Testing Links tab then Detail for “demo yearly maintenance plan”
Click on Order Now, fill in contact info then Next
The next page should show the Activation Key field.
Go to the QLM Application and locate the license created above.
Enter the Activation Key in the order form and click on Order
Once the order is completed, go to QLM and locate your license key
Refresh the page, select the license and click on the Edit.
Note how the maintenance plan was increased by a year.

FastSpring Setup for Purchasing an Upgrade

If you sell upgrades to a specific version of your software, you can integrate FastSpring with QLM’s license upgrade feature.

Create a Product in a way similar to the first section
Click on Create Product
Name: Upgrade
USD: xx
Click on Create
In the Fulfillment section, click on Add
Click on the License tab, select Remote and click Next
URL: https://qlm3.net/qlmdemo/qlmLicenseServer/qlmservice.asmx/UpgradeLicense?is_vendor=fastspring&is_productid=1&is_majorversion=2&is_minorversion=0&is_qlmversion=5.0.00&is_user=john&is_pwd=fast123
License Name Type: Person Full Name + Email
Click on Create
Click on Save
Create an Email Fulfillment similar to the main Product
Click on the Home button
Click on Custom Fields
Click on “custom_referrer”
In the Conditions section, click on Edit
In the Active Conditions section, click Edit
Environment Tag Exists: is_maintenance_plan, is_ugprade
Click on Save
Click on the Home page

To test the Product Upgrade configuration:

Click on Store Testing
Option Paramaters / Tags: is_upgrade
Click on testing links: Demo Upgrade / Detail
Click on Order Now, then Next
In the QLM Application, create a license key for product Demo 1.0
Enter this activation key in the FastSpring form
Click on Compete Order
Once the order is completed, go to QLM and click on Today's orders
Note how a new key is created replacing the old one.

FastSpring Setup for a Subscription Product

If you sell a subscription based product, you can integrate FastSpring with QLM’s subscription renewal feature.

Create a Subscription-based Product in FastSpring
Click on Create Subscription Product
Name: Your Product
USD: xx
Click on Create
In the Fulfillment section, click on Add
Click on the License tab, select Remote and click Next
URL: https://qlm3.net/qlmdemo/qlmLicenseServer/qlmservice.asmx/GetActivationKeyWithExpiryDate?is_vendor=fastspring&is_productid=1&is_majorversion=1&is_minorversion=0&is_qlmversion=5.0.00&is_user=john&is_pwd=fast123&is_expduration=365
Method: HTTP POST
POST Encoding: UTF-8
Output Format: Single-Line License
Go to the Advanced tab
Set the Fulfillment Applicability to: Applies to Non-Rebills / First Orders Only
Go back to the Fulfillment section and click on Add
Click on the License tab, select Remote and click Next
URL: https://qlm3.net/qlmdemo/qlmLicenseServer/qlmservice.asmx/RenewSubscriptionHttp?is_vendor=fastspring&is_user=john&is_pwd=fast123&is_expduration=365
Method: HTTP POST
POST Encoding: UTF-8
Output Format: Single-Line License
Go to the Advanced tab
Set the Fulfillment Applicability to: Applies Rebills Only
Create an Email Fulfillment similar to the main Product (details as described in the previous sections).
Click on Save

To test the Product Upgrade configuration:

Click on Store Testing
Select your subscription-based product and click on Detail
Go through the order process
A subscription-based license key will be created.
In the QLM Application, verify that the license key was indeed created.
In FastSpring, click on the Reports button in the toolbar
Next to the Recent Orders button, click on View
Locate the order you just placed and click on the arrow button.
In the Subscriptions panel, click on the product name
In the Actions panel, click on Simulate Next Billing
In the QLM Application, refresh the grid view and verify the SubscriptionExpiryDate was pushed by a year.