BigCommerce

Connect your BigCommerce store with the SureBright app, see what shoppers get on your storefront, check that it works, and know what happens to plans when an order changes or you uninstall.

SureBright for BigCommerce is a single-click app. Install it and your store is connected: offers appear on your storefront, and the plans shoppers buy become contracts with no further setup. This page follows the order you will work in: connect, see what appears on your storefront, check it works, manage orders and refunds, and uninstall.

What you get on BigCommerce#

  • Protection offers on product pages, on the cart page and in quick view on category pages.

  • A shipping protection checkbox in the cart, when shipping protection is enabled for your store.

  • A contract for every plan a shopper buys, kept in step when you cancel or refund the order.

  • Sign-in to the merchant portal by opening the app from your BigCommerce control panel.

  • Your products and categories copied to SureBright and kept current as you add or change them.

What you need to do#

WhenWhat you do
OnceInstall the app and approve the access it asks for.
OnceGo through the onboarding journey in the merchant portal and review any product that needs a category.
AlwaysLeave the two SureBright scripts and the SureBright products in your catalogue as they are.
If you wantSwitch shipping protection off for individual products.

Connect your store#

  1. Install from BigCommerce

    Install SureBright from your BigCommerce control panel and approve the access it asks for. SureBright creates your SureBright store from your BigCommerce store details (domain, country and admin email).

  2. Wait while SureBright sets up the store

    SureBright adds two scripts to your storefront, copies your catalogue (products and categories) and gives your store a default widget configuration. You do nothing in this step.

  3. You land in the merchant portal

    When setup finishes you are signed in to the merchant portal as the store owner. The first visit opens the onboarding journey. Opening the app from the BigCommerce control panel later signs you in again.

  4. Review your products

    Offers appear once SureBright has reviewed the store and your products carry a category. Check Products for anything marked as needing a category.

Your Email and Phone in portal Settings are read-only on BigCommerce stores and come from BigCommerce.

What shoppers see on your storefront#

You do not place anything by hand. Once the app is installed, shoppers see:

WhereWhat the shopper sees
Product pagesThe protection offer with the available plan terms, a Protect My Purchase button in the detail popup, and a link to the plan's terms. When the shopper changes the product option, the offer updates for the selected variant.
Cart pageAn Add Warranty button next to each cart item that qualifies, plus the shipping protection checkbox when shipping protection is enabled for your store.
Quick view on category pagesThe product offer for the product they opened.

When a shopper changes the quantity of a covered product or removes it, the matching plan line is adjusted or removed, so the cart never carries a plan without its product.

Scripts and products to leave in place#

The app adds two entries under Storefront > Script Manager. Both load in the page head on every storefront page, are marked Essential for consent purposes, and are not shown in checkout.

ScriptWhat it is for
SureBright SDK configurationTells SureBright which store and country the page belongs to.
SureBright SDKShows the offers on your storefront.

Do not delete or edit these scripts. Offers stop appearing if either one is missing. If one goes missing, ask your SureBright contact to recreate it.

The app also adds digital products to your catalogue, because a plan is sold as a product:

  • Plans are named Product Warranty Powered by SureBright - <category>, with one variant per price band and term and a Quote Details modifier.

  • Shipping protection is a digital product named Shipping Protection Powered by SureBright.

Leave these products as they are, including their names. Offers and contracts depend on them.

Check that it works#

  1. Look for the two scripts

    Open Storefront > Script Manager and confirm SureBright SDK configuration and SureBright SDK are both listed.

  2. Open a product page

    Once SureBright has reviewed your store, pick a product that carries a category on Products. You should see the protection offer. Change the product option and check that the offer updates.

  3. Open the cart

    Add the product to the cart. You should see the Add Warranty button next to it.

  4. Buy a plan and find the contract

    Place an order that includes a plan, then look under Recent Sales on the Sales page. A contract can appear a short while after the order.

Test your setup describes the full test, from the offer to the cancellation.

Choose which products get shipping protection#

On stores that sell shipping protection, the cart checkbox offers shipping protection for the cart's eligible products. You decide which products count on the merchant portal's Products page:

  • The Shipping protection column is On by default for eligible products.

  • Set it to Off for any product you want to leave out.

  • Products whose category is not a shipping category show Not eligible.

A change applies the next time a shopper's cart is priced.

What happens when an order changes#

You manage orders in BigCommerce as usual. SureBright follows what you do there:

When this happens in BigCommerceWhat happens to the plan
A shopper places an order with a planA contract is created for each plan unit, for the product it covers.
You cancel the order, or remove a plan line from itThe contracts for those plans are cancelled.
You refund plan unitsThe contracts for the refunded units are cancelled.
You ship the orderOn stores where coverage starts at fulfilment, coverage is dated from the shipment. Shipping protection contracts are created for the shipment.
You add or change a product or categorySureBright's copy updates, including the product's categories and images, so the product can be offered a plan.

The app sets all of this up when you install it. Do not create BigCommerce webhooks for SureBright by hand: only the ones the app registers work.

The customer on a contract comes from the order's first shipping address (name, email, phone, address). Orders with no shipping address fall back to the billing address. A missing email or address holds the contract; see Why a contract is on hold.

Find your contracts in the merchant portal#

Every contract shows under Recent Sales on the portal's Sales page. Plans that could not be matched to a product, or sales whose details are incomplete, show in Order Resolution. The cases and what you can do about them are listed in Why a contract is on hold.

Uninstall the app#

Uninstall the app from the BigCommerce control panel to disconnect your store. Existing contracts stay in force and remain visible to their holders. No new contracts are created after that. Reinstalling the app reconnects the same SureBright store.