Collapse Menu
Docs Home
Extensibility Options
Contact Support

Linking to Your Storefronts

Overview

This article explains the URLs used for your Web Storefronts and Popup Storefronts.

Overview

This article explains the URLs used for your Web Storefronts and Popup Storefronts.

There are various URLs you can use to access your FastSpring Storefronts:

  • With Web Storefronts, you use hyperlinks to send customers from your websites, social media, or email messages to your FastSpring Storefronts. Web Storefront links can go to your Storefront's Home Page (like a product catalog), or directly to a specific product page, and can be for live orders or test orders.
  • With Popup Storefronts, the Storefront lives in a secure iframe on your own web page, so you do not use hyperlinks that point directly to the Storefront. Instead, the Storefront loads when your page loads, using a JavaScript snippet provided by FastSpring in your Dashboard.  The JavaScript snippet includes your Popup Storefront's URL, which can be for live orders or test orders.

Every FastSpring Store has its own domain, which is set at the time of Store creation and cannot be changed afterwards.

Web Storefront Links

In the following examples, the Store domain is "acme" and the Store has a default storefront and a "holiday" Storefront. It has products with IDs of product1, product2, and product3.

Home Page Links

The following example URLs would go to the Home Page of your Web Storefront, which displays the products you have selected in the Home Page products settings, if your Store's base URL were "acme":

  • https://acme.onfastspring.com : Live URL for the default Storefront
  • https://acme.test.onfastspring.com : Test URL for the default Storefront
  • https://acme.onfastspring.com/holiday : Live URL for the holiday Storefront
  • https://acme.test.onfastspring.com/holiday : Test URL for the holiday Storefront

Product Page Links

To continue the example of a Store with a base URL of "acme", the following URLs would show the page for the product with ID product2. Product order pages show a single product with all its upsells, cross-sells and related offers. On such product pages, the product is automatically selected / placed in the cart to speed up the ordering process.

  • https://acme.onfastspring.com/product2 : Live URL for product2 on the default Storefront
  • https://acme.test.onfastspring.com/product2 : Test URL for product2 on the default Storefront
  • https://acme.onfastspring.com/holiday/product2 : Live URL for product2 on the holiday Storefront
  • https://acme.test.onfastspring.com/holiday/product2 : Test URL for product2 on the holiday Storefront

Notes About Web Storefront Links

You can also link to the Storefront with any number of GET parameters for analytics purposes - like ?_ga=... or &kmi=... which will be passed to the analytics and tracking scripts loaded on the page. GET and POST parameters will not change or affect an order flow.

You can also link to Storefronts by using an API to generate a session URL. To do that you need to use /sessions endpoint for the FastSpring API, which will generate the session id that you can append to the Storefront URL (https://acme.onfastspring.com/session/{session id}), or the Store Builder Library's fastspring.builder.checkout({session id}) can be used to load the session, too.

Finding Your Web Storefront URLs via Dashboard

There are two main ways to locate your Web Storefront URLs in the Dashboard. The first is to select the Storefronts menu and the Web Storefronts tab. Then, click the LINKS command for the Storefront to which you want to create links.



The Links dialog will open. Here, you can find a variety of live and test URLs for various pages of the Web Storefront, including Home Page URLs, Product Page URLs for specific products (just click the drop-down and choose any product in the Store), and the code to load Store Builder Library using the selected Web Storefront.

Click the blue Open link next to the desired URL to open the page in a new tab of your browser. You can also copy the resolved URL from your browser's address bar and use that to create links from social media, from your website, or from email campaigns.

Popup Storefront URLs

Although you cannot link directly to a Popup Storefront using a hyperlink, every Popup Storefront does have its own URL. The URL can be found by selecting the Storefronts menu and the Popup Storefronts tab, and then clicking the PLACE ON YOUR WEBSITE command for the desired Popup Storefront.




In the resulting Checkout on your Website dialog, the Popup Storefront's URL can be found as the value between the quotation marks for the data-storefront attribute:



Important:  As with Web Storefronts' URLs, Popup Storefronts can be for live or test purchases. The inclusion of "test" between the Store domain and "onfastspring.com" causes the Storefront to load in test mode. When you are ready to begin processing live customer orders, remove the .test from the Storefront's URL. Fore more information about how Popup Storefronts are implemented, please see Adding a Popup Storefront to Your Website.

Try FastSpring

Get a free account and see why FastSpring is the ecommerce partner of choice for software providers around the world. Try our full-service ecommerce solution today to unlock revenue growth for your online company.