---
title: "Test your setup"
description: "Confirm the offer, the order, the contract, the customer email and the cancellation all work before you launch SureBright on your store."
---

Before you launch, run one order through SureBright from the product page to the cancellation. The flow is the same on every platform: see the offer, buy a plan, find the contract, then cancel. This page says what you need first, gives the steps for Shopify in full, points to the checks for other platforms, and ends with a launch checklist.

## Before you start

| You need | Where to get it |
|---|---|
| SureBright installed and switched on in the storefront you test in | Your platform's guide, from [Supported platforms](/platforms/overview). On Shopify this is the SureBright Offering app embed, turned on in the theme you test in under **Settings → Storefront setup** in the Merchant Portal. An unpublished theme is enough for a preview: the embed then only affects previews of that theme. See [Storefront setup](/shopify/storefront-setup). |
| A product that offers protection | [Products](/merchant-portal/products), under the **Warranty Active** chip. The offer only renders on products in an eligible category, so a product picked at random can look as if nothing works. |
| An email address you can read | The customer emails go to the address on the order. |

## Run the test on Shopify

<Steps>
  <Step title="See the offer">
    Open the product on your storefront, or in the theme editor preview. The protection offer shows near **Add to cart**. If it does not, work through [No offer on product pages](/shopify/storefront-setup#troubleshooting).
  </Step>
  <Step title="Add a plan">
    Pick a plan and add the product to the cart. The cart holds two lines: the product and the plan. Change the product quantity and check that the plan line follows it.
  </Step>
  <Step title="Place a test order">
    Check out with one of Shopify's test payment methods and your own email address. Shopify marks such an order as a test order, and SureBright treats it as one. The contract is created once the order is paid.
  </Step>
  <Step title="Confirm the contract">
    In the Merchant Portal open [Sales](/merchant-portal/sales) and look under **Recent Sales**. There is one row per plan unit, with the order number and a **Warranty status**. If the plan is missing, look in **Order Resolution** and read [Why a contract is on hold](/contracts/holds).
  </Step>
  <Step title="Check the customer email">
    The plan confirmation arrives with the subject `SureBright warranty policy details of your recent purchase`. On stores whose coverage starts at shipment you get **Order received** first, and the confirmation follows when you fulfil the order. You can also sign in to the [customer portal](/customer-portal/overview) with the same email address and see the plan. All the emails are listed in [Emails your customers receive](/customer-emails/overview).
  </Step>
  <Step title="Cancel or refund the order">
    Cancel the order in Shopify admin, or refund the plan line. The contract's **Warranty status** changes to **Cancelled** and the cancellation confirmation email arrives. If you refund only the product and keep the plan, nothing is cancelled: a case appears in [Order Resolution](/merchant-portal/order-resolution) instead.
  </Step>
</Steps>

<Tip>
  On Shopify, if the SureBright Cart Validator is active, also test it: put a plan in a cart without its product and go to checkout. The purchase should be blocked. See [Enable the SureBright Cart Validator](/shopify/enable-surebright-cart-validator).
</Tip>

## Test orders and billing

- An order paid with a real payment method is a real sale, whatever your intent. Cancel or refund it: a plan cancelled before it is charged is not billed.
- A whole store can be treated as a test store, so that nothing sold on it is billed. SureBright sets that for you: ask your SureBright contact if you are testing on a development store or a copy of your shop.
- On Shopify, you are not billed for a plan on an order that Shopify marked as a test. Its **Warranty status** can still read **Active**, so do not take that as a sign that it will be charged.
- On other platforms, ask your SureBright contact how test orders are treated before you place one.

## Test on other platforms

The flow is the same everywhere: see the offer, buy a plan, find the contract under **Recent Sales**, then cancel. Whether a cancellation or refund in your store admin cancels the contract for you is shown per platform in [What works on each platform](/platforms/overview#what-works-on-each-platform). Platform pages that describe their own checks:

| Platform | Where the checks are |
|---|---|
| Magento | [When offers do not show](/magento/storefront-widget#when-offers-do-not-show) and **Test webhook** under [Webhook Connectivity](/magento/admin-panel#test-that-your-server-can-reach-surebright) |
| Salesforce Commerce Cloud | [Testing](/salesforce-commerce-cloud/testing), in your sandbox before production |
| BigCommerce | [Where contracts appear](/bigcommerce/overview#find-your-contracts-in-the-merchant-portal) |
| WooCommerce | [Order webhooks](/woocommerce/overview#set-up-the-four-order-webhooks): check that all four read **Active** in WooCommerce |
| Headless Shopify storefronts | [Verify](/frontend-widget-integration/frontend-widget-kit/headless-and-custom-storefronts#verify) |
| Bundles on Shopify | [Bundles](/shopify/bundles) |

## Test an API integration

If your developers record orders through the SureBright API, they can try it first from the **Developers** page in the Merchant Portal. Its playground sends a sample order that is marked as a test, and playground orders carry a **Test** tag in **Recent Sales**. See [Developers](/merchant-portal/developers#try-the-api-from-the-portal).

For developers: how to mark your own orders as tests is in [Create contracts for an order](/api-reference/endpoint/order/create-contract), and keys and hosts are in [Authentication](/api-reference/authentication).

## Start with a few products

You do not have to launch on your whole catalogue at once. Ways to try SureBright on a small scale first:

| You want to | Do this |
|---|---|
| See and approve the design before anyone else does | In [Studio](/merchant-portal/studio#try-a-design-on-your-real-store-first), preview a draft on your own storefront before you publish. Without Studio, ask your SureBright contact to share the design, and other layouts to compare, for your approval. |
| See plan prices before go-live | Check [Warranty Pricing](/merchant-portal/warranty-pricing) where it is enabled, or ask your SureBright contact for the plan prices for your products. |
| Offer protection on one product, such as a slow-moving item | In [Products](/merchant-portal/products), set **Warranty status** to **Active** on that product only and **Inactive** on the rest. Widen it later from the same page. |
| Keep the offer away from your main pages | Ask your SureBright contact to run the offer only on a landing page or product page that you share by direct link. |
| Try it on Shopify without shoppers seeing it | Turn the embed on in an unpublished copy of your theme and preview there. See [Before you start](#before-you-start). |

When the pilot looks right, go through the launch checklist below.

## Launch checklist

| Check | Where |
|---|---|
| Your store card reads **Live** | [Merchant Portal overview](/merchant-portal/overview#check-your-stores-status) |
| A payment method is saved | [Billing](/merchant-portal/billing) |
| The products you want covered show **Active** and have a category | [Products](/merchant-portal/products) |
| Plan prices are the ones you expect | [Warranty Pricing](/merchant-portal/warranty-pricing), where enabled |
| Your widget design is published | [Studio](/merchant-portal/studio), where enabled |
| The test order produced a contract and an email, and cancelling it cancelled the contract | This page |
| On Shopify, the embed reads **Turned on** next to your **Live theme**, not only next to an unpublished one | [Settings → Storefront setup](/merchant-portal/settings#check-your-shopify-storefront-setup) |
| On Shopify, discounts leave SureBright products out and the Cart Validator is active | [Shopify admin housekeeping](/shopify/admin-housekeeping) |
| On Shopify Plus, the checkout blocks are placed and show in the checkout preview | [Checkout extensions](/shopify/checkout-extensions) |

## Related

- [Supported platforms](/platforms/overview)
- [Storefront setup](/shopify/storefront-setup), for Shopify
- [Contract statuses](/contracts/lifecycle)
- [Emails your customers receive](/customer-emails/overview)
- [Pause or remove SureBright](/platforms/pause-or-remove)

**See also:** [Try it on one product or page first](/merchant-portal/widget-options#try-it-on-one-product-or-page-first).
