Test your setup

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 needWhere to get it
SureBright installed and switched on in the storefront you test inYour platform's guide, from Supported platforms. 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.
A product that offers protectionProducts, 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 readThe customer emails go to the address on the order.

Run the test on Shopify#

  1. 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.

  2. 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.

  3. 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.

  4. Confirm the contract

    In the Merchant Portal open 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.

  5. 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 with the same email address and see the plan. All the emails are listed in Emails your customers receive.

  6. 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 instead.

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.

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. Platform pages that describe their own checks:

PlatformWhere the checks are
MagentoWhen offers do not show and Test webhook under Webhook Connectivity
Salesforce Commerce CloudTesting, in your sandbox before production
BigCommerceWhere contracts appear
WooCommerceOrder webhooks: check that all four read Active in WooCommerce
Headless Shopify storefrontsVerify
Bundles on ShopifyBundles

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.

For developers: how to mark your own orders as tests is in Create contracts for an order, and keys and hosts are in 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 toDo this
See and approve the design before anyone else doesIn Studio, 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-liveCheck 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 itemIn 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 pagesAsk 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 itTurn the embed on in an unpublished copy of your theme and preview there. See Before you start.

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

Launch checklist#

CheckWhere
Your store card reads LiveMerchant Portal overview
A payment method is savedBilling
The products you want covered show Active and have a categoryProducts
Plan prices are the ones you expectWarranty Pricing, where enabled
Your widget design is publishedStudio, where enabled
The test order produced a contract and an email, and cancelling it cancelled the contractThis page
On Shopify, the embed reads Turned on next to your Live theme, not only next to an unpublished oneSettings → Storefront setup
On Shopify, discounts leave SureBright products out and the Cart Validator is activeShopify admin housekeeping
On Shopify Plus, the checkout blocks are placed and show in the checkout previewCheckout extensions

See also: Try it on one product or page first.