Gatemi Returns FAQ and Troubleshooting

"Request a return" does not show on an order

The button is added to the order's actions in My Account → Orders only when all of these are true:

  1. Customers may ask for returns from My Account is on.
  2. The order is Completed. The free edition only takes completed orders. Full edition: the order's status is in Order statuses that can be returned.
  3. At least one line can still come back: it is inside its window, not final sale, and not already returned or refunded in full.

For a completed order, the window starts at the moment it was marked Completed. An order completed 31 days ago with the default 30-day window has no button — and that is the policy working.

The Returns page in My Account gives a 404

The plugin adds a gmrt-returns endpoint to My Account and flushes the rewrite rules once when it first registers it. If another plugin or a migration reset them, go to Settings → Permalinks and press Save Changes without changing anything.

The refund says I must return the money myself

The order was paid with a method that cannot refund through its own API — cash on delivery, a bank transfer, a cheque. The refund is still recorded on the order (so your reports and stock are right), and the screen, the order note and the refund reason all say the money is yours to send. Pay the customer back the way you normally would.

"The refund is more than remains refundable on the order"

Part of the order was already refunded another way — from the order screen, or by another plugin. The plugin refuses to over-refund, and issues nothing. Refund what is left from the order screen in WooCommerce.

I cannot approve — it says the window has closed

The request was made inside the window, but the window has closed since. Tick I know the return window has closed, and I am approving a request that was made inside it. and press Approve again. The order note records that you approved it late. See the window rule.

A customer pressed the button twice. Did they get two refunds?

No. Every decision only moves a request from the state it expects to the next one, in one database update. The second press finds the request already decided and does nothing: one decision, one email, one refund.

Does this work with the block-based My Account, cart and checkout?

The request form lives in My Account, which WooCommerce draws the same way on classic and block themes, and the buttons carry wp-element-button so a block theme styles them as its own. The plugin does nothing at the cart or checkout. Both editions declare Cart and Checkout block compatibility.

Does it work with HPOS?

Yes. Both editions declare compatibility with WooCommerce's High-Performance Order Storage. Orders are read and noted through WooCommerce's own order API, and the only order meta is _gmrt_returned_qty.

Do cache plugins matter?

No storefront page is affected except My Account, which caching plugins leave uncached for signed-in customers. The plugin loads no JavaScript.

Why did a final-sale product not appear in the free edition?

A product marked Final sale — never returnable by the full edition is still refused by the free edition, because that flag only ever holds a product back. The free edition reads nothing else from the full edition: product and category windows and category flags are kept, not applied.

I asked for an exchange under the full edition, then went back to the free edition

The request is still shown in full — its resolution, reason, store-credit code and refund. The free edition will not refund an approved exchange or store-credit request to the card, because that is not what the customer asked for. Decline it, or settle it from the order screen.

Moving from the free edition to the full edition

Install and activate the full edition (see Getting started). Both editions use the same two tables, column for column, the same gmrt_settings option, the same order meta and the same My Account endpoint. Every past return and every request in flight is there, your four settings are kept, and the full edition's own settings start at their defaults. While the full edition is active the free one stands down; delete it when you like.

What does uninstalling remove?

Neither edition ever deletes a return: the gmrt_requests and gmrt_request_items tables, their schema marker and the held quantities on orders are kept on any store, because they are your record of what came back and why.

  • Free edition: removes the gmrt_settings option and the endpoint marker — but only if the full edition has never been activated on the site. If it has, it removes nothing.
  • Full edition: removes gmrt_settings, the licence state, the endpoint marker, the cached update payload and the licence check, and the per-product and per-category rules (_gmrt_non_returnable and _gmrt_window_days). If the free edition is installed beside it, the settings, the endpoint marker and the per-product final-sale flags are left for it, because the free edition runs on them too.

WooCommerce refunds and store-credit coupons are WooCommerce's own records and are never touched.

Does it send data anywhere?

No. Returns are kept in your database and refunds go through WooCommerce. The full edition contacts gatemi.com only to check its licence and offer updates, and only once a key is entered.

Shopping Cart
Scroll to Top