---
title: "Confirming which product a plan covers"
description: "What to tell a shopper who receives a SureBright email asking which product their protection plan covers, what the confirmation page shows, and what happens after they confirm."
---

Sometimes an order carries protection plans but nothing says which product each plan was bought for. SureBright then emails the shopper a link to a short confirmation page. The shopper picks the product for each plan and the plan is activated.

You do not need to do anything. Use this page when a shopper asks what the email is, or says the link does not work.

## What the shopper sees on the confirmation page

The page is titled **Confirm your protection plan** and shows your store name and, when there is a deadline, **Please confirm by** followed by the date. Below it is one card per plan on the order, headed **Protection plan** with the plan's reference. Each card asks **Which product does this plan cover?** and lists the products on the order with their price and quantity.

- When SureBright can tell which product a plan most likely belongs to, that product is pre-selected and marked **recommended**, and the card carries a **suggested match** chip.
- A product already chosen for another plan is greyed out as **already paired with another plan**. One plan covers one product.
- **I'm not sure, I'll link this later** leaves a plan unlinked without blocking the others.

**Confirm & activate** submits the choices. The page then reads **Your protection plan is confirmed**, says how many plans were activated and how many are left to link later, and tells the shopper a confirmation email is on its way.

## If the link does not work

| The shopper sees | Why | What to tell them |
|---|---|---|
| **Activation link required** | The page was opened without the link from the email. | Open the page from the link in the email. A shopper is never asked to type a code or reference. |
| **We couldn't open this activation** | The link is invalid, has expired, or the order has already been confirmed. | Open the most recent email, or reply to it to have the link re-sent. |

Once the shopper has confirmed, the link no longer opens, even if they left some plans to link later. A shopper who wants to pair the remaining plans should contact SureBright support.

## Related

<CardGroup cols={2}>
  <Card title="Helping a customer" href="/help/helping-a-customer">
    Answers to the questions shoppers ask you most.
  </Card>
  <Card title="Order Resolution" href="/merchant-portal/order-resolution">
    Where you pick the product for a plan yourself.
  </Card>
</CardGroup>

<Accordion title="For developers">
Two endpoints sit behind the page. Use them only if you are building your own confirmation page for shoppers; otherwise the SureBright page handles everything. Every request carries the `order_key` and `customer_key` from the emailed link, which are specific to one order and one customer.

Replace `{HOST_NAME}` with the API host SureBright gives you.

**Read the order**

```
GET https://{HOST_NAME}/site-platform/api/warranty-link/order?order_key=...&customer_key=...
```

<ParamField query="order_key" type="string" required>
  The order identifier from the emailed link.
</ParamField>
<ParamField query="customer_key" type="string" required>
  The customer identifier from the emailed link.
</ParamField>

<ResponseField name="merchantName" type="string">Your store name, shown as the page heading.</ResponseField>
<ResponseField name="sbOrderId" type="string">SureBright's order identifier.</ResponseField>
<ResponseField name="orderStatus" type="string">One of the statuses below.</ResponseField>
<ResponseField name="expiresAt" type="string">When the link stops working, if a deadline is set.</ResponseField>
<ResponseField name="products" type="array">The products on the order: `lineKey`, `title`, `imageUrl`, `price`, `quantity`.</ResponseField>
<ResponseField name="warranties" type="array">The plans on the order: `lineKey`, `policySKU`, `title`, `price`, and `linkedProductOrderLineKey` when already linked.</ResponseField>
<ResponseField name="suggestedLinks" type="array">SureBright's suggested pairing: `warrantyLineKey`, `productLineKey`, `confidence` (`high`, `medium` or `low`) and `reasons`.</ResponseField>
<ResponseField name="unsuggestedWarrantyKeys" type="array">Plans SureBright could not suggest a product for.</ResponseField>

**Submit the pairing**

```bash
curl -X POST "https://{HOST_NAME}/site-platform/api/warranty-link/submit" \
  -H "Content-Type: application/json" \
  -d '{
    "order_key": "ORDER_KEY",
    "customer_key": "CUSTOMER_KEY",
    "links": [
      { "warrantyLineKey": "w-1", "productLineKey": "p-2" }
    ]
  }'
```

<ParamField body="order_key" type="string" required>From the emailed link.</ParamField>
<ParamField body="customer_key" type="string" required>From the emailed link.</ParamField>
<ParamField body="links" type="array" required>
  One entry per plan the shopper paired, each with `warrantyLineKey` and `productLineKey`. At least one entry. Every key must belong to this order, a plan may appear once, and a product may appear once.
</ParamField>

<ResponseField name="orderStatus" type="string">`LINKED` when every plan was paired, `PARTIALLY_LINKED` when some were left for later.</ResponseField>
<ResponseField name="linkedCount" type="number">Plans paired in this submission.</ResponseField>
<ResponseField name="unlinkedWarrantyCount" type="number">Plans still waiting for a product.</ResponseField>

**Order statuses**

| `orderStatus` | Meaning |
|---|---|
| `AWAITING_CUSTOMER_LINK` | SureBright has the order and is about to email the shopper. |
| `LINK_EMAILED` | The email was sent; the page can be opened and submitted. |
| `PARTIALLY_LINKED` | The shopper paired some plans and left others for later. The link no longer opens. |
| `LINKED` | Every plan is paired. The link no longer opens. |

**Errors**

Both endpoints answer with the HTTP status and a JSON body carrying `isError: true` and a `message`.

| Status | When |
|---|---|
| `400` | A key is missing, or `links` is empty or names a key that is not on the order, or pairs a plan or product twice. |
| `403` | `customer_key` does not match the order. |
| `404` | No order for `order_key`. |
| `409` | The order is already `LINKED` or `PARTIALLY_LINKED`; the body includes `orderStatus`. |
| `410` | The link has expired. |
</Accordion>
