Collapse Menu
Docs Home
Extensibility Options
Contact Support

Test Orders

Overview

This article explains what test orders are and how to use them.

Test orders allow you to see how the purchase procedure works on your Storefront without charging a credit card. Reports about orders and transactions do not include test orders.

 Tutorial Video

Check out our tutorial video on placing a test order

 Check out our guided walk-through

Would you like to have the system walk you through placing a test order? Click here.

 Note

If you use a coupon code when placing a test order, the test order does not count against any limitation on the number of uses for that code. Any coupon code can be used an unlimited number of times to place test orders, and its availability for live orders will not be affected.

The test version of each Storefront is always available via a specific URL, whether the Storefront is online or offline. You cannot make test orders using the Live URL for your Storefront.

 

To Make a Test Purchase from a Web Storefront

You can make test purchases via the Web Storefront by using the  command found at the top right-hand corner of any page in the Storefront's SETTINGS. Alternatively, you can use a test version of your Storefront with your existing products. Either way, when prompted for payment details, you can enter the test card number and CVV code found via the TEST command of your Storefront.




 

Different card numbers are available so that you can test purchases that will "succeed" (without charging an actual card) and purchases that will "fail." When placing a test order, you can enter any date in the future for the card's expiration date. For the other order details, you can use any values such as your name, so long as you use the test card numbers shown.

  • If you want to test a successful purchase, copy and paste the Card Number and CVV Code shown in the Success row.
  • If you want to test a declined transaction, copy and paste the Card Number and CVV Code shown in the Failure row.

 

Making a Test Purchase Using a Test Version of Your Storefront with Existing Products

There are two ways you can make a test purchase using existing products. The first is via the LINKS command for a specific Storefront.

  1. Click the LINKS menu in the list of Web Storefronts. A popup window appears with various navigational URLs for the Storefront.




     

     About Test URLs

    The Test Storefront URL contains the word test. In the example above, the Live URL is https://yourexamplestore.onfastspring.com, and the Test URL is https://yourexamplestore.test.onfastspring.com. If your Storefront is online, you can add .test to the Live URL to create a test URL. For example, change https://acme.onfastspring.com/ to https://acme.test.onfastspring.com.

     
  2. Click the Open link to the right of the Test URL. Alternatively, you can copy the Test URL shown in the popup window, and then paste it into a new browser tab or window.
  3. When you are ready to enter payment information for your test order, enter the test credit card number and CVV code.

The other alternative is to test a specific product using any Storefront in your Store, via the CHECKOUT LINKS command on the product's detail page.

  1. On a product's detail page, click CHECKOUT LINKS.


     
  2. Select either Web Storefront or Popup Storefront. Regardless of your selection, the payment details to use for test purchases are displayed below. You can click Copy to copy the Storefront's special test mode CVV to your clipboard for use in testing.


     
  3. Optionally, click the drop-down to select a specific live or test Storefront, and then click Open.
 

 

Making a Test Purchase Using the SAVE AND PREVIEW Command

If you are editing the Storefront's SETTINGS, you can make a test purchase via the  command at the top right-hand corner of the page. If you do this, a fictitious example of a subscription-based product is for the test purchase. This method does not use your existing product(s) for the test; this is normal and expected behavior. This method allows you to preview style changes to your Web Storefront regardless of whether or not you have yet configured products in your Store. If you want to test using your existing products, please see the previous section of this article.

 

To Make a Test Purchase from a Popup Storefront

You can make test purchases via the Popup Storefront by using the PREVIEW command on the Popup Storefront's card via Storefronts -> Popup Storefronts -> PREVIEW, or via the Popup Storefront on your website. Either way, when prompted for payment details, you can enter the test card number and CVV code found via the TEST command of your Storefront.

Different card numbers are available so that you can test purchases that will "succeed" (without charging an actual card) and purchases that will "fail." When placing a test order, you can enter any date in the future for the card's expiration date. For the other order details, you can use any values such as your name, so long as you use the test card numbers shown.

  • If you want to test a successful purchase, copy and paste the Card Number and CVV Code shown in the Success row.
  • If you want to test a declined transaction, copy and paste the Card Number and CVV Code shown in the Failure row.

 

Making a Test Purchase via the Popup Storefront on Your Website

If you want to test the Popup Storefront directly on your website using one of your existing products, use the following procedure.

 Caution

Bear in mind that modifying the source of the pages on your website can result in your changes being visible to external visitors. Therefore, you might want to perform any such tests in an offline or internal version of the webpages.
  1. Modify the JavaScript on your page that was provided by FastSpring, which loads the Popup Storefront (and the Store Builder Library). Adjust the Storefront's URL in that code snippet by inserting the word ".test" between the Storefront name and ".onfastspring.com."

    For example, if your Popup Storefront's URL is yourexamplestore.onfastspring.com/popup, you would change the URL to be yourexamplestore.test.onfastspring.com/popup, as in the following example:
     
    Example of Popup Storefront code with a test URL
    <script
        id="fsc-api"
        src="https://d1f8f9xcsvx3ha.cloudfront.net/sbl/0.8.2/fastspring-builder.min.js""
        type="text/javascript"
        data-storefront="yourexamplestore.test.onfastspring.com/popup">;
    </script>
    		
  2. Using your web browser, invoke the Popup Storefront checkout window from the page (e.g., by clicking a button that triggers the checkout). Use the test card number and CVV code, as described above, for your payment details.
  3. If you have modified a live web page to place a test order (not recommended), be sure to change the Popup Storefront's URL back by removing the .test when you are finished. 

 

Making a Test Purchase Using the PREVIEW Command

Clicking the PREVIEW command uses a fictitious example of a subscription-based product for the test purchase. This method does not use your existing product(s) for the test; this is normal and expected behavior. This method allows you to preview style changes to your Popup Storefront regardless of whether or not you have yet configured products in your Store. If you want to test using your existing products, see the previous section of this article.

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.