---
title: "Why a contract is on hold"
description: "Find out why a plan you sold is not active, billed or confirmed to the customer yet, what you can do about it, and who clears it."
---

A hold is the reason a plan (contract) cannot move forward yet. Use this page to find the hold, see what you can do about it, and know who clears it: the customer, you, or SureBright. Many holds clear by themselves once an expected event arrives, such as a shipment or a captured payment.

## What a hold stops

A hold stops one or more of three things:

- **Billing.** SureBright does not charge you for the plan until billing holds clear.
- **Activation.** The plan stays not active until SureBright has finished setting it up.
- **The customer's confirmation email.** The email waits while a detail that is printed on the plan is missing: customer and product details, the product category, or the coverage dates. Details the customer never sees, such as costs, margins and SKUs, never delay the email.

## Where you see a hold

| Where | What you see |
|---|---|
| **Order Resolution** in the Merchant Portal | Anything that needs a decision from you: naming or associating a product, refunding a plan, or confirming which product a plan covers. See [Order Resolution](/merchant-portal/order-resolution). |
| **Fulfillment** tab, on stores whose coverage starts at shipment | Plans waiting for a shipment count under **Pending fulfillment**. |
| **Sales → Warranties pending**, on Lightspeed R Series stores | Plans that are not active yet, grouped as **No warranty created** or **Not activated**, each with what stopped it. |
| The customer portal | Your customer sees the hold on their plan's card, for example **Address needed to activate warranty**, **Awaiting fulfillment** or **Setting up your protection**. See [Customer portal](/customer-portal/overview). |

<Tip>
On Shopify, changes you make on the order itself, such as adding an email or address or capturing payment, reach the plan automatically. On WooCommerce, customer details you change on the order reach the plan too. On other platforms, ask your SureBright contact.
</Tip>

## Holds and what to do about them

| What is holding the plan | What it means | What you do | Who clears it |
|---|---|---|---|
| Customer details missing | The customer's name, email, street address, city, state or ZIP is missing. A complete address is needed to issue the plan. | On Shopify and WooCommerce, add the details to the order; the plan picks them up. On any platform, the customer can add a missing address in the customer portal, and where the order shows in Order Resolution you can enter the detail in the case. For Shopify orders SureBright may also email the customer to ask. | The customer |
| Order reference missing | The plan has no order reference. | Nothing. SureBright repairs it. | SureBright |
| Product has no category | The product has no SureBright category, so the plan cannot be set up. | Nothing, unless SureBright asks you about the product. | SureBright |
| Product has no coverage code | The product has no coverage code yet. | Nothing. | SureBright |
| Product details missing | Model name, model number, manufacturer, condition, product ID or purchase price is missing, or the covered quantity could not be read. | Name the product in Order Resolution when the case asks **Which product did the customer buy?**, or complete the product in your catalogue. | You. A quantity that could not be read clears by itself. |
| Store set-up incomplete | Your store's programme set-up with SureBright is not finished. | Ask your SureBright contact to complete your store set-up. | You, by asking SureBright |
| Country not covered | The customer's country is not one where plans are sold (United States and Canada only), or it does not match the country the plan was priced for. Billing is held too. | This cannot be fixed. The plan is refunded through Order Resolution. | Nobody; the plan is refunded |
| Sold below cost | The plan was sold for less than its cost. Billing is held. | Nothing. SureBright reviews the pricing. | SureBright |
| Pricing detail missing | A pricing detail is missing, such as your margin, the plan's cost or price, or its price band. Billing is held. | Nothing. | SureBright |
| Plan term missing | The plan's term in months is missing. | Nothing. | SureBright |
| Plan not matched to its quote | The plan could not be tied back to the quote it was sold under. | Usually nothing; it clears when the quote is recovered. If the plan was sold outside the SureBright widget, answer the matching case in Order Resolution. | Clears by itself |
| Waiting for shipment | Your store's coverage starts when the product ships, so activation and the confirmation email wait for the shipment. Billing is not held. | Ship the product. | Clears by itself when the order ships |
| Waiting for payment | The order's payment has not been captured, so billing waits. | Capture the payment in your store admin. | Clears by itself when payment is captured |
| Coverage dates missing | The start or end date is missing on a plan that should have them. The plan cannot become active until they are set. | Nothing. SureBright repairs the dates. | SureBright |
| Currency mismatch | The plan was quoted in one country's currency but paid in another, for example a US quote paid in CAD through Shopify Markets. Billing is held until SureBright reconciles the amounts. | Nothing. | SureBright |

## Cases you see in Order Resolution

Some problems are not a missing detail on an existing plan but a question nobody can answer automatically. These become **cases** in [Order Resolution](/merchant-portal/order-resolution). The first party to answer a case resolves it for everyone.

Where the kind of case allows it, a case that nobody answers is resolved automatically after 48 hours. **I'll handle it** takes the order off that clock, and **or give me until** pushes the deadline out.

| What the case says | What it means | What you can do |
|---|---|---|
| *We couldn't work out which product on this order this plan was sold against.* | No contract exists until the case is resolved. The reason is shown when known: the covered product was refunded or removed, more plan units were bought than products, the plan was priced for another country or province, the covered order was cancelled, or the plan details could not be found. | **Associate product** when the plan has nothing to attach to, refund the plan, or acknowledge the case without a change. When a correct product already exists (excess units, a region mismatch), only refund or acknowledge is offered. |
| *More than one product on this order could be the one this plan covers.* | Several products fit the plan, so SureBright does not guess. | Pick the product the customer meant. The contract is created against it. |
| *We couldn't work out what this shipping protection was covering.* | Shipping protection could not be matched to a shipment. | Refund it or acknowledge the case. |
| **Missing required details** | The order is missing a detail the plan needs, for example the customer's email. | Enter the missing detail in the case. |
| **Tracking details missing** or **Shipping carrier not recognized** | A shipping-protection shipment has no tracking number, or its carrier was not recognised. | Provide the tracking number or pick the carrier. |

The quick filters in Order Resolution group cases as **Product refunded**, **Quantity mismatch**, **Region not covered**, **Product not identified**, **Missing details** and **Shipping**.

## Problems SureBright fixes for you

These go to SureBright's team, not to you, but you may notice their effect on a plan.

| Situation | What you may notice |
|---|---|
| No contract was created for a paid plan | SureBright repairs it. On Lightspeed R Series stores the sale shows under **No warranty created** with the reason **Warranty creation failed**. |
| A plan was sold below its cost | Billing waits for SureBright's review. |
| A plan was paid in a different currency from its quote | Billing is held until SureBright reconciles the amounts to the order currency. |
| The plan documents are missing | The customer's confirmation email is still sent, without the plan documents attached. SureBright sends them to the customer separately. The plan itself is not held. |
| The customer has no email address | The confirmation email cannot be sent, and the portal shows **No customer email**. The plan goes ahead if everything else is present. On Shopify, adding the email to the order sends the waiting email. On other platforms, ask your SureBright contact. |
| A shipment is cancelled on a store whose coverage starts at shipment | The coverage dates are cleared and the plan goes back to waiting for shipment. The plan is **not** cancelled; shipping again dates it again. |

## How a hold clears

Holds are checked again every time the plan's details change: the customer's details are updated on the order, a case is answered in Order Resolution, the order ships, or SureBright makes a repair. When the last missing detail is in place the plan becomes ready to bill, and it goes active once SureBright has finished setting it up and its start date is reached. See [Contract statuses](/contracts/lifecycle).

A plan that is cancelled, expired or fully settled keeps its hold history for the record but no longer needs a fix.

## Related

<CardGroup cols={2}>
  <Card title="Order Resolution" href="/merchant-portal/order-resolution">
    Answer the cases that are waiting on you.
  </Card>
  <Card title="Contract statuses" href="/contracts/lifecycle">
    Whether a plan is active and whether it has been billed.
  </Card>
</CardGroup>

<Accordion title="For developers">
API responses that return a contract's holds list them in `holdReasonList`, for example the [fulfillment endpoint](/api-reference/endpoint/order/fulfillment).

| Value in `holdReasonList` | On this page |
|---|---|
| `ADDRESS_MISSING` | Customer details missing |
| `INVOICE_MISSING` | Order reference missing |
| `CATEGORY_MISSING` | Product has no category |
| `PRODUCT_UNTAGGED` | Product has no coverage code |
| `PRODUCT_DETAILS_MISSING` | Product details missing |
| `STORE_MAPPING_MISSING` | Store set-up incomplete, or Country not covered |
| `NEGATIVE_MARGIN` | Sold below cost |
| `PRICE_MISMATCH` | Pricing detail missing |
| `TENURE_UNKNOWN` | Plan term missing |
| `QUOTE_MISSING` | Plan not matched to its quote |
| `AWAITING_FULFILLMENT` | Waiting for shipment |
| `AWAITING_PAYMENT` | Waiting for payment |
| `COVERAGE_DATES_MISSING` | Coverage dates missing |
| `CURRENCY_MISMATCH` | Currency mismatch |

`PAYMENT_METHOD_MISSING`, `AMBIGUOUS_ASSOCIATION` and `CONTRACT_CREATION_FAILED` are also defined, but are not placed on contracts today. The matching problems are raised as cases instead.
</Accordion>
