Skip to content

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 and How the money is recorded.

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

When self-serve returns are on, a Returns section appears on 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.

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.

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.

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.

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.

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.

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.

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.

For WhatsApp or other follow-ups, Workflows have these order triggers: Return Requested, Return Approved, Return Declined, Return Completed, Order Edited, Order Canceled, and Order Refunded.

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.

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