Enable aMember integration through your aMember account: https://docs.amember.com/docs/PluginDocs/Payment/FastspringContextual

This article provides information about the third-party service Stargate365.

About Stargate365

Stargate365 is a third-party, user-friendly, online automation tool that makes it easier to connect two or more unrelated web applications. Usually, when two systems do not integrate directly, middleware must be coded and hosted to handle communication between the systems. Using Stargate365, however, these communications can be processed, and tasks can be dynamically triggered using only a limited amount of coding.

FastSpring sellers may choose to use Stargate365 to parse their webhook event posts. Stargate365 can then pass that data to external solutions (e.g., CRM tools or accounting tools such as QuickBooks).

 Important

Stargate 365 is a separate company and is not related to FastSpring. Please bear the following in mind:

To learn more about the possible integration between FastSpring and Stargate365, visit https://www.stargate365.com/Integrate/FastSpring/Default.asp.

This article provides information about using Zapier to manage your FastSpring webhooks.

About Zapier

Zapier is a third-party, user-friendly, online automation tool that makes it easier to connect two or more unrelated web applications. Usually, when two systems do not integrate directly, middleware must be coded and hosted to handle communication between the systems. Using Zapier, however, these communications can be processed, and tasks can be dynamically triggered using only a limited amount of coding.

FastSpring sellers may choose to use Zapier to parse their webhook event posts and then pass that data to external solutions. For example, Zapier may be able to post the parsed data to CRM tools or accounting tools such as QuickBooks).

 Important

Zapier is a separate company and is not related to FastSpring. Please bear the following in mind:

Setting Up a Zap to Parse a Webhook Event

 Note

We recommend creating a separate “zap” for each FastSpring webhook event (e.g., order.completed) to which you want to subscribe, to avoid complications on the Zapier side.
  1. After creating your Zapier account, log on at https://zapier.com/app/login/.
  2. From the menu at the top of the page, click Make a Zap!.
  3. In the left-hand pane, click the Name Your zap field and enter a name for the zap. For example, you might give it a name matching the webhook event that you plan to send to this zap (e.g., order.completed).
  4. In the central area of the page, under Choose a Trigger App, select Webhooks.
  5. In the next dialog, click show less common options.
  6. Select Catch Raw Hook and then click Save + Continue.
  7. In the Pick a Sample to Set Up your Zap dialog, click Copy to copy the Zapier URL to your clipboard.
  8. Log on to the FastSpring App at https://app.fastspring.com.
  9. On the Webhooks tab of the Integrations menu, click Add Webhook.
  10. In the Title field of the Add Webhook dialog, enter a name for the new configuration, such as Zapier. You can add multiple Zapier URLs to the same configuration as needed.
  11. In the Get webhooks from field, select whether you want to send events for live orders, test orders, or both to Zapier.
  12. Click Add.
  13. In the newly created Zapier configuration, click Add Webhook URL.
  14. In the Add Webhook URL dialog, click the URL field and paste in the URL that you copied from your Zapier zap above. Then, select the checkbox next to the webhook event to which you want to subscribe, and click Add.

     Reminder

    We recommend creating a separate “zap” for each FastSpring webhook event type (e.g., order.completed) to which you want to subscribe. Otherwise, you may experience complications on the Zapier side. Therefore, you should only select one event to be posted to the zap URL you are pasting in.

  15. Back in your browser tab with the Zapier page, click OK, I did this in the still-open Pick a Sample to Set Up Your Zap dialog.
  16. In your FastSpring Store, run a test transaction or simulate the event to which you have subscribed above. For example, if you have subscribed to the order.completed event, you can place a new test order to fire that event to the new webhook configuration.

     Note

    You may need to wait a few minutes between creating a new webhook configuration and testing it (e.g., by placing a test order).
  17. Once Zapier has received the webhook event posting, the Pick a Sample to Set Up Your Zap dialog in your Zapier configuration will be updated. You will be able to see that an event has been received, as in the following illustration. Click Continue.
  18. In the Almost finished here! dialog, click the link that reads Your Zap currently lacks an Action step. Add one now!.
  19. In the Choose an Action App dialog, select Code.
  20. In the Select Code by Zapier Action dialog, select Run Python and then click Save + Continue.
  21. Next, in the first field under Input Data, enter “data”. Then click the drop-down selector in the adjacent field and select Raw Body.
  22. In the Code field, first delete the example code and then replace it by copying and pasting in the following code, and then click Continue:
    import json
    webhook = json.loads(input_data['data'])
    output = []
    for event in webhook['events']:
    	output.append(event)
    return output
    

  23. In the Test Code by Zapier dialog, click Send Test to Code by Zapier.
  24. The Test Code by Zapier dialog is updated to let you know that the test was successful. Click Finish.

Congratulations, you have completed the initial setup process for the selected webhook event. You now have access to all of the data in the event for any other steps you may add to your zap.

Next Steps

Once you have set up a zap to parse the incoming data posted from FastSpring for a particular event, the next step is to add one or more actions to your zap to do whatever you want with that data. Zapier offers actions for over 1,000 apps. For example, you might choose to use the Create Sales Receipt action with your QuickBooks Online app to send selected order data to QuickBooks conditionally. If you do not want FastSpring to post data from future test orders to the service, you could add a condition to your zap so that the action would only occur when the Boolean data live field of an order.completed webhook event is true.

 Support Note

If you need assistance setting up integrations from Zapier to third-party services such as QuickBooks, please contact Zapier’s support team or the support contact for the third-party service to which you want to send data.

Once you have added actions to your zap to take advantage of the data it receives, remember to turn on the zap. Turning it on makes it live and ready to execute those actions.

Easy Digital Downloads (EDD) is a free ecommerce plugin for selling digital products on the WordPress platform. It powers more than 60,000 ecommerce stores, ranging from single landing pages to substantial online marketplaces.

It has a wide variety of add-ons that allow you to customize your store to your own needs. These add-ons help you to manage the whole purchase process from beginning to end. Easy Digital Downloads solves the technical aspects of building your own online store, while FastSpring solves the business side.

The FastSpring for EDD plugin takes care of integration between these two platforms.

You can find step-by-step instructions to help you set up the FastSpring for EDD plugin on ProteusPay’s website:

https://proteuspay.com/documentation/how-to-setup-fastspring-for-edd-plugin/

For more information on Easy Digital Downloads, please visit https://proteuspay.com/. Additional documentation resources are available at https://proteuspay.com/documentation/.

If you have any questions about Easy Digital Downloads or need support for the plugin, please use the live chat feature of https://proteuspay.com.

Browser-based user interaction tracking can potentially be blocked by ad blocking software installed on customer’s computers. As an alternative, you may consider using Google Measurement Protocol (GMP) to track user interactions on the back-end (i.e., on your own server).

When using GMP to track user interactions on the back-end, your server must generate a “client ID” for each customer who lands on your website and persist that ID, so it is tracked throughout your site. For more information, see Google Measurement Protocol.

When the customer initiates a purchase, you can pass the client ID to FastSpring along with any other order data, as an order tag. You can find more information about passing order tags in our article Passing and Capturing Custom Order Tags and Product Attributes.

If you do not already subscribe to the order.completedorder.failed, and order.canceled server webhook events, you should do that, and create a script to parse the posts sent by FastSpring for each order. Upon order completion, the JSON order data sent via the webhooks includes the order tags containing the client ID. You can use the client ID to update your records with order information. You can complete the process by sending the tracking request for the client ID from your server. See Webhooks for more information.

 Tip

You can optionally subscribe to the return.created webhook event to tie return/refund information to the tracking client ID. Subscription lifecycle tracking can also be tied to the tracking client ID by subscribing to the subscription.activatedsubscription.deactivated, and subscription.canceled webhook events, all of which include order tags for the order that created the subscription.

In this way, the customer’s web browser is not directly involved in the tracking process. By bypassing the browser, you can bypass ad blocking software and ensure that tracking and reporting occur for all customers.

FastSpring works with a trusted partner, Impact, to provide affiliate marketing solutions for our clients.

For more information about setting up an account with Impact, please contact FastSpring Support.

Set Up Automatic Integration with Impact

FastSpring offers an automated solution to help you set up integration with Impact. This process implements it automatically; you only need to copy and paste the details from your Impact account when prompted.

  1. From the Integrations menu of the FastSpring App, select the Webhooks tab.
  2. Click Add Webhook.
  3. In the Name field, enter Impact Sales Tracking.
  4. Click Add.
  5. Inside the newly created Impact Sales Tracking webhook configuration, click Add Browser Script.
  6. A new browser script appears, and a dialog opens to let you configure the browser script.
  7. In the Name field of the new browser script, enter Impact Sales Tracking – <id>.
  8. Still in the Name field, use your keyboard to replace <id> with your Impact Sales Tracker ID.
    See Finding Your Impact Sales Tracker ID for a visual walkthrough.
  9. Under Events, select the checkbox next to browser.order.completed.
  10. Using your mouse, select all of the placeholder text in the Function field, and then press Delete or Backspace on your keyboard to delete it.
  11. Copy the following JavaScript function and paste it into the Function field:
    JavaScript function for Impact tracking
    function (event) {
        this.load('https:{{{Universal Tracking Tag Script URL}}}', function() {
            
            var trackingObject = {};
            
            trackingObject.orderId = event.data.reference;
            trackingObject.customerId = event.data.account;
            trackingObject.currencyCode = 'USD';
            trackingObject.items = [];
            
            if (event.data.coupons && event.data.coupons[0]) trackingObject.orderPromoCode = event.data.coupons[0];
            
            event.data.items.forEach(function(item){
                trackingObject.items.push({
                    subTotal: item.subtotalInPayoutCurrency,
                    category: "digital",
                    sku: item.product,
                    quantity: item.quantity
                });
            });
            
            ire('trackConversion', {{{Universal Tracking Action ID}}}, trackingObject);
        });
    }
    
  12. In the Function field, select the {{{Universal Tracking Tag Script URL}}} and replace it with the “General Tracking Settings URL” from your Impact account. See Finding your General Tracking Settings URL for a visual walkthrough.
  13. Scroll down to the bottom of the Function field. Then, select the {{{Universal Tracking Action ID}}} and replace it with your Sales Tracking ID; that is, the same value you used in the Name field above to replace <id>.
  14. Click Add.

Within the FastSpring App, you can enable or disable extensions for additional services, including:

Click on the extensions below for instructions configuring them in the FastSpring App, and additional resources.

AdRoll

Configure AdRoll integration

  1. Navigate to Integrations > Extensions > AdRoll.
  2. In the AdRoll window appears, click Setup.
  3. In the AdRoll Advertiseable ID field, enter the AdRoll Advertiseable ID that was generated during SmartPixel setup in your AdRoll account.
  4. In the AdRoll Pixel ID field, enter your AdRoll Pixel ID that was generated during SmartPixel setup in your AdRoll account.
  5. Click Enable.

Bing Ads

Configure Bing Ads integration

  1. Navigate to Integrations > Extensions > Bing Ads.
  2. In the Bing Ads window appears, click Setup.
  3. In the Bing Ads Tag ID field, enter or paste your account’s Bing Ads Tag ID, which you can obtain from the Campaigns, Goals and Conversions page in your Bing Ads account.
  4. Click Enable.

Constant Contact

Configure Constant Contact integration

  1. Navigate to Integrations > Extensions > Constant Contact.
  2. In the Constant Contact window, click Setup.
  3. In the API Key field, enter or paste the API Key provided by Constant Contact for your account.
  4. In the Access Token field, enter or paste the access token for your Constant Contact account.
  5. Click Enable.

Google AdWords

Configure Google AdWords integration

  1. Navigate to Integrations > Extensions > Google AdWords.
  2. In the Google AdWords window, click Setup.
  3. In the Google Adwords Conversion ID field, enter or paste the Google Adwords Conversion ID that was generated during the remarketing setup.
  4. In the Google Adwords Label field, you can optionally enter the Conversion Label from the Event Snippet in your Adwords account.
  5. Click Enable.

Google Analytics

Google Tag Manager

Impact

MailChimp

UpSellit

Configure UpSellit integration

  1. Navigate to Integrations > Extensions > UpSellit.
  2. In the UpSellit window, click Setup.
  3. Enter the “usi_launch_code” provided by UpSellit after the registration.
  4. Click Enable.

DevMate

The Nalpeiron Licensing & Analytics Service offers both online and offline activation, usage analytics, analytics on trial conversions, sales cycles, and more. You can sign up for a free trial for Nalpeiron and integrate the service with FastSpring in just a few short minutes.

Dashboard Setup

In the Dashboard for your FastSpring Store, set up a license fulfillment action, which will issue a license on a non-subscription product.

  1. From the Dashboard, select the Products menu.
  2. Click the ProductsBundles, or Subscriptions tab, depending on the product for which you want to set up Nalpeiron integration.

     Note about bundles

    Bundles can have a fulfillment action, such as a license generator, attached to the bundle itself. However, if the products that make up the bundle (i.e., the bundle children) have their own fulfillments, you might want to avoid setting up a fulfillment action on the bundle. Doing so prevents duplicate fulfillment generation (e.g., having the license key appear twice on the completion page).
  3. Click the product, bundle, or subscription for which you want to set up Nalpeiron integration, to open the product’s details.
  4. In the product details, click ADD FULFILLMENT.
  5. In the Add Fulfillment Action dialog, select Generate a License.
  6. In the resulting drop-down list, select Script (PHP or JavaScript).
  7. Click NEXT at the lower right-hand corner of the page.
  8. Select the desired options for the Output Format and License Name, and ensure that the Script Type is set to JavaScript. Then, click CREATE.
  9. In the Script Source Code (JS) field, replace the existing placeholder content with the following script:
    Example of Nalpeiron integration script
var auth = "<auth><username>YOUR NALPEIRON WEB SERVICES USER NAME</username><password>YOUR NALPEIRON WEB SERVICES PASSWORD </password><customerid>YOUR NALPEIRON CUSTOMER ID</customerid></auth>";

var data = "<data><productid>NALPEIRON PRODUCT ID</productid><amount>"+quantity+"</amount><profilename>NALPEIRON LICENSE PROFILE</profilename></data>"

var response = httpPost("https://my.nalpeiron.com/shaferws.asmx/GetNextLicenseCode", {
    "Auth": auth,
    "Data": data
});
var xml = response.body;
var licenses = xml.match(">(.*)<")[0];
licenses = licenses.substring(1, licenses.length - 1);
licenses = licenses.split(",");
var output = "";
for (var i = 0; i < licenses.length; i++) {
    license = output + licenses[i] + "n";
}
license;
  1. Edit the script to replace the following placeholders with the information from your Nalpeiron account:
  2. ​​​​​​​​​​​​Click  near the top right-hand corner of the page.

For Further Assistance

If you need assistance integrating Nalpeiron with FastSpring, please contact Nalpeiron support.

Accordion

The Nalpeiron Licensing & Analytics Service offers both online and offline activation, usage analytics, analytics on trial conversions, sales cycles, and more. You can sign up for a free trial for Nalpeiron and integrate the service with FastSpring in just a few short minutes.

Quick License Manager (QLM), a product of Soraco Technologies, provides a hands-off solution to licensing and protecting your Windows software application. QLM is a software protection tool that allows you to protect your software application with secure license keys.

Note: Quick License Manager (QLM) is a third-party solution, not provided or supported by FastSpring.

FastSpring Configuration

You can find step-by-step instructions to help you integrate Quick License Manager (QLM) with FastSpring on Soraco’s Support site. The QLM instructions cover license creation and webhook setup for both regular and subscription products:

More Information

For more information on Quick License Manager’s features, editions and documentation, visit https://soraco.co/quick-license-manager/.

This article applies to both Classic and Contextual Stores.

As a best practice, FastSpring limits the use of certain elements (such as specific HTML tags or attributes) when editing certain data fields stored in your FastSpring account.

When attempting to save changes to a record, the presence of any markup elements not specifically listed in this article may result in an error message that prevents saving the update. In that case, the error message displayed on screen will specifically identify the element(s) that you have entered which are not accepted. In order to save your change, you would just need to modify the field contents by removing the specified element(s).

Accepted HTML Elements

Below is a list of HTML Elements that are accepted in fields which allow customization and formatting.

 

Additional HTML Elements Accepted in Some Fields

Certain elements are accepted in some fields but not others. The following elements may or may not be accepted depending on the field you are editing:

 

Localization Elements Accepted

The following list identifies accepted localization elements used in Classic Commerce Stores.

You can find more information about how these elements are used in Translating Product Names and Formatting & Translating Product Descriptions.

 

Control Elements Accepted

The following list identifies accepted control elements used in Classic Commerce Stores.

You can find examples of how these elements are used in Working with Variables in SpringBoard and Single Email Fulfillment for a Product Bundle.