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
  •             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.