> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fanfare.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkout protection

> How Fanfare protects drop products in Shopify checkout, how long protection lasts, auction requirements, and how to fix sync issues.

Checkout protection is a server-side Shopify checkout rule that runs on every checkout. It blocks any protected product unless the shopper earned access through your experience—preventing bots and shoppers from bypassing your queue or draw with direct cart or checkout links.

Use this page to verify protection before launch, understand the messages shoppers see if a checkout is blocked, review Shopify auction requirements, and repair products whose protection failed to sync. For initial setup, see [Storefront setup](https://docs.fanfare.io/guide/shopify/storefront-setup.md).

> [!NOTE]
>
> Checkout protection applies only to the Fanfare app in Shopify.

## Before you start

* The Fanfare app is installed on your store.
* **Checkout protection** shows **On** under **Settings → Storefront setup**. If it displays **Turned off**, **Not turned on**, or **Couldn't check**, complete [Storefront setup](https://docs.fanfare.io/guide/shopify/storefront-setup.md) first.

If you see **Turned off**, the rule is disabled in Shopify or has **Allow all customers to complete checkout** checked. Because Fanfare never modifies a rule you've edited, re-enable it in Shopify's checkout settings—see [Storefront setup](https://docs.fanfare.io/guide/shopify/storefront-setup.md).

## When protection starts and ends

A product becomes protected the moment you add it to an experience—regardless of status, including **Draft** experiences—and stays protected for as long as *any* experience includes it. If a product belongs to multiple experiences, it remains protected until none of them include it.

While a product is protected:

* Shopify blocks all ordinary checkouts; only shoppers granted access through your experience can check out.
* On product pages with the widget installed, the widget replaces your standard buy buttons before, during, and after the drop.

> [!WARNING]
>
> Checkout protection stays active after a drop ends—and **Deactivate** does not lift it. Shoppers can't buy the product normally until no experience includes it: remove the product from the experience or delete the experience (and repeat for any other experience containing it). For a **Live** or **Scheduled** experience, deactivate it first, then delete it once its wind-down wait ends (see [Stop a drop](https://docs.fanfare.io/guide/drop/deactivate.md#when-delete-is-available)). During wind-down, **Delete** is refused even though the button looks available, and you can't remove a product while the experience still holds allocated units.

Buy buttons elsewhere in your theme—such as quick-add buttons on collection pages—bypass the widget, but checkout protection still blocks those carts at checkout. See [Storefront setup](https://docs.fanfare.io/guide/shopify/storefront-setup.md).

## Check that a drop is protected

**1. Confirm the rule is On**

Open **Settings → Storefront setup** and verify the **Checkout protection** card shows **On**. This confirms the rule is active store-wide (it doesn't list individual protected products).

**2. Verify no gating sync warning appeared**

Make sure you didn't see a `"Shopify gating could not be updated"` warning the last time you saved the experience. If you did, see [When protection did not update](#when-protection-did-not-update).

**3. Test with a direct cart link (optional)**

Add the product to your cart outside the widget (for example, via a direct cart link) and attempt to check out. A protected product should be blocked with `"Please claim access to this product before adding it to your cart"`.

> [!NOTE]
>
> The **Fanfare experiences** block on a Shopify product page only shows Fanfare's record of attached experiences—it isn't proof that checkout protection synced cleanly.

## Messages customers see at checkout

Checkout protection only lets a protected product through when the cart matches the shopper's granted access. If Shopify blocks a checkout, the shopper sees one of these English-only messages (regardless of your store's language):

| Message | Why it appeared | What to tell the shopper |
| - | - | - |
| `"Please claim access to this product before adding it to your cart"` | The shopper added a protected product without earning access (e.g., via a direct cart link or quick-add button), or their payment window expired. | Go to the product page and enter the drop through the widget. |
| `"Your access to this product has expired — please return to the product page to renew it"` | The shopper's access expired before checkout completed. | Return to the product page and re-enter through the widget. |
| `"This product is reserved for a different account. Please sign in with the account that claimed it"` | The shopper is signed in to a different customer account than the one granted access. | Sign in with the account used to enter the drop. |
| `"These products can't be purchased together — please check out separately"` | The cart contains protected products from more than one experience. | Check out each product separately. |
| `"You can buy at most [number] of [product] in this checkout."` | The cart exceeds the experience's per-checkout quantity limit. | Lower the quantity to the allowed maximum. |
| `"You have reached the purchase limit for [product]."` | The shopper has already hit their total purchase limit. | No additional units can be purchased with this access. |
| `"Unable to add [product] to the cart as its not currently available for purchase."` | The cart includes a protected product or variant not covered by the shopper's access. | Remove the extra item and check out only what the widget added. |
| `"Unable to add to cart as the product is not currently available for purchase"` | Checkout couldn't verify the shopper's access. | Return to the product page and check out from the widget again for fresh access. Contact Fanfare support if it persists. |
| `"Your reserved item must be checked out once, at quantity 1, at its reserved price and with no discount. Please return to the product page to complete your purchase"` | An auction winner's cart doesn't match the winning bid rules. See [Auctions on Shopify](#auctions-on-shopify). | Return to the product page and check out once at quantity 1 with no discounts applied. |
| `"Your reserved item can only be bought in [currency]. Please check out in [currency] to complete your purchase"` | An auction winner is checking out in a different currency than the winning bid. | Switch to the named currency to complete checkout. |
| `"Internal cart validation error"` or a message starting `"Invalid date format"` | An unexpected error occurred on Fanfare's side. | Contact Fanfare support. |

For what shoppers experience at every other stage of a drop, see [What your customers see](https://docs.fanfare.io/guide/drop/what-customers-see.md).

## When a shopper's payment window expires

Every admitted shopper gets a set payment window to complete checkout. Once that window expires, Fanfare revokes cart access—blocking checkout with `"Please claim access to this product before adding it to your cart"`—and returns their held units to the drop after a brief hold. See [Admission and the payment window](https://docs.fanfare.io/concepts/admission-and-payment.md).

## Auctions on Shopify

Auctions are available on Shopify only when your store's checkout can enforce and charge the winning bid. All four requirements must be met:

* Your store is on **Shopify Plus**.
* You've approved Fanfare's latest Shopify permissions so Fanfare can configure auction pricing.
* **Checkout protection** is **On**.
* Your store's currency still matches your Fanfare organization's currency.

If any requirement above is missing, the **Auction** option appears locked with `"Needs a checkout that charges the winning bid"`—upgrading your Fanfare plan won't unlock it.

> [!WARNING]
>
> Auctions require **Shopify Plus** and **Checkout protection: On**. Turning off checkout protection or changing your store's currency after creating an auction stops Fanfare from charging winning bids and prevents winners from checking out. Keep both unchanged until every winner has paid.

> [!WARNING]
>
> **No automatic discounts on auctioned products:** Winning bidders must check out once, at quantity 1, at the exact winning price, with no discounts of any kind—including store-wide automatic discounts. Exclude auctioned products from every automatic discount in Shopify, or winners will be blocked with `"Your reserved item must be checked out once…"`. If a paid auction order still comes through at a mismatched price or quantity, it won't sync to Fanfare and isn't refunded automatically—see [Orders with Shopify checkout](https://docs.fanfare.io/guide/shopify/orders.md).

Learn more in [Auction](https://docs.fanfare.io/concepts/distributions/auction.md) and [Set up an auction](https://docs.fanfare.io/guide/create/auction.md).

## When protection did not update

Whenever you create an experience, delete one, or change its attached products in Shopify, Fanfare updates checkout protection for each affected product. Occasionally the experience saves or deletes, but the Shopify gating update fails. When that happens, Fanfare displays a warning listing the affected Shopify product IDs:

* **After saving:** `"Experience saved, but Shopify gating could not be updated for ..."`
* **After deleting:** `"Experience deleted, but Shopify gating could not be removed for ..."`

Products are identified by their Shopify product IDs rather than titles. If the warning lists an ID that isn't a product, Fanfare couldn't read the experience's product list—contact Fanfare support.

> [!WARNING]
>
> A save or delete can complete without updating checkout protection. Until repaired, a product in a saved experience may remain unprotected (allowing normal checkout outside your drop), and a product from a deleted experience may display normal buy buttons while still blocking checkout until refreshed.

How to repair each case:

* **After saving experience settings:** The warning remains visible in the settings window. Save again from that window to retry updating protection for each product.
* **After creating a new experience:** The warning stays on screen until dismissed. Saving experience settings later won't retry gating unless you modify the experience's products. Don't launch the drop until protection is verified—test it using [Check that a drop is protected](#check-that-a-drop-is-protected) and send the product IDs from the warning to Fanfare support.
* **After deleting an experience:** Visit the product page on your live storefront (with the Fanfare Product Widget installed). Loading the page lets Fanfare detect the deletion and remove protection automatically. You can ignore the warning's mention of changing the product in Shopify—no Shopify edit is needed. If normal checkouts remain blocked afterward, contact Fanfare support.

## Related

> [card] [Storefront setup](https://docs.fanfare.io/guide/shopify/storefront-setup.md)
>
> Enable the checkout rule and add the product widget to your theme.

> [card] [Admission and the payment window](https://docs.fanfare.io/concepts/admission-and-payment.md)
>
> See how long admitted shoppers have to complete checkout.

> [card] [Orders with Shopify checkout](https://docs.fanfare.io/guide/shopify/orders.md)
>
> Learn how drop orders sync to Fanfare and how to import missing orders.

> [card] [What your customers see](https://docs.fanfare.io/guide/drop/what-customers-see.md)
>
> Walk through every stage of a drop from the shopper's perspective.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.