> For the complete documentation index, see [llms.txt](https://docs.soraco.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.soraco.co/docs/3rd-party-integration/fastspring/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: * 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: * 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: * 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.soraco.co/docs/3rd-party-integration/fastspring/fastspring-how-to-integrate-with-fastsprings-new-contextual-storefront-for-a-subscription-product.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.