# Returns & Order Edits

> Take returns and exchanges, let customers ask for returns themselves, refund or cancel orders, and edit an order after it was placed.

After a sale, customers change their minds, items arrive damaged, or an order needs a different size. This page covers the four tools for that: **returns** (with refunds, store credit, or exchanges), **refunds**, **cancel order**, and **edit order**.

All four work on native orders, the orders created in Workstation or on your online store. Orders synced from Shopify, ERPNext, or other apps are handled in their own system.

Money always moves through the order's invoices. Taking items off a paid order makes a credit note, and stock goes back when the original sale took it out. See [Invoices](https://workstation.repzo.com/docs/commerce/invoices) and [How the money is recorded](https://workstation.repzo.com/docs/online-store/checkout-and-payments#how-the-money-is-recorded).

## Return rules

Open **Commerce → Settings → Returns** to decide what customers can return themselves.

| Setting | What it does |
|---|---|
| **Self-serve returns** | Customers can ask for a return from their order page or account. Off by default. |
| **Return window** | 7, 14, 30 (default), 60, or 90 days, or **Any time**. Counted from delivery, or from shipping when delivery isn't tracked. |
| **Approve requests automatically** | Requests open straight away and the customer gets your return instructions |
| **Exchanges** | Customers can swap for another size or color of the same product. On by default. |
| **Return shipping** | **Free for the customer** or **Customer pays to send it back** (the default). Shown to the customer. |
| **Final-sale products** and **Final-sale tags** | Products customers can't return. You can still return them from the order page. |
| **Return instructions** | The default "how to send it back" text, in English and Arabic, shown when a return is approved |

## Customers asking for a return

When self-serve returns are on, a **Returns** section appears on the [order status page](https://workstation.repzo.com/docs/online-store/shipping-and-delivery#the-order-status-page). Signed-in shoppers reach it from their account's orders.

1. The customer clicks **Return items**.
2. They pick the items and quantities, and a reason for each.
3. They choose **A refund** or, when exchanges are on, **An exchange** and pick the size or color they want instead.
4. They click **Send return request**.

Only items that have shipped can be returned, and the page says why when a return isn't possible: the order is unpaid or canceled, nothing has shipped, the window has closed, or everything is already in a return. A customer can withdraw a request while it waits.

The request shows in **Commerce → Returns** as **Requested**, and the customer gets the **Return request received** email. With auto-approve on, it opens straight away instead.

## Start a return yourself

Open the order. On the **Returns** card, click **Start return**.

1. Set the **Quantity** and **Reason** for each item coming back.
2. Choose what the **Customer gets**: **Refund**, **Store credit**, or **Exchange**. For an exchange, click **Pick items** to choose what to **Send instead**.
3. Optionally add the **Customer's note** and an **Internal note**.
4. Tick **Wait for approval before telling the customer how to send it** to save it as a request, or leave it to open the return now.
5. Keep **Email the customer** ticked to send them the instructions, and click **Start return**.

You need the `orders.update` permission. AI agents and the public API can start returns too.

## Handle a return

Click a return on the order's Returns card, or in **Commerce → Returns**, to open it. The steps are:

1. **Approve** (or **Decline**) a request. When you approve, choose how it comes back:
   - **Instructions** for the customer (your default return instructions are filled in);
   - **Upload a label** file, with carrier, tracking number, and tracking link;
   - **Nothing to send back**, when the customer keeps it or brings it to the shop.

   Declining asks for a **Reason**, which the customer sees on their order page and by email.
2. **Receive items**: enter how many **Arrived** and how many can **Restock**. Stock moves when you refund or exchange, not here.
3. **Refund** or **Exchange**:
   - A refund puts the items on a credit note, then sends the money back: **The card they paid with**, **Store credit**, **Cash**, **Bank transfer**, or **Credit note only**.
   - An exchange adds the new items to the order and bills them. If the new items cost more, the customer gets a pay link for the difference. If they cost less, the difference is refunded.

The return is then **Returned**. Use **Edit return shipping** to change how it comes back, and **Cancel return** to drop it. Moving money needs both `orders.update` and `invoices.update`.

If a card refund fails, the credit note is kept and **Try the refund again** appears.

### The returns list

**Commerce → Returns**, under Orders, lists returns across all orders. Use the status tabs (**All**, **Requested**, **In progress**, **Returned**, **Declined**, **Canceled**) and search. The list follows the store picked in the site switcher. **Return rules** opens the settings.

## Refund an order

For a refund without a return, open a paid order and click **Refund**.

1. If the order was billed on more than one invoice, pick the **Invoice**.
2. Set how many of each item to **Refund**. Shipping is a line too.
3. Choose **Refund to**: **Store credit**, **Cash**, **Bank transfer**, or **Credit note only** (nothing goes back now, for unpaid orders or money settled elsewhere).
4. Add a **Reason** and click **Refund**.

A credit note is made for what's coming back, and stock returns if the sale took it out. The order turns **Refunded** or **Partially refunded**, and the customer gets the **Refunded** email.

Refunding an amount without picking items isn't available yet.

## Cancel an order

Click **Cancel order** on a native order that isn't canceled.

1. Enter a **Reason**.
2. Under **Money**, choose **Keep the money as it is** or **Refund with a credit note**. A credit note is made for each of the order's invoices, and stock goes back if the invoice took it out.
3. Click **Cancel order**.

Canceling also cancels shipments that haven't gone out, closes any open card checkout for the order, stops its pay links, releases held stock, and gives back discount uses. If a payment arrives while you cancel with **Keep the money as it is**, the cancel stops so you can decide again. A canceled order can't be reopened.

## Edit an order

Click **Edit order** on a native order that isn't canceled or fully fulfilled. You can:

- change quantities or **Remove** items (shipped units can't be taken off);
- **Add products** from your catalog or **Add custom item**;
- set a **Discount %** per line;
- change the **Shipping fee**;
- add a **Reason** for the timeline.

Click **Review changes** to see **Was**, **Now**, and the **Difference**, then **Update order**. What happens to the money depends on the order:

| The order is… | What happens |
|---|---|
| Not billed yet | Only the order changes |
| Billed on an unpaid invoice | The unpaid bill is replaced with the new total, with a fresh pay link |
| Paid, and the total went up | The customer pays the difference with a pay link |
| Paid, and the total went down | The difference goes back to the customer, using the **Refund to** you pick |

Tick **Email the customer the updated order** to send the **Order updated** email.

## Emails, workflows, and webhooks

Customers get these emails, each with its own switch in **Commerce → Settings → Customer messages**: **Return request received**, **Return approved**, **Return declined**, **Refunded**, and **Order updated**. See [Customer emails](https://workstation.repzo.com/docs/online-store/shipping-and-delivery#customer-emails).

For WhatsApp or other follow-ups, [Workflows](https://workstation.repzo.com/docs/administration/workflows) have these order triggers: **Return Requested**, **Return Approved**, **Return Declined**, **Return Completed**, **Order Edited**, **Order Canceled**, and **Order Refunded**.

[Webhooks](https://workstation.repzo.com/docs/administration/webhooks) send `order.return_requested`, `order.return_approved`, `order.return_declined`, `order.return_received`, `order.return_closed`, `order.return_canceled`, and `order.edited`. Returns and edits also appear on the order's timeline.

Developers can manage returns and edits through the public API (`/api/v1/order-returns` and `/api/v1/order-edits`). See [Developer API and CLI](https://workstation.repzo.com/docs/configuration/developer-api).

## Not available yet

- Return or restocking fees taken off the refund.
- Photos on return requests.
- Carrier return labels made automatically.
- Restocking at a different location than the sale's.

> **From the CLI**
>
> Return rules, returns, order edits, and cancels can also be handled from the CLI with `repzo store returns`, `repzo order-returns`, `repzo orders edit`, and `repzo orders cancel`. Returns and edits from the CLI can refund to the original card; a standalone **Refund order** is done in the app. This requires the next CLI release. See [Build a store from the CLI](https://workstation.repzo.com/docs/developers/online-store/cli#run-the-store).

## Related pages

- [Shipping & Delivery](https://workstation.repzo.com/docs/online-store/shipping-and-delivery)
- [Checkout & Payments](https://workstation.repzo.com/docs/online-store/checkout-and-payments)
- [Orders](https://workstation.repzo.com/docs/commerce/orders)
- [Invoices](https://workstation.repzo.com/docs/commerce/invoices)
- [Gift Cards](https://workstation.repzo.com/docs/commerce/gift-cards)
- [Workflows](https://workstation.repzo.com/docs/administration/workflows)
