fastspring-how-to-integrate-with-fastsprings-new-contextual-storefront-for-a-subscription-product.md

FastSpring - How to integrate with FastSpring's New Contextual Storefront for a Subscription Product

FastSpring's Contextual StoreFront uses webhooks to send order information to external services such as QLM. QLM 9.2+ can process FastSpring's webhook notification and create the required license keys based on the order.

Step 1 - Adding a webhook

• Login to the FP storefront
• Expand the Developer Tools section
• Click Webhooks
• Go to the Configuration tab
• Click "Add Webhook"
• Set the Title to "QLM"
• Set "Get webhooks from:" Live and Test Orders
• Click Add
• Click Add WebHook Url
• In the URL field, enter: https://qlm3.net/qlmdemo/qlmLicenseServer/qlmservice.asmx/QlmWebHookHandler?is\_vendor=fastspring\&is\_user=abc\&is\_pwd=def
• Update the URL above to point to your License Server. Update the credentials to match the credentials you defined in the QLM Management Console / Manage Keys / 3rd Party Extensions. If you are testing with the Demo License Server, remove the is_user/is_pwd arguments from the URL.
• In the Events section, check "order.completed"
• Click Add

Step 2 - Product Configuration

In order to create a license associated with a given product, you must add a FastSpring Fulfillment Action as described below:

Add the first fulfillment action, for the initial order:

• Select your Product in FastSpring
• In the Fulfillment section, click ADD FULFILLMENT
• Check the "Generate a License" radio button, select "Remote Server Request" then click Next
• In the URL field, enter: https://qlm3.net/qlmdemo/qlmLicenseServer/qlmservice.asmx/GetActivationKey?is\_vendor=fastspring\&is\_expduration=31\&is\_productid=1\&is\_majorversion=1\&is\_minorversion=0\&is\_qlmversion=5.0.00\&is\_features=0:3\&is\_licensemodel=subscription\&is\_user=abc\&is\_pwd=def
• Update the URL above as required to match your own server and product
• Set the Method to: HTTP POST
• Set the Encoding to: UTF-8
• Set the Output Format to: Single-Line License (Quantity Based)
• Click CREATE
• Click the Advanced tab
• In the Fulfillment Applicability drop down, select: Applies to Non-Rebills / First Orders Only
• Click Ok

Add the second fulfillment action, for the recurring payment:

• In the Fulfillment section, click ADD FULFILLMENT
• Check the "Generate a License" radio button, select "Remote Server Request" then click Next
• In the URL field, enter: https://qlm3.net/qlmdemo/qlmLicenseServer/qlmservice.asmx/RenewSubscriptionHttp?is\_vendor=fastspring\&is\_expduration=365\&is\_maintenance\_plan=1\&is\_user=abc\&is\_pwd=def
• Update the URL above as required to match your own server and product
• Set the Method to: HTTP POST
• Set the Encoding to: UTF-8
• Set the Output Format to: Single-Line License (Quantity Based)
• Click CREATE
• Click the Advanced tab
• In the Fulfillment Applicability drop down, select: Applies to Rebills Only
• Click Ok

Add the action required to publish customer information to QLM:

• Next, click the Options dropdown in the top menu and select Custom Attributes.
• Set the KEY to: webhook_action
• Set the Value to: UpdateUserInformation
• Click Save

This completes the integration with FastSpring New Contextual Storefront.

You can now place a test order and confirm that:

• A license key is created in QLM that matches the FastSpring order
• Customer Contact Information is automatically created in QLM.
• The email that's sent to the customer includes the License Key that was generated by QLM.