How Gatemi Returns Works

A return moves through five states: Requested, Approved or Declined, and then Refunded or (full edition) Exchanged. Every move is checked against four rules. Each rule exists because the common way of doing it goes wrong in a way a shop only notices later.

The flow, step by step

  1. The customer asks. In My Account → Orders, an order with something left to return shows Request a return. The button opens the form at My Account → Returns for that order. The customer enters a quantity on each line they want to send back, writes why (free edition) or picks a Reason and what they would like (full edition), and presses Request the return.
  2. The request is stored. It gets an RMA reference such as RMA-7KQ4MZ2P — eight characters from an alphabet without 0/O or 1/I/L, so nobody misreads it on a parcel label. The quantities are held against the order straight away, so the same units cannot be asked for twice. An order note says "Return requested by the customer: RMA-…". The customer gets an email; the shop's admin address gets "New return request RMA-… on order #…".
  3. You decide. In WooCommerce → Returns, open the request. The screen shows the order, the customer, what they asked for, each line with what it was charged per unit, the window, and the refund worked out as arithmetic. Press Approve or Decline, with an optional note that goes to the customer.
  4. Declined: the held quantities are released and the customer is told, with your note.
  5. Approved: the customer is told to send the items back with the reference on the parcel. When they arrive, open the request again and press Issue the refund (or, full edition, Complete the exchange), choosing whether to Put the returned items back into stock.

Rule 1 — a return is a record, never a second order

A return is a row in the plugin's own table, its lines in a second table, and a real WooCommerce refund on the order it came from. Nothing else.

The shortcut many plugins take is a "return order" — a placeholder or a negative order for every return. That one move corrupts your revenue report, your product analytics, your tax figures and your stock history at once, and it is usually found at the end of a quarter. Gatemi Returns never creates an order — not for a refund, not for store credit, not for an exchange.

Rule 2 — the window is judged twice

The window is checked when the customer asks, and again when you decide.

When the request is made, the date its window closes is stored on it. When you open it, the plugin works the window out again with today's settings. If a request made in time has sat in the queue past its window, the screen says so: "The return window has closed since this request was made. It was asked for on …, inside the window; the window closed on …".

You are not stopped, and you are not silently let through. To approve it you tick I know the return window has closed, and I am approving a request that was made inside it. The order note records that it was approved after the window closed. Without the tick the approval is refused.

Worked example. The window is 30 days. An order completes on 1 March. The customer asks on 28 March; the request stores 31 March as its close. You open it on 4 April. The screen shows both dates, and Approve needs the tick.

Rule 3 — only what the order bought

The form lists only the customer's own order, and only lines that can still come back. Whatever is posted, the plugin keeps a line only if it belongs to that order and is still eligible, and caps the quantity at:

the line's quantity − units WooCommerce has already refunded − units other returns are holding

A line is not offered when it is Final sale — not returnable, when The return window has closed, or when it is Already returned or refunded.

A held quantity is released when a request is declined. When a refund is issued the hold is released too — from then on WooCommerce's own refunded quantity counts those units, and counting both would block units that were never returned. An exchange keeps its hold, because nothing was refunded but the goods came back.

Ownership is decided in one place: the signed-in customer must own the order. Somebody else's order and an order that does not exist get the same answer — "That order could not be found on your account" — so the form cannot be used to find out which order numbers exist.

Rule 4 — the money moves through WooCommerce

Issue the refund calls WooCommerce's own refund with the returned lines, their tax and your restock choice.

  • The payment method can refund: the money goes back through it automatically. Gatemi's Stripe, PayPal and Authorize.Net plugins all can.
  • It cannot (cash on delivery, a bank transfer): the refund is still recorded on the order, and the decision screen, the order note and the refund reason all say you must return the money yourself.

Every figure is the order line's own — what that unit was charged and its tax — never today's catalogue price. A refund larger than what remains refundable on the order (because part was refunded another way) is refused before anything moves; refund the rest from the order screen.

Nothing is marked Refunded without a refund. If WooCommerce or the payment method refuses, the request goes back to Approved and you see the refusal in the payment method's own words.

One decision, once

Every decision is a single database update that only succeeds from the state it expects — Requested to Approved, Approved to Refunded. A double-clicked button, two tabs on one request or a re-posted form is one decision, one email and one refund. A refund can only be issued on an Approved request.

Full edition: exchanges, store credit and fees

Exchange. Approve as an exchange, wait for the items, then press Complete the exchange. The request becomes Exchanged, the returned units are restocked if you ticked the box, an order note says the replacement goes out through your usual fulfilment, and the customer is told it is on its way. No order is created and no money moves — you send the replacement however you normally ship.

Store credit. The refund is still a real WooCommerce refund, issued without sending money back to the card, and the customer gets a coupon: CREDIT- plus the request's eight characters, a fixed cart amount, usable once, by one customer, restricted to their billing address. If WooCommerce refuses the refund, the coupon is withdrawn, so a coupon never exists without the refund that pays for it.

Restocking fee. A percentage or a flat amount, taken in proportion across every line and every tax rate, rounded per line. The decision screen shows it before anything is issued, and the refund email shows it after.

Return note. Print the return note opens a printable page — the reference, the order, the address and the items — to put in the parcel. The customer can open it from My Account → Returns too.

What the customer sees

  • My Account → Returns lists their requests: reference, order, date and status (and, full edition, a store-credit code and a Return note button).
  • The order's own page in My Account shows a Returns section with its requests.
  • Plain-text emails when the request arrives, is approved, is declined, is refunded and (full edition) is exchanged.

Next: FAQ and troubleshooting.

Shopping Cart
Scroll to Top