> ## 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 and refunds

> Find orders, check payment statuses, issue full or partial refunds, and decide whether refunded items return to stock.

The **Orders** page brings together every order across your organization—both native orders paid through Fanfare checkout and orders synced from your external store. Use it to look up an order, trace its payment history, cancel an uncaptured order, issue a refund, and decide whether returned items go back into inventory.

Order management and refunds are available on every plan (your plan sets only the per-order take rate—see [Payments and fees](https://docs.fanfare.io/guide/account/payments.md)). Refunds are processed through your connected Stripe account, and any team member in your organization can issue refunds and record stock decisions.

## Where to find orders

* **Orders** in the sidebar shows every order across your organization.
* **Orders** inside an experience's navigation filters the same view to that experience.
* **Customer profiles** include an **Orders for this experience** link on any drop where a customer purchased—it opens *all* orders for that experience, not just that customer's. See [Customer profiles](https://docs.fanfare.io/guide/learn/customers.md).

![The Orders page showing Total orders, Gross revenue, Refunded, and Average order value cards above a table of orders with status, total, and placed date, with the status filter highlighted.](https://mintcdn.com/fanfare/moPyXPoB2hbFUSf7/images/guide/guide-learn-orders-list.webp?fit=max\&auto=format\&n=moPyXPoB2hbFUSf7\&q=85\&s=8e7f4d41a2380ab2090bd0a801a26c98)

The Orders list with summary cards calculated across every order matching your current search and filters.

## Summary cards

Four cards sit above the table: **Total orders**, **Gross revenue**, **Refunded**, and **Average order value**. They calculate totals across all orders matching your current search and filters—not just the current page—and automatically exclude test orders. If your filtered results span multiple currencies, Fanfare displays a separate row of cards per currency without combining them.

> [!WARNING]
>
> **Gross revenue** and **Average order value** include unpaid orders (**Draft**, **Pending payment**, **Payment failed**, and **Cancelled**) and don't subtract refunds. To check collected payments here, filter **Order status** to **Paid**, then to **Partially refunded**, and read the cards for each—or check **Net revenue** on **Home** and the **Performance** tabs (see [Read your results](https://docs.fanfare.io/guide/learn/performance.md)).

## Find an order

**1. Open Orders**

Select **Orders** in the sidebar (or inside a specific experience).

**2. Search by customer, experience, or ID**

Type in **Search orders, customers, or experiences...** to match a customer's name, email, or phone number, an experience name, your external store's order ID, or a full Fanfare order ID.

**3. Filter and sort**

Narrow results by **Order status**, **Payment status**, or **Source** (such as Shopify), and sort by **Placed** (**Asc** or **Desc**). Select any row to open the order page.

> [!TIP]
>
> Search doesn't match the 8-character short reference displayed in the table. To search by Fanfare ID, use **Copy order ID** on the row to copy the full ID. Your active search and filters stay in the page URL, so you can share a filtered view with a teammate.

**Clear filters** resets the dropdown filters while keeping your search query intact.

### Reading the list and order statuses

Each row shows the **Order** reference (with **Copy order ID** and a **Test** badge on test orders), **Customer**, **Items**, **Status** (plus payment status details or sync issues like `"Shopify sync: Failed"`), **Total** (with any refunded amount underneath), **Placed** date (hover for the exact timestamp), and a row action menu for **Refund**, **Cancel**, or **View source**.

| Status | What it means |
| - | - |
| **Draft** | The buyer is still inside their payment window and hasn't paid yet. See [Admission and the payment window](https://docs.fanfare.io/concepts/admission-and-payment.md). |
| **Pending payment** | Payment hasn't been captured in full. Synced store orders may also show **Authorized**, **Partially paid**, or **Voided** underneath. |
| **Paid** | Payment was captured. Orders with a full refund still processing remain here until the refund completes. |
| **Partially refunded** | Part of the payment has been refunded. |
| **Refunded** | The entire payment has been refunded. |
| **Payment failed** | Payment didn't go through. |
| **Cancelled** | The order was canceled. |

> [!NOTE]
>
> Canceled native Fanfare orders display **Failed** as their payment status in the list (while showing **Cancelled** on their **Payment** card), so filtering **Payment status** to **Failed** includes canceled Fanfare orders as well.

## The order page

Opening an order shows the 8-character reference, status, experience name, and an **Actions** menu in the header (test orders also display a banner confirming they're excluded from revenue, purchase limits, and customer metrics).

![An order page for a paid order with the Actions button highlighted, the Payment card showing order total, refunded and remaining refundable amounts and a Fanfare fee row, the Items card, the Timeline, and the Customer & addresses card.](https://mintcdn.com/fanfare/moPyXPoB2hbFUSf7/images/guide/guide-learn-orders-detail.webp?fit=max\&auto=format\&n=moPyXPoB2hbFUSf7\&q=85\&s=68f0dbacd877ac69ab674f3ada948eae)

Inspect payment details, items, timeline events, and issue refunds from the Actions menu on the order page.

* **Payment** — **Order total**, **Refunded**, **Remaining refundable**, **Provider** (Stripe or Shopify), **Payment status**, **Amount**, **Fanfare fee**, and provider **Reference**. At the bottom, you'll see **Vendor** (`Native` for Fanfare checkout, or your external store name), **External order ID**, **Sync status**, **Last synced**, and **View source**.
* **Items** — Products, variants, quantities, line totals, unit prices, and post-refund stock status, plus **Tax**, **Shipping**, **Discount**, and **Duties** when nonzero. For external store orders, rely on the order total if synced line items don't add up to it.
* **Timeline** — Chronological log of order placement, payment capture or failure, cancellations, and every **Full** or **Partial** refund with its reason.
* **Customer & addresses** — **Name** (links to their customer profile), **Email**, **Phone**, **Shipping address**, and **Billing address**.

### Available actions by status

| Status | **Refund** | **View source** |
| - | - | - |
| **Draft** | No | Synced orders only |
| **Pending payment** | No | Synced orders only |
| **Paid** | Native orders only | Synced orders only |
| **Partially refunded** | Native orders with remaining balance | Synced orders only |
| **Refunded**, **Payment failed**, **Cancelled** | No | Synced orders only |

* **Cancel** appears on native Fanfare orders whose payment hasn't been captured yet (such as **Pending payment**). Confirming the **Cancel order** dialog voids the payment before capture and marks the order **Cancelled**. Once payment is captured, refund the order instead. See [Checkout options](https://docs.fanfare.io/concepts/checkout-options.md) and [Admission and the payment window](https://docs.fanfare.io/concepts/admission-and-payment.md).
* **Refund** applies only to native Fanfare checkout orders. If a refund fails after a full refund was previously attempted, **Refund** may not reappear for the remaining balance—issue it from your Stripe Dashboard instead.
* **View source** opens the order in your external store when the store provides a link.

## Refund an order

**1. Open the refund dialog**

Open the order page and select **Actions → Refund** to open the **Create refund** dialog.

**2. Verify the refund amount**

Confirm **Refund amount** for a full refund, or enter a smaller amount for a partial refund (minimum one cent; commas work as decimal separators; the amount can't have more decimal places than the currency allows).

> [!WARNING]
>
> **Refund amount** pre-fills with the full remaining balance. Submitting sends the refund to Stripe immediately and can't be undone—double-check the amount before continuing.

**3. Choose which items return to stock**

If Fanfare manages stock for items on the order, check each sellable item under **Return to stock**. For multi-unit items, enter the quantity in **Units back in stock (1 to N)**. Items you leave unchecked are recorded as kept out of stock (you can still return them later from the order page).

**4. Add a reason and submit**

Optionally enter a **Reason**, then select **Submit refund** (or **Submit refund and return N units to stock**).

![The Create refund dialog with the refund amount highlighted, two checked items with a units back in stock field on one, and a submit button naming the units returning to stock.](https://mintcdn.com/fanfare/moPyXPoB2hbFUSf7/images/guide/guide-learn-orders-refund-dialog.webp?fit=max\&auto=format\&n=moPyXPoB2hbFUSf7\&q=85\&s=1c5d568758b0e73f81c5c255216092b7)

Refund amount pre-fills with the full remaining balance; check items under Return to stock to restore inventory at the same time.

### What happens after you submit

* **Completed immediately:** Your refund and stock choices are recorded right away.
* **Pending in Stripe:** Pending refunds immediately count toward **Refunded** and **Remaining refundable** (if one later fails, the balance is restored). However, the stock choices you made in the dialog are discarded—make them again on the order page once the refund completes.
* **Failed:** No items are returned to stock.

You can issue multiple partial refunds until the remaining balance reaches zero.

> [!NOTE]
>
> You can also select **Refund** from an order's row menu in the Orders list. That shortcut skips the **Return to stock** section, leaving refunded items as **"No stock decision recorded"** until you decide on the order page.

## Decide stock after a refund

When a refunded order has Fanfare-managed items awaiting a stock decision, a banner on the order page links directly to them via **Go to item**.

![A refunded order page with a notice that a refund was recorded and no stock decision has been made yet, and an item showing No stock decision recorded with Return to stock highlighted and Keep out of stock buttons.](https://mintcdn.com/fanfare/moPyXPoB2hbFUSf7/images/guide/guide-learn-orders-stock-decision.webp?fit=max\&auto=format\&n=moPyXPoB2hbFUSf7\&q=85\&s=5170f4812149da568bdf2ef75f01b1a9)

Refunded items without a stock decision display Return to stock and Keep out of stock actions directly on the order page.

For each eligible item, choose:

* **Return to stock** — Adds the units back to your product's **Supply**. It doesn't lower **Sold** or automatically add units back into a drop's allocation—to sell them again, allocate them to a drop (see [Allocate stock to a drop](https://docs.fanfare.io/guide/create/stock-allocation.md)). Single units return immediately; multi-unit lines ask how many came back sellable. Fanfare prevents returning the same unit twice.
* **Keep out of stock** — Records that the item isn't returning to sellable inventory. You can still return it later if needed.

Only non-test orders with a completed refund and a non-deleted, Fanfare-managed product can be returned to stock. See [Manage stock](https://docs.fanfare.io/guide/create/stock.md) for how returned units affect supply and where to find pending returns on the product page.

## External store orders

Orders synced from an external store show the store's name under **Vendor**, along with its **External order ID** and **Sync status**. Select **View source** to open the order in your store's admin.

> [!WARNING]
>
> Orders synced from an external store (such as Shopify) can't be refunded in Fanfare. Process refunds directly in that store.

## Refunds, fees, and loyalty points

* **Fees:** Fanfare's per-order fee isn't returned when you refund an order. Check Stripe's documentation for how refunds affect Stripe processing fees, and see [Payments and fees](https://docs.fanfare.io/guide/account/payments.md) and [Billing and usage](https://docs.fanfare.io/guide/account/billing.md) for rate and billing details.
* **Stripe Dashboard refunds:** Any refund issued directly in your Stripe Dashboard syncs back to the Fanfare order automatically—don't submit it a second time in Fanfare.
* **Loyalty points:** Refunding an order doesn't automatically deduct the **Purchase** points the customer earned. To claw them back, deduct them manually on the customer's profile using the **Refund adjustment** reason (see [Run a loyalty program](https://docs.fanfare.io/guide/learn/loyalty.md)).

## Test orders

Orders placed with a test payment method appear alongside live orders with a **Test** badge, hatched row background, and a **"Test order"** banner. They're excluded from revenue, purchase limits, and customer metrics, and their items can't be returned to stock. See [Add and gate sequences](https://docs.fanfare.io/guide/create/sequences.md) for test orders and purchase limits.

## On Shopify

The **Orders** list and order detail page work the same inside the Fanfare Shopify app. Because Fanfare checkout isn't used in the Shopify app, orders completed through Shopify checkout show **Vendor** as **Shopify**, offer at most **View source**, and must be refunded in Shopify. Refunds issued in Shopify don't sync back to Fanfare, so the order continues showing **Paid** in Fanfare.

In the Shopify app, the order page also includes a panel to push a Fanfare order to Shopify or link it to an existing Shopify order. See [Orders with Shopify checkout](https://docs.fanfare.io/guide/shopify/orders.md).

## Troubleshooting

> [accordion] Refund isn't available under Actions
>
> Check whether one of the following applies:
>
> * The order was synced from an external store (refund it in that store instead).
> * Payment hasn't been captured yet—use **Cancel** if available.
> * The order is already fully refunded or has a full refund in progress.
> * The order is still in **Draft** while the buyer is in their payment window.

> [accordion] My refund amount isn't accepted
>
> Make sure the amount is at least one cent, doesn't exceed the currency's decimal precision, and doesn't exceed **Remaining refundable** (which already accounts for pending refunds).

> [accordion] Search doesn't find an order by its short reference
>
> The 8-character short reference isn't searchable. Use **Copy order ID** on the row to search by the full Fanfare ID, or search by customer details, experience name, or external store order ID.

> [accordion] Return to stock isn't available on a refunded item
>
> Items can be returned to stock only after the refund completes in Stripe, on non-test orders, for non-deleted products whose stock is managed by Fanfare.

## Related

> [card] [Payments and fees](https://docs.fanfare.io/guide/account/payments.md)
>
> Connect Stripe and review your Fanfare take rate.

> [card] [Manage stock](https://docs.fanfare.io/guide/create/stock.md)
>
> Track product supply and see how returned units are handled.

> [card] [Read your results](https://docs.fanfare.io/guide/learn/performance.md)
>
> Compare paid orders and net revenue across your drops.

> [card] [Customer profiles](https://docs.fanfare.io/guide/learn/customers.md)
>
> View the customer behind any order.

> [card] [Orders with Shopify checkout](https://docs.fanfare.io/guide/shopify/orders.md)
>
> Push Fanfare orders to Shopify or link them to Shopify orders.


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