FastSpring - How to integrate QLM with FastSpring (Classic)
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
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:
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:
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:
Last updated