Classic FastSpring users now manage their Reseller Partners and Reseller Stores from the FastSpring App. Access your Store and Account with the new user interface at app.fastspring.com.

A Reseller Partner is an individual or organization that purchases products from you, the seller, with the intention of reselling them instead of using them.

Seller Capabilities

After FastSpring adds a Reseller Partner Store to your account, you can:

Reseller Capabilities

After your Reseller is approved, they can:

Request a Reseller Partner Store

Reseller Stores are temporarily unavailable in the Contextual platform. Until further notice, only sellers using the Classic platform can request a Reseller Partner Store.

To add a Reseller Partner Store to your account, please Contact Support. You will be notified after the Reseller Store has been set up in your account. Then, add existing products, new products, and fulfillments to the Reseller Store.

Access your Reseller Partner Store

  1. Log in to the FastSpring App with your existing credentials. A page appears with your existing Stores. 
  2. Your Reseller Store is marked with a blue reseller tag, as pictured below. Select the Reseller Store to access it’s Dashboard. 
  3. From the Dashboard, you can see all of the features that were available in the previous version in addition to new Reports and Partners features. 

Reports

From the left menu of the FastSpring App, select Reports to view automatically-generated reporting on your sales. Utilize the left menu to track sales in categories including:

Set Up a Reseller Store

Reseller Stores are only available to Classic FastSpring users at this time.

After Customer Support accepts your request for a Reseller Store, configure at least one product, fulfillment, and Reseller Partner. After the Reseller Store is set up, add a reseller partner and configure their selling privileges to enable them to sell. See Manage Reseller Partners below for more information.

Add an Existing Product

Add existing products from your Classic Storefront to the Reseller Store. This allows the reseller partner to purchase pre-configured products instead of new products in the Store. Resellers may purchase these products with their Credits or any of your accepted payment methods.

In order to add an existing product to a Reseller Store, the product must be set to Active in your Classic Storefront.
  1. In the FastSpring App, navigate to the Classic Storefront with the products you want to resell.
  2. Click Products and Pages, then select the product.
  3. Under Actions, click Duplicate Product. The Product Naming dialog appears.
  4. In the Product Catalog drop-down, select your Reseller Partner Store.
  5. In the Product Name field, enter a name for internal references.
  6. In the Display Name field, enter a consumer-facing name for the product.
  7. Click Create

Add a New Product

This process creates a new product in the system and associates the product with a URL. After the product is created, you can customize additional settings, including: description, image, fulfillment actions, and discounts and coupons. Utilize the Preview Store to perform tests of the product.

  1. After finalizing the product configuration, set it to Active.
  2. From the Reseller Dashboard, click Products and Pages. A product configuration dialog appears. 
  3. In the Actions dialog, click Create Product. A product configuration dialog appears. 
  4. In the Product Name field, enter an internal-facing name for reference. 
  5. In the Display Name field, enter a consumer-facing name for the product. 
  6. In the Display Price dialog, enter the price of the product in the applicable currencies.
    To enable more currencies, go to Store Settings > Payment Methods.
  7. Optionally, add a consumer-facing Description of the product. 
  8. Select Choose File to upload a Display Image for the product. 
  9. Click Save

Add a Fulfillment 

After you have created a resale product, add a Fulfillment to it. For more information on how fulfillments are generated and distributed, see How Resellers Purchase and Distribute Products.

  1. Select Products on the left menu of the FastSpring App. A list of resale products appears. 
  2. Click the specific product to access its Details Page. 
  3. Next to Fulfillment Actions, click Add
  4. Select the appropriate fulfillment for the product. You can assign multiple fulfillment actions, such as an email with a license or file download.
  5. Repeat this process to apply each additional fulfillment.

Product Prices for Resellers

Each Reseller receives an automatic source associated with them. To create a price for a specific Reseller, edit the Link Source Pricing Conditions.

  1. Select Products on the left menu of the FastSpring App. A list of resale products appears. 
  2. Click the specific product to access its Details Page.
  3. In the Actions dialog, click Edit Price > Create Price. The Create Price dialog displays. 
  4. Select the Price Type
  5. In the Price Value field, enter the price of the product for your Reseller Partner. 
  6. Click Create

Manage Reseller Partners

Add a Reseller Partner

Reseller Partners must be added and approved by the seller in order to utilize the Reseller Store. You can add a Partner through the FastSpring app, following the instructions below. This will automatically approve their access. Alternatively, direct a Partner to https://sites.fastspring.com/reseller-store-example/signup to sign themselves up. They can begin selling as soon as you manually approve them.

  1. From the Dashboard of the Reseller Store, click Partners. This page manages your Reseller Partners and their accounts.
  2. In the Actions field, click Add Partner. A dialog appears. 
  3. In the Partner section, fill out the information of your Partner’s Reseller Store. The Company is the name of the Store. 
  4. Under Contact Information, provide the Name, Email and Phone Number of the Partner in charge of the Reseller Store. 
  5. Click Create. The Partner will receive an email containing access information.

Reseller Partner Access

Each Reseller will have their own FastSpring App login with access to:

The Reseller will create Orders for consumers and issue licenses by entering the consumer information (name, company, and email) and send the fulfillment through the FastSpring App.

Add a Credit Limit

In Partner Management, click on the Reseller’s name to access their information. At the top of the page, under Order Settings, select a Credit Limit option:

If you choose to enable the Credit Limit, enter your desired Credit Limit and click Save. You can adjust this setting in the future. 

Share a Product with your Reseller Partner

In order for your Reseller to see the products from their Dashboard, configure a Link Source Price Condition and assign the price to the Partner Store.

  1. From the Dashboard of the Reseller Store, select Products and Pages. Select the product you want to share with your Reseller to access its Details Page. 
  2. Under Actions, click Edit Price
  3. Under Conditions, click Edit. Select the Link Source Condition radio button, then click Next. The Add Link Source Condition page appears. 
  4. Select the checkbox of each reseller store you want to add the product to. Click Create.

When a consumer completes an order using a Popup Storefront, the modal dialog closes, and the window shade disappears. The consumer returns to the page on your website that launched the Popup Storefront. However, you may prefer to redirect consumers to a different page on your site (such as a custom “thank you” page).

To implement this redirect, create a JavaScript function to handle the redirect and add a single line to the Store Builder Library code that loads the Popup Storefront.

Assign a JavaScript Function to the data-popup-closed Event

The data-popup-closed Store Builder Library method can invoke a custom JavaScript function when a consumer exits the Popup Storefront dialog. This can occur when they select X to close the dialog, or Continue. When the transaction is completed, the method delivers an object containing the order reference and the internal order ID to the specified JavaScript function.

For example:

If the purchase is incomplete, these values will be null.

To assign your custom JavaScript function to the data-popup-closed event, add a line to the Store Builder Library code you have copied and pasted from the FastSpring App. For example, if your custom JavaScript function is named “onFSPopupClosed”, you would add this: data-popup-closed=”onFSPopupClosed”

Example of a Popup Storefront with a data-popup-closed function assigned

Example JavaScript Function

This example of a JavaScript function redirects consumers who have purchased successfully to a custom page. You could embed this example in the body of your webpage that loads the Popup Storefront, after the Store Builder Library code.

First, the redirect function checks for an order reference returned via the data-popup-closed event. If an order reference is present, the event logs it to the browser’s console, and the consumer is redirected to a custom page. If no order reference is present when the popup closes, that indicates that the consumer closed the popup before completing the order. In that case, the example above writes a simple message (“no order ID”) to the browser’s console log.

This example is for illustrative purposes only. You must modify it (with at least the Target URL) before deploying the code to your webpage. Knowledge of Javascript is useful in implementing this.

Grant Immediate Access to Fulfillments

If you plan to grant access to a product or service immediately after completion of transaction processing, you should validate order data first. To do this, make a GET call to the /orders endpoint of the FastSpring API using the order ID returned via this event. This allows your to validate the transaction details before granting access to the user.

You can also use the /orders API endpoint to retrieve transaction details and populate your custom landing page with consumer or order-specific information.

Table of Contents

Popup Storefronts provide a same-page checkout experience to your customers, enabling them to complete the checkout process without leaving your website.

When a customer clicks “Buy Now”, your website prepares the order contents from the Store Builder Library. Then, a checkout window appears in a popup directly over the webpage, as seen below. After your customer enters their payment information, FastSpring handles the payment processing and fulfillments.

2021-09-01_10-33-29.png

When using a Popup Storefront, we recommend that you deploy a security certificate and use the https: protocol for your website. This prevents web browsers from displaying warning messages about non-secure pages.

Create a Popup Storefront

  1. In the FastSpring App, navigate to Storefronts > Popup Storefronts. Click Create Popup Storefront.
  2. In the Company Sub-Directory Storefront ID field, enter an ID for your new Popup Storefront. The ID you enter becomes part of the Storefront’s URL.
  3. Click Create. Your new Popup Storefront appears in your Popup Storefronts page.

After you have initially created your Popup Storefront, you can customize it to match your website. From the Popup Storefronts page, click Settings.

When editing your Popup Storefront, select Save and Preview at the top, right corner of the popup configuration page to display the current configurations. This preview uses a sample 14.95 monthly subscription.

Configure your Checkout Experience

Click the Settings button on your Popup Storefront. This directs you to the checkout configuration page.

Checkout Experience

In the Checkout Experience section, configure the information that you would like FastSpring to display to customers at checkout, and their customization capabilities:

Promotion

In the Promotion section, you can enable customers to enter coupon codes (that you configure) at checkout in order to receive discounts.

Customer Information

In the Customer Information section, configure the information that you would like to collect from customers at checkout.

Completion Page

After a customer completes a successful purchase, the Completion Page appears, containing display options that you configure.

Purchaser Settings

If enabled in your Storefront, FastSpring can send fulfillments to recipients who did not purchase the product.

Customize the Styling of your Popup Storefront

In the Styling section of the Popup Storefront Settings page, you can adjust the appearance of the Storefront to match your website.

Checkout Title

The Checkout Title is the heading of the Popup Storefront. You can configure this to include your company’s logo and branding styles.

Checkout Text

Tax Text

Pricing Block

Payment Button

Corner Radius

In the Corner Radius fields, you can customize the roundness of the panels and buttons on your storefront. Selecting 0px results in square corners; higher pixels cause more rounded corners.

Margin + Order Total, Tax and Savings

Specify pixel measurements to customize margin heights in your Popup Storefront. Selecting higher values results in larger margins.

Completion Page: Download Button

Completion Page: Continue Button

Completion Page: Checkmark Color

Analytics Integration

In the Analytics Integration subpage of Popup Storefront Settings, you can configure optional integrations with Google Analytics and Google Tag Manager. By default, your Popup uses the settings configured in the Integrations menu, however you can override these settings for a specific storefront.

PayPal

In the PayPal subpage, you can control the logo and store title displayed in the PayPal login window when a customer completes their purchase with PayPal.

After you create a Store and a Web Storefront, you can click the Settings button to access the configuration pages. These pages control the branding, localization, customer communication, and appearance associated with the storefront. If you have configured default settings at for your overall Store, you can override default settings within the subpages below. 

Edit your Storefront Settings

You can customize the appearance and UX of each of your Web Storefronts in the FastSpring App. 

  1. Navigate to Storefronts > Web Storefronts
  2. Click Settings on the Web Storefront you want to customize. A list of subpages appears. 
  3. Select a subpage to edit the associated information. Click on the drop-downs below to access more information on each page. 
  4. Save your changes. 

General Settings

From the General Settings tab, you can configure settings that apply to each page on your Web Storefront. 

Fill out following fields to customize your storefront settings:

Customer Information

Header Settings

The Header Settings control the appearance of the section at the top of your Web Storefront. This applies to all pages within the Storefront. 

Size and Behavior Settings

Links Settings

The Links section controls the display of hyperlink texts in the header of the header. To customize links in the footer and body of your Web Storefront, see Footer Settings and Page Settings below. 

Background Settings

Footer Settings

The footer settings control the appearance of the bottom of your Web Storefront. The footer is identical on every page of your storefront. It appears directly above the section that identifies FastSpring as the Merchant of Record. 

Footer Text Settings

Footer Links

Footer links settings control the appearance of hyperlinks in your Storefront’s footer. These settings also apply to the text configured in the section above. See Header Settings above, or Page Settings below to configure links in the heading and body of the Storefront. 

Page Settings

Page settings control the style of specific content within the body of each page on your Web Storefront. The body includes all content in between the header and the footer. 

Links on Pages

Links on Pages settings control the appearance of hyperlinks in the body of your Web Storefront. See Header Settings and Footer Settings above to configure links in the header and footer of your Storefront.

Background

The background section of page settings controls the background of the content section between the header and footer of your Web Storefront. See Header Settings and Footer Settings above to customize their background display. 

Products and Prices

The Products and Prices subpage controls the sizing of product titles and icons, and the color of product prices displayed on your Web Storefront. 

Price

Products

Products as Offers

The following settings apply to product offers that you display on your Web Storefront. The settings applied here only apply to offers displayed on your storefront. To control the settings of all other products, see Price and Products above. 

Homepage

The Homepage subpage controls the appearance and behavior of elements and features that are unique to your storefront’s homepage. 

Buttons

The Buttons subpage controls the appearance of all buttons on your Web Storefront. Some settings can be controlled separately for each type of button.

Example:

Corner Radius = 8px
Border Width = 3px
Border Color = rgb(0,0,0)(black)

Types of Buttons

Completion Page

The checkbox labeled Enable licenses on completion page controls whether or not configured fulfillments appear on the Completion page following a successful purchase. 

Customers can also access their fulfillments through their receipt emails, or their account management portal

Promotions

The Promotions subpage controls the behavior of your Web Storefront’s promotional features. This includes promotional codes, cross-sells, upsells, and popup offers when a customer does not make a purchase immediately. 

Promotional Code

This section controls the behavior of the coupon code field at checkout. If displayed, customers can input coupon codes that you configure to receive a discount at checkout. 

Product Page

The Product Page subpage controls the positioning of cross-sell and upsell offers in the product catalog. This placement is in relation to the products which trigger the offers.  

Abandoned Cart Popup

If you plan to use a cart abandonment popup dialog, you can control the appearance in this section. This will display when a customer leaves the page open in their browser without completing a purchase. This only appears if there are items in the cart.

Analytics Integration

From the Analytics Integration subpage, you can customize the integration between your Web Storefront and your Google Analytics account. 

Google Analytics

Google Tag Manager Integration Behavior

Checkout

If gift purchases are enabled in your Store, you can control the availability of gift purchases for this Web Storefront. Select Enable Gift Purchases to allow customers to purchase on behalf of a recipient in this Storefront. 

PayPal

The PayPal subpage lets you customize the PayPal logon window that appears when a consumer chooses to pay with PayPal.

Table of Contents

A Web Storefront is a website hosted securely by FastSpring that displays your product information and allows consumers to purchase your products. You can have as many Web Storefronts as you need in each Store, and customize each one to look and feel different than the others.

Each Store has a default Web Storefront that controls the appearance and styling of the Account Management site. Your default Web Storefront is indicated by a button in the top, right corner. You cannot change which Web Storefront is the default, but FastSpring can change it for you. 

Different web browsers have different options that must be set regarding the Content Security Policy. Since Web Storefronts set all the various options (in support of various browsers), some browsers may show “errors” in the browser’s console regarding unsupported commands. These errors are to be expected and should not cause issues. 
 

Web Storefront Pages

Each Web Storefront consists of several pages, though not all customers will see every page in the Storefront, depending on how they interact with the Storefront. 

Homepage:

The homepage is where your products are listed. Product Offers may be instantly displayed in-line when the consumer clicks an item’s “buy” button. 

Product Page:

The Product Page lists a specific product along with any applicable Product Offers or Product Options. You have the option to link to the Product Page directly from your website. If your website has a product listing or catalog page, you can link directly to the Product Page of your Web Storefront instead of the Homepage. When the Product Page loads, the chosen product is pre-selected for purchase, and cannot remove the product. Consumers can proceed directly to payment. 

Web Storefronts do not maintain consumers' cart contents between sessions. If session persistence is important to have, consider using the Store Builder Library instead of a Web Storefront. 

Payment Information:

In the Payment Information popup window, the consumer enters payment details such as name, email address, and credit card information. 

Completion Page

The Completion Page displays the order reference, your after-purchase instructions, and applicable fulfillment information upon completion of a successful purchase. 


 

Create a New Web Storefront

  1. In the FastSpring App, click Storefronts > Web Storefronts.
  2. Click the Create Web Storefront button on the top, right corner of the page. The Create Web Storefront popup window appears. 
  3. In the Company Sub-Directory Storefront ID field, enter an ID for your new Web Storefront (with no spaces). The ID becomes part of the Storefront's URL. For example, if you wanted to create a special Storefront for a holiday promotion, you can enter holiday.

  4. Click Create. Your new Web Storefront appears in the list of Storefronts.
     
New Storefronts are offline by default. If you are setting up your Store for the first time, the Store can be switched to online after activation. It must be online to use, however the option is unavailable prior to activation. 
 

Copy an Existing Web Storefront

  1. In the FastSpring App, click Storefronts > Web Storefronts.
  2. Click the More button below the Storefront you want to copy, and then select Copy.
  3. The Copy popup window appears. In the To New Storefront URL field, enter an ID for your new Web Storefront (with no spaces). This becomes part of the Storefront's URL. For example, if you wanted to create a special Storefront for a holiday promotion, you can enter holiday.
  4. Click Finish. Your new Web Storefront appears in the list of Storefronts.
Storefronts are Offline by default. Click the Offline button and select Switch to Online to begin processing live customer transactions via the Storefront.
 

Select Products to Display on Homepage

The Homepage of a Web Storefront lets you display an organized list of the products in your FastSpring Store, like a product catalog. You can select to display up to 2 groups of products on this page.

  1. In the FastSpring App, select Storefronts > Web Storefronts.

  2. Click the Homepage button for the Storefront you want to edit. The Homepage Products popup window opens

  3. This window consists of two main sections: Main and Secondary. The Main Heading and Main Products fields control the top or upper section of the Homepage. The Secondary Heading and Secondary Products fields control the lower section of the Homepage. The secondary section is optional.

  4. Optionally enter heading text to be displayed on the Homepage above the products in a section. Click the Main Heading or Secondary Heading field and enter the text. Click the language drop-down to enter the heading text in additional languages.

  5. Use the Main Products field and Secondary Products field to choose which products appear on the Homepage. Click the text field to begin typing the name of the product you want to add, and a list of matching products pops up.

  6. Click Save.

This article describes the order flow process and concepts. It can be helpful to understand the order flow regardless of whether you are planning to use a Web Storefront, a Popup Storefront, or a custom solution. (For example, using Store Builder Library or the FastSpring API.)

The order flow consists of 5 phases:

  1. Checkout Preparation
  2. Customer Checkout
  3. Payment Processing
  4. Order Fulfillment
  5. Order Completed

Each phase is described below.

Checkout Preparation

The first step is to set up the order details. There are a variety of ways you can do this:

Customer Checkout

This step is where the customer determines the payment method they wish to use and provides their payment details. You can find additional details about customizing the flow for each type of Storefront:

Payment Processing

Once the customer has submitted their payment details, FastSpring analyzes the transaction information for potential fraud or other risk factors. If an issue is discovered, the order is canceled and the order.failed webhook event fires. Valid orders continue through the charging process. If the charge is successful, the order moves to the Order Fulfillment phase of the process. If the charge is unsuccessful, the order.failed webhook event fires, and the order is canceled.

 Tip

If the order contains a subscription product, a subscription instance is created. See Integrating your Tools with FastSpring Subscriptions for more information regarding subscription integration.

Order Fulfillment

The fulfillment of the order does not occur until the payment has been successfully processed. At that time, FastSpring attempts to fulfill the order. If any issues occur during the fulfillment of the order, the fulfillment.failed webhook event fires. Following the fulfillment phase, the order moves to the Order Completed phase.

Order Completed

At this point in the process, the order is finished. The order completion page appears to the customer, all relevant email messages are sent, and the order.completed webhook event fires.

The following diagram explains each of the phases described above.

Example of an order flow with no errors during payment or fulfillment processing:

  1. Add the Store Builder Library to your website.
  2. A visitor lands on your website, where you can display localized pricing for products and maintain the cart state using the Store Builder Library.
  3. The visitor adds products to the cart (without leaving your website).
  4. The session state is maintained in the background (and will be kept for 24 hours).
  5. The visitor clicks “Checkout.”
  6. The session details are passed to a Web Storefront or a Popup Storefront.
  7. The customer submits their payment details.
  8. The order is fulfilled.
  9. The order is completed.

Table of Contents

Consumer Location

By default, Web and Popup storefronts automatically set the Order Country based on the geographic location of the consumer’s IP address. The selected countries have multiple impacts on the consumer’s purchase process, including:

The selected country does not control the selected language.

If you set up a Storefront for use by consumers in a specific location, consider overriding the automatic country selection process and set a specific order country to use by default.

Available Languages and Currencies

Currencies and languages can be limited at the individual Storefront level, or for the entire Store. For a list of available currencies, see Currencies, Conversions, and Taxes, and Country-Based Default Currencies.

Russian Rubles (RUB) and South African Rand (ZAR) are supported but disabled for all Stores by default. Enabling either of these currencies makes PayPal unavailable as a payment option in the corresponding countries.

Apply a Default Country

To override the consumers’ country selection, set a default country for your Store or Storefront.

  1. From the Storefronts menu, navigate to the Popup or Web Storefront you want to adjust.
  2. Click the More > Languages and Currencies. The Languages and Currencies popup window appears.
  3. In the Default Country field, enter the ISO country code of the country that you want the Storefront to use by default. For example, for Germany, enter DE.
  4. Click Save. Allow up to ten minutes for Live Storefronts to be updated.

Limit Available Currencies for a Storefront

  1. From the Storefronts menu, navigate to the Popup or Web Storefront you want to adjust.
  2. Click the More > Languages and Currencies. The Languages and Currencies popup window appears.
  3. Select Override Store Currencies. The window expands to display a series of currency checkboxes.
  4. Make sure the only checkboxes selected are those your Storefront supports. If you no longer support specific currencies, clear those checkboxes. For a list of currency codes by country, see Country-Based Default Currencies.
  5. Click Save. Allow up to ten minutes for Live Storefronts to be updated.

Limit Available Currencies for your Store

When you limit currency options for your Store, the limitations apply to all of your Popup and Web Storefronts. To apply these limitations to specific storefronts, see Limit Available Currencies for a Storefront above.

  1. In the FastSpring App, navigate to Settings > Store Settings > Localization.
  2. Under Available Currencies, select each currency you wish to support, and deselect those you do not want to support. For a list of currency codes by country, see Country-Based Default Currencies.
  3. Click Save at the top of the page. Allow up to ten minutes for Live Storefronts to update.

Limit Available Languages in a Storefront

  1. From the Storefronts menu, navigate to the Popup or Web Storefront you want to adjust.
  2. Click the More > Languages and Currencies. The Languages and Currencies popup window appears.
  3. Select the Override Store Languages checkbox. The window expands to display the available language checkboxes.
  4. Clear the checkbox next to any language that you do not want the Storefront to support.
  5. Click Save. Allow up to ten minutes for Live Storefronts to be updated.

Table of Contents

Each Storefront has a Test URL that is accessible at all times. Making test orders on this URL will emulate the buyer experience at checkout, without affecting the reporting of orders and transactions in your Store. If you utilize a coupon code for a Test Order, it does not count against usage limitations set for that code.

The FastSpring Terms of Service do not allow load testing, attempts to breach security, or intentional interference with the FastSpring Service.

When testing orders, we recommend that you enter your personal email address. This way, you will receive the customer notifications applicable to your test purchases.

Testing Orders on Web Storefronts

After you configure your Web Storefront and add at least one product to the Homepage, you can test the checkout experience. Test Storefronts show the products configured for your Storefront Homepage, including product names, icons, descriptions, prices, discounts, upsells and cross-sells.

  1. In the FastSpring App, navigate to Storefronts > Web Storefronts > Links. A popup window appears:
  2. Open a link with a Test tag to the left of it.
  3. Optionally, enter a coupon code. Select Credit / Debit card to check out.
  4. In a separate tab, navigate to Storefronts > Web Storefronts. On the applicable storefront, click Test. Input this credit card information in the test storefront.
  5. In the Expiration Date field, enter any date in the future.
  6. In all other fields, enter the information desired. When finished, click Pay.

This will emulate a consumer experience, including fulfillment emails, without incurring a charge or affecting the reporting of your Store.

You can also access the Test Storefront from the Settings page by clicking Save and Preview, or by typing .test. in your Store URL between your store name and onfastspring.com.
  1. In the FastSpring App, navigate to Storefronts > Popup Storefronts. Select Preview. The Popup Storefront appears.
  2. In a separate tab, navigate to Storefronts > Popup. On the applicable storefront, click Test. Input this credit card information in the test storefront.
  3. In the Expiration Date field, enter any date in the future.
  4. In all other fields, enter the information desired. When finished, click Pay.

Placing Test Orders on your Website

  1. You can also make test orders from your website if the popup storefront is already placed there. However, if you make modifications to the storefront, this can result in them being visible to the public. Because of this, we recommend testing with an offline version of your storefront.
  2. In the JavaScript library on your page, adjust the storefront’s URL by inserting .test. between the storefront name and onfastspring.com.
  3. Click a link on your webpage that was configured to invoke a Popup Storefront. The Popup Storefront appears on your website.
  4. Use the test order information to complete a test purchase.

Testing Orders from the Product Configuration Page

You can also make test purchases from the product’s configuration page.

  1. On a product detail page, click Checkout Links. A popup appears.
  2. Select the Web Storefront or Popup Storefront radio button, depending on the type of Storefront you are testing.
  3. Next to the Test tag, select the URL of the storefront from which you would like to place a Test Order. Click Open.
  4. Use the card information in the popup to make a test purchase.

Depending on the type of Storefront you have configured, there are various URLs you can use to access it. 

Each FastSpring Store has a unique subdomain, which is set at the time of Store creation and cannot be changed afterward. 

Access your Web Storefront URLs

  1. In the FastSpring App, navigate to Storefronts > Web Storefronts
  2. On the applicable Web Storefront, click Links. A Popup appears.
  3. Select the Link you would like to access or use:
  4. To access the page associated with the link, click Open. You can also highlight the link to copy it.
You can link to Storefronts by using the FastSpring API to generate a session URL. To do that, POST order details to the /sessions endpoint. The API responds with a unique session id that you can append to the Storefront URL like this:  https://acme.onfastspring.com/session/{session id}. Alternatively, calling the Store Builder Library's fastspring.builder.checkout({session id}) loads the session in the Storefront specified upon loading the library.

 

Access your Popup Storefront URL

Although you cannot link directly to a Popup Storefront using a hyperlink, every Popup Storefront has a URL.

  1. In the FastSpring App, navigate to Storefronts > Popup Storefronts.
  2. On the applicable Popup Storefront, click Place on your Website. The Checkout on your Website dialog appears.
  3. Next to data storefront =, the URL of your Popup Storefront is located within the quotation marks.
To access the Test version of the Popup Storefront, type .test between the Base URL and .onfastspring.com.

Table of Contents

In the FastSpring App, Storefronts are tagged with a green or gray indicator that they are Online or Offline. You can click this indicator to switch your Storefront on or offline. 

New Storefronts are set to Offline by default. After you have fully configured a Storefront, you can switch it to Online, and place it on your website. This makes it accessible to your customers to purchase the products configured for that Storefront, and request quotes and invoices. Because of this, we recommend that you do not publish the Storefront until you have fully configured your Store.

However, you can still make changes after your Storefront is live. We recommend making an offline copy storefront, and then overriding the published Store with those settings. See Edit an Online Storefront for instructions.

Offline Storefronts

When a storefront is set to Offline, it is in Test Mode, during which you can place and access test orders through the Storefront. Attempting to access the Live URL for an offline storefront results in a 404 (Not Found) error. In addition, Offline Storefronts:

Default Storefronts remain offline until they are activated by FastSpring Support. We recommend finalizing all settings before activation, as it is simpler to test purchases and customize storefront settings when offline.

Online Storefronts

When a storefront is Online, your customers can make purchases and request quotes and invoices. To place test orders, you must navigate to the Test URL, as Live Storefronts do not accept them. Online Storefronts often have faster performance than Test Mode Storefronts.

Access a Web Storefront

  1. In the FastSpring App, navigate to Storefronts > Web Storefronts.
  2. On the applicable Storefront, click Links. A popup appears. 
  3. In the popup, you are presented with a Live and a Test link for both the Homepage and Product Page. Select the link you wish to access. If you are placing a Test Order, make sure to select a Test link. 
To place test orders on online web storefronts, you can also add .test to the beginning of your store domain in the URL. For example, if your Storefront is yourexamplestore.onfastspring.com/holiday, the Test Store would be yourexamplestore.test.onfastspring.com/holiday. See Test Orders for more information.

With Popup Storefronts, it is easiest to navigate to your website to access the live link. To access the Test link:

  1. In the FastSpring App, navigate to Storefronts > Popup Storefronts
  2. On the applicable Storefront, click Preview. The Test version of that Popup Storefront appears. 

Edit an Online Storefront

To make changes to a Storefront that is live, we recommend copying the storefront to a new, Offline Storefront. To make sure consumers do not experience untested or incomplete changes, create a copy of the Storefront to modify for testing. When you are satisfied with the changes, overwrite the original Storefront with updates. This way, you do not need to take your Store offline, which would inhibit it from processing orders.

  1. In the FastSpring App, navigate to Storefronts. Select Web Storefronts or Popup Storefronts depending on the storefront you want to modify
  2. On the Storefront you want to change, click More > Copy. A popup appears.
    image.png
  3. In the To New Storefront URL field, type a name for the temporary testing Storefront. The name can be anything since the changes will be made public in your Live Storefront.
  4. Do not click the drop-down selector in the To Existing Storefront field unless you want to replace an existing Storefront completely. After you have made and tested your changes, use this field to replace the original Storefront settings. 
  5. Click Finish. All the settings are copied to the new Storefront. 
  6. Apply changes to the newly created Storefront. Test the Copied Storefront until you are satisfied with the changes. 
  7. In the Copied Storefront, click More > Copy. A popup appears.
  8. In the To Existing Storefront field, choose the Live Storefront you originally copied. This action completely replaces all settings for the original Storefront with the modified settings of the copied Storefront. 
  9. Click Finish. The changes made in your Copy Storefront will carry over into the original without taking it offline.

Copy a Storefront to Create a New one

When creating a new Storefront, you can copy an existing storefront to duplicate all applied settings.

  1. In the FastSpring App, navigate to the Storefronts menu > Web Storefronts or Popup Storefronts.
  2. In the list of Storefronts, find the Storefront you want to copy and select More > Copy.
  3. In the copy window, select your preferences

All the settings for the source Storefront are copied. The new Storefront will not be Live until you click the drop-down on the right side of the Storefront listing and select Offline > Switch to Online.