FastSpring Classic Store

We are no longer maintaining and testing our integration with FastSpring classic.

These are instructions for our new platform. For customers still using the old platform (if you log in from app.licensespring.com), please contact customer support for instructions on integrating with FastSpring.

FastSpring Classic Store

Configure License Fulfillment Through FastSpring

Duration: 15 minutes

There are 3 parts to the configuration within FastSpring.

1

Configuring Your Product

There is only one thing here - "Product name" needs to match the "short-code" in LicenseSpring:

Inputting Product Name

2

Adding License Generation to Your Product

Login to your FastSpring account. Navigate to the product you are configuring (click on the Store > Products and Pages > [Product name]). Beside “Fulfillment Actions” Click “Add Fulfillment”. Click “Generate a License” > Remote Server Request.

Select Remote Server Request

Fill out the fields in the next step with the following information:

• URL: https://api.licensespring.com/api/fast_license

• Method: HTTP POST

• POST Encoding: UTF-8

• Output Format: Single-Line License (Quantity based)

Click “Create”.

Filling License Generation Fields

3

UUID parameter

Under the "Product Fulfillment" section, in the "Parameters" tab, it's important to input the UUID (Universally Unique Identifier) in order for the system to function correctly and generate the license. The UUID serves as a unique identifier that is essential for the product fulfillment process to work as expected and to ensure that the generated licenses are associated with the correct company.

Find your uuid inside FastSpring integration configuration view under Settings -> Integrations [tab]:

Add Order Webhook Notification

Next, you'll need to configure the post-order notification: Click on “Notifications” in the top right corner.

Figure 7 - Notifications

Add a “custom notification”.

In the next step, use the following information to configure the custom post-order notification:

• Event Type: Order Completed

• Destination: HTTP URL

• Applicable Site: the name of the store for which you are configuring the product for

• Live Server URL: https://api.licensespring.com/api/fast_post_order

• Content Type: JSON (application/json)

license_type parameter is optional, use it to change the default license type if needed

{
  "company_uuid": "API_KEY_GOES_HERE",
  "id": "#{order.id}",
  "is_test": #{order.isTest},
  "created": "#{order.created}",
  "order_type": "#{order.type}",
  "customer_email": "#{order.customer.email}",
  "customer_reference": "#{order.customerReference}",
  "referrer": "#{order.referrer}",
  "license_type": "perpetual",
  "items": [ <repeat value="#{order.allItems}" var="orderItem">
     { 
     "product_name": "#{orderItem.productName}",
     "product_group": "#{orderItem.productGroup}",
     "price_total": "#{orderItem.priceTotal}",
     "license": {
        "key": "#{fulfillment.license.key}",
        "licenses": [<repeat value="#{orderItem.fulfillment.license.licenses}" var="value">"#{value}",</repeat>],
        "max_activations": 2,
        "product_features": ["standard"]
     }
  },</repeat>]
}

Figure 8 - General Settings

Please do not hesitate to contact customer support if you need any help.

Configuring Product Features

Product features in FastSpring can be set-up as "Product choices", which are actually separate products in FastSpring platform. This means that before setting up a feature/choice, you need to create a separate product. Take care to set product name in FastSpring to equal feature code in LicenseSpring. Also, place these products in a separate product group called "features".

Steps:

1

Define product feature(s) in LicenseSpring

2

Create a product group called "features" in your FastSpring store

3

Create "feature products" in "features" product group in your FastSpring store

4

Set up product choice on your base product in FastSpring by selecting "feature products" created in step 3

Product Feature List