> ## 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.

# Orders with Shopify checkout

> How Shopify drop orders sync to Fanfare, how refunds and cancellations behave, and how to import missing orders.

When shoppers complete a drop in Shopify checkout, Shopify collects payment and holds the authoritative order record. Fanfare automatically records a matching copy of every order placed through your experience so your sales sit right alongside traffic, entries, and drop performance.

## How orders sync to Fanfare

Paid orders placed through a Fanfare experience sync to **Orders** in Fanfare automatically. Orders placed outside a Fanfare experience—even for the same product—never sync.

> [!NOTE]
>
> Point-of-sale (POS) orders, draft orders, and orders not placed through an online storefront cart never sync to Fanfare, even if they contain a drop product.

An order placed through an experience may also be skipped if:

* **Unimported products are in the cart:** For example, the shopper added another product alongside your drop item that hasn't been synced to Fanfare.
* **Quantity exceeded limits:** The shopper purchased more units than the experience allows.
* **Price or timing mismatch:** The shopper paid a price different from Fanfare's offer (such as an auction winner paying a non-winning price) or paid after the offer expired. See [Checkout protection](https://docs.fanfare.io/guide/shopify/checkout-protection.md).

Fanfare never refunds skipped orders automatically—refund them in Shopify if needed. Note that Fanfare's per-order fee can still apply to an order skipped because a product was missing from Fanfare. If you try to [import](#import-a-paid-order-that-did-not-arrive) an order paid at a disallowed price or quantity, Fanfare rejects it and directs you to support.

## View Shopify orders in Fanfare

Shopify orders appear alongside all other orders under **Orders**. Filter specifically for them using the **All sources** dropdown and choosing **Shopify**.

On an order's detail page, the bottom of the **Payment** card displays:

* **Vendor:** `Shopify`
* **External order ID:** The Shopify order ID
* **Sync status:** `Synced` (plus **Last synced** timestamp)
* **View source:** Opens the order directly in Shopify admin

For general order list and detail guidance, see [Orders](https://docs.fanfare.io/guide/learn/orders.md).

## Refunds and cancellations

> [!WARNING]
>
> Shopify orders can't be refunded or canceled inside Fanfare—always process refunds, cancellations, and edits in Shopify. Changes made in Shopify don't sync back to Fanfare, so Fanfare's order record and analytics keep showing the order as originally paid.

Refunding or canceling an order in Shopify also doesn't reverse Fanfare's per-order fee on your Shopify bill.

For Shopify-managed products, Shopify remains the source of truth for inventory—if you restock items during a refund in Shopify, Fanfare's stock counts follow automatically. See [Products from Shopify](https://docs.fanfare.io/guide/shopify/products.md).

## Import a paid order that did not arrive

If a paid order from a Fanfare experience is missing from **Orders**, you can import it manually from Shopify admin.

### Eligibility requirements

An order can be imported only when all of the following are true:

* It's paid in full in Shopify with no full or partial refund.
* It was placed through a Fanfare experience (and wasn't created by Fanfare checkout).
* Your Shopify store is connected to Fanfare.
* Every product line maps to an active Fanfare variant synced from Shopify (custom line items without a product are ignored).

### How to import

**1. Start from Shopify admin**

Open the order in Shopify admin and choose **Import order into Fanfare** from the actions menu.

**2. Open the Fanfare import page**

Select **Open import page**. This opens Fanfare without importing anything yet.

**3. Confirm the import**

On **Import Shopify order**, verify that **Shopify order ID** is prefilled, then select **Import order**.

**4. Open the imported order**

Once **Order imported** appears, select **View Fanfare order** to view it.

Importing an order that's already in Fanfare is safe and won't create a duplicate—Fanfare displays **Order imported** and links you straight to the existing record.

> [!NOTE]
>
> There's no navigation link to **Import Shopify order** inside Fanfare—always launch it from the **Import order into Fanfare** action on the order page in Shopify admin. See [Fanfare inside Shopify admin](https://docs.fanfare.io/guide/shopify/in-shopify-admin.md).

### Import error messages

If an import fails, Fanfare shows **Order not imported** with the reason:

| Message | What to do |
| - | - |
| `This Shopify order is not paid and cannot be imported.` | Wait until payment completes in Shopify, then retry. Fully or partially refunded orders can't be imported. |
| `This order did not pass through a Fanfare gate and cannot be imported.` | The order wasn't placed through your online store cart (e.g., POS or draft order) and can't be imported. |
| `No eligible Fanfare gate grant was found for this order.` | Fanfare has no record of this customer earning access through your experience, so the order isn't eligible. |
| `This order originated in Fanfare and cannot be imported back into Fanfare.` | The order already lives in Fanfare—look it up under **Orders**. |
| `Reconnect this Shopify store before importing an order.` | Reconnect your store (see [Install and choose a plan](https://docs.fanfare.io/guide/shopify/install-and-plans.md)) and retry. |
| `At least one Shopify line is not mapped to an active Fanfare variant. Sync the product before importing this order.` | Find the missing or out-of-date product in the order. If it's already in **Products**, open it and select **Sync from Shopify**. If not, open experience creation, pick the product in Shopify's picker, confirm, and exit *without saving*—the product remains in **Products** (see [Products from Shopify](https://docs.fanfare.io/guide/shopify/products.md)). **Don't save a dummy experience just to import a product**, or you'll activate checkout protection on it. Then retry the import. |
| `A Shopify variant is linked to a different Fanfare product. Sync the product before importing this order.` | Run **Sync from Shopify** on the product, then retry the import. |
| `Shopify could not find an order with this ID.` | Restart from the order's **Import order into Fanfare** action in Shopify admin. |
| `Shopify is temporarily limiting requests. Try again.` / `The order could not be imported right now. Try again.` | Wait a moment and select **Import order** again. |

If an error asks you to contact support, reach out rather than retrying—Fanfare couldn't settle the order automatically.

## The Shopify order card on Fanfare checkout orders

Orders created through **Fanfare checkout** (rather than Shopify checkout) display a **Shopify order** card at the bottom of the order page. Because Fanfare checkout isn't used inside the Shopify app, this card only applies if your organization also takes payments with Fanfare checkout elsewhere.

When Fanfare checkout captures payment on an eligible order, Fanfare creates the matching Shopify order automatically (and queues it for up to 24 hours if your store is temporarily disconnected). Use the **Shopify order** card to check status or manually push orders that didn't go through:

| Card status | Action |
| - | - |
| `This Fanfare order has not been pushed to Shopify.` | Select **Push to Shopify** to create the matching Shopify order. |
| `Fanfare is checking Shopify for the matching order.` | Select **Check Shopify** to recheck status. |
| `This order is linked to a Shopify order.` | Select **View in Shopify** to open it in Shopify admin. |
| `Reconnect this Shopify store before pushing the order.` | **Push to Shopify** stays grayed out until you reconnect your store. |

An order is eligible to push only when your store is connected and all of these hold:

* Paid in full through Fanfare checkout and neither canceled nor refunded
* No shipping address, shipping fee, tax, duties, discount, or shippable items
* At most 250 line items, with order total equal to the sum of its lines
* Every line item maps to a variant synced from Shopify
* Currency matches your Shopify store's currency

If an order doesn't meet these conditions, Fanfare typically shows `"This Fanfare order is no longer eligible to push to Shopify."`

> [!NOTE]
>
> If a push returns `"Fanfare could not confirm whether Shopify created this order. Contact support before trying again."`, don't push it again. Use **Check Shopify** first, and contact support if it doesn't update to linked.

## Fees

Fanfare's per-order take-rate fee on Shopify checkout orders is billed through Shopify. Review recorded fees under **Usage**—see [Billing and usage](https://docs.fanfare.io/guide/account/billing.md) and [Payments and fees](https://docs.fanfare.io/guide/account/payments.md).

## Troubleshooting

> [accordion] A paid order is missing from Fanfare
>
> First check how the order was placed: POS orders, draft orders, and non-drop orders never sync. Orders containing unimported products or paid at a disallowed price or quantity are also skipped. If the shopper did purchase through your drop, [import the order](#import-a-paid-order-that-did-not-arrive) from Shopify admin—the import status tells you what to fix or whether to contact support.

> [accordion] Fanfare asks me to reconnect my store
>
> Messages like `"Reconnect this Shopify store before importing an order."` mean Fanfare lost its Shopify connection (often after permission changes). Reconnect your store via [Install and choose a plan](https://docs.fanfare.io/guide/shopify/install-and-plans.md), then retry.

> [accordion] The order total doesn't match the sum of its line items
>
> A Shopify order's total can differ from the raw sum of its line items. Use **Order total** as the authoritative figure.

## Related

> [card] [Orders](https://docs.fanfare.io/guide/learn/orders.md)
>
> Browse, filter, and inspect orders in Fanfare.

> [card] [Checkout protection](https://docs.fanfare.io/guide/shopify/checkout-protection.md)
>
> See how Shopify blocks unauthorized checkouts for protected products.

> [card] [Fanfare inside Shopify admin](https://docs.fanfare.io/guide/shopify/in-shopify-admin.md)
>
> Use the Fanfare block and quick actions on Shopify product and order pages.

> [card] [Billing and usage](https://docs.fanfare.io/guide/account/billing.md)
>
> Track Fanfare's Shopify usage fees and billing cycles.


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