WooCommerce
Install the Surebright Product Protection Plan plugin for WordPress, see what shoppers get, set up the four order webhooks, and know what happens when you refund or delete an order.
SureBright for WooCommerce is a WordPress plugin, Surebright Product Protection Plan, plus four order webhooks that you create in WooCommerce. The plugin shows the offer on your product and cart pages and adds the chosen plan to the cart. The webhooks are what turn the plans you sell into contracts. Use this page when you install the plugin or set up the webhooks with your SureBright contact.
Availability. The WooCommerce plugin is in limited release. It is installed with help from your SureBright contact rather than from the WordPress plugin directory. Talk to us before planning a launch on WooCommerce.
What you get on WooCommerce#
A protection offer on product pages and on the cart page.
The chosen plan added to the WooCommerce cart and bought through checkout with the rest of the order.
A Merchant Portal page in your WordPress admin that signs you in to SureBright without separate credentials.
A contract for each plan sold, kept in step when you refund, delete or restore the order.
What you need to do#
Requirements#
Install the plugin#
Install and activate
Install the Surebright Product Protection Plan plugin in WordPress and activate it. Activation registers your store with SureBright.
Open the merchant portal
The plugin adds a Merchant Portal page to the WordPress admin menu with a Login button. It opens the SureBright merchant portal signed in as your store, so you do not need separate credentials. Complete the onboarding journey there.
Review product categories
Offers are based on the SureBright category on each product. Check Products and set the category on anything that is missing one.
Set up the order webhooks
Create the four webhooks described under Set up the four order webhooks. Until they exist, plans sold on your store do not become contracts.
During onboarding SureBright creates the plan products in your WooCommerce catalogue, one per category you sell, so that a plan can be added to the cart and paid for like any other item. Leave these products as they are.
What shoppers see on product and cart pages#
Product pages. Above the Add to cart button the shopper sees an Add 2-Year Warranty block with one tile per available term showing the added years and the price, with Powered By SureBright underneath. The information icon opens a popup headed Don't want to spend extra on this product for the next few years?, with the list of what the plan covers under Your Warranty Plan Provides, an Add Warranty button, No Thanks, and a link to the plan's terms.
Cart page. Each cart item that qualifies gets an Add Warranty for $price link next to its name. Clicking it opens the Add Extended Warranty popup with the available plans and Add Protection / No Thanks buttons.
Choosing a plan adds it to the WooCommerce cart without reloading the page. The plan then goes through checkout with the rest of the order.
Set up the four order webhooks#
Create the webhooks in WooCommerce > Settings > Advanced > Webhooks, one per topic. For each one:
Choose the topic from the table.
Enter the delivery URL: the host your SureBright contact gives you, followed by the path from the table.
Enter the Secret your SureBright contact provides, exactly as given. With any other secret, plans do not become contracts.
Set it to Active and to the WP REST API v3 payload.
WooCommerce disables a webhook after repeated delivery failures. If plans stop turning into contracts, open WooCommerce > Settings > Advanced > Webhooks and check that all four are still Active.
Two things to know once the webhooks are running:
Keep your site URL the same. SureBright recognises your store by the URL of your WordPress site, which must match the store SureBright registered. If you move domains, tell your SureBright contact before the webhooks start failing.
A successful delivery is not always a contract. If an order is missing something SureBright needs (for example a line price that is not a number), WooCommerce still shows the delivery as successful. SureBright reviews the gap itself.
Questions about the webhooks#
Refund, delete or restore an order#
Find your contracts in the merchant portal#
Contracts show under Recent Sales on the portal's Sales page. A contract can appear a short while after the order. Plans SureBright could not pair with a product appear in Order Resolution.