Refund queue
In the app: Refund Hub → Queue
Needs the 'View Refund Hub' permission.
The queue holds the refunds the AI submitted that need a person's decision before any money moves. Each request is a card you approve, deny, mark as manual or correct. Approving sends the refund to Shopify.
Pending Refunds
A refund request lands here when the AI submits a refund in a ticket and the store has "Refund Approval Required" switched on under Settings → Refund Hub. A store that processes refunds automatically still sends a request here when:
- one of its safeguards stops the automatic refund; the card then carries a tag that says why (see "What a refund card shows");
- the automatic refund was tried and did not go through; that card has no tag.
Refunds that follow a validated return are the exception to the approval switch: they follow the store's choice for validated returns, so they can be paid automatically in a store that requires approval, or come here in a store that does not. A destination-city mismatch, a confirmed parcel shared with an already-refunded order, or a return proved by a receipt before the carrier reports its destination sends an otherwise automatic validated-return refund here for review.
The page loads 20 requests at a time, oldest first unless you change the order. Cards still showing "Refund pending" can remain alongside the next batch, so more than 20 cards can be visible. There is no button to load more: as requests are handled, the next ones come in. To reach a particular request further down, use the store filter, the sort order, the amount range or the order search. The list reloads every 30 seconds. When a teammate denies a request or marks it manual, its card disappears at once; when a teammate approves it, the card shows "Refund pending" until Shopify has answered.
A teammate whose access is limited to certain stores only sees requests of those stores. With access to more than one store and "All stores" selected, the 20 are taken from the whole organization's queue first and the other stores' requests are then left out, so fewer than 20 can show, or none, while more are waiting. Selecting one store in the filter shows that store's first 20.
Under the search field a caption can read "Requiring approval · 2 stores are set to auto-approve": that many of your stores have "Refund Approval Required" switched off, so their refunds normally do not come here.
When the list is empty the page says why:
- "Queue is empty": nothing is waiting. "Configure return settings" opens Settings → Refund Hub.
- "No stores have returns enabled": none of your stores has its return portal switched on. "Open return portal settings" opens Settings → Return Portal. The message looks at the return portal only; whether the AI can submit refund requests for a store depends on the store being enabled under Settings → Refund Hub.
- "All stores set to auto-approve": every store with the return portal on has "Refund Approval Required" switched off. "Open Refund Hub settings" opens Settings → Refund Hub.
- "No pending refund for that order", "No refunds in that amount range" or "This refund request is no longer pending": your search, amount range or link matches nothing that is still waiting. Decided requests are on the "History" tab.
The "Open return portal settings" and "Open Refund Hub settings" buttons are greyed out for someone without the 'General Settings' permission.
Filter, sort and search
- Store filter ("All stores"): shows one store's requests. After each store's name is how it is set up: "(photo + approval)", "(photo review)", "(approval)" or "(auto)". The choice also applies on the other Refund Hub tabs.
- Sort: "Oldest first" (default), "Newest first", "Highest amount first" or "Lowest amount first". The order is applied to the whole queue, not only to the cards on screen. When the queue holds several currencies, the amount orders rank each currency on its own and mix the ranks, so the largest refund of every currency comes first; amounts are not converted.
- "Min amount" and "Max amount": show only requests whose refund amount is in that range, both ends included. Leave one empty for an open end. The minimum cannot be above the maximum. The range is applied when you press Enter or leave the field.
- Currency ("Each currency"): only appears once the queue has shown more than one currency. Without a currency, the range is read in each refund's own currency and nothing is converted, so 1,000 SEK counts as more than 500 EUR. Pick a currency to see only refunds in that currency that are in the range. The currency does nothing without a minimum or maximum amount.
- "Search by order ID...": type an order number and press Enter or "Search". It finds pending requests whose order number contains the text; a leading # is ignored and capitals do not matter. The cross clears the search.
- Refresh (the round arrow) reloads the queue.
A link from a ticket opens the queue on one request, marked "Linked from conversation". While it is open, the store filter, the amount range and the search are not applied. "Show all pending refunds" returns to the whole queue.
What a refund card shows
- The shop, the order number and the customer's name and email address.
- The refund amount, followed by the order total and the refund as a percentage of it, such as "of €80.00 order · 25%".
- "Edited · AI suggested …": someone changed the amount; the AI's original amount is shown.
- "Whole order" or "Partial — 2 items, 3 units": what the refund covers. Click a partial label to see the items and what the customer paid for each. When a paid value is known for every item, a line shows the refund against the total paid, and "Exceeds paid value" when the refund exceeds what was paid for those items by more than 0.01.
- The reason the AI gave, and "Category:" with the refund category and its limits as they were when the request was made, such as "Max 50%" and "Full order allowed" or "Line items required". The limits are set under Settings → Refund Hub; changing them later does not change the card.
- "Conversation": the request is linked to a ticket. "View conversation" opens it. "Return Portal" is shown instead when no ticket is linked to the request.
- "Dispute Risk": the AI marked the case as a dispute, a chargeback or a legal threat.
- "Submitted" with the time the request was made, in your own timezone.
A yellow tag shows why an automatic safeguard sent the refund here. Hover over it for the explanation.
- "Return policy review": the store's return policy or required order facts need a person's check.
- "Automatic processing paused": automatic processing was paused when the refund came in. Resuming does not approve it.
- "Auto refund cap exceeded": the amount is at or above the store's "Send large refunds for approval" amount.
- "Currency not covered by cap": the refund is in another currency than the store's cap, or its currency could not be established.
- "Auto refund cap unreadable": the store's cap could not be read.
- "Order already auto-refunded": this order already had an automatic refund; only one is paid automatically per order. Check the earlier refund first.
Someone with 'View Refund Hub' but without 'Process Refunds' sees the cards with "View only" instead of the buttons. The server refuses approving, denying, marking manual and editing without 'Process Refunds'.
Approve
Needs the 'Process Refunds' permission.
"Approve" asks "Process refund of … for order …?". "Approve Refund" confirms. There is no field for a note.
Before anything is sent, Squid checks the request against Shopify while you wait: that the store is connected, that the order exists and Shopify can still refund it, that the amount is not more than can still be refunded on the order, that the order has a payment to refund against unless it uses manual payment, and that the currency matches the order. A refund for a return is also checked against the return it was made for, and a refund of a shipping warranty, gift card or membership item against the store's rules for those. If a check fails, the request stays in the queue, the reason is shown on the card, and nothing is paid.
When the checks pass, the card shows "Refund pending" and Squid creates the refund in Shopify in the background: for the amount on the card, and for the items and quantities recorded on the request. A request without recorded items is sent with the items Shopify itself suggests for the order. Squid asks Shopify to send its refund notification to the customer, except on a retry where Shopify already recorded and announced the earlier refund. The card updates by itself, usually within seconds.
When Shopify confirms:
- the request moves to the "History" tab as "Approved", with your email address and the positive refunded amount Shopify reported, or the requested amount if Shopify has not reported a positive amount yet;
- an internal note is added to the ticket the request is linked to, saying the refund was approved and processed. The note is not sent to the customer and the AI does not reply to it;
- it is added to the refund log, when that is switched on under Settings → Refund Hub.
An approved refund cannot be undone from Squid. The money goes back through Shopify, against the payment of the order.
Only one person can decide a request. If a teammate was first, you see "This refund has already been processed by another agent".
Deny
Needs the 'Process Refunds' permission.
"Deny" opens "Deny Refund". A reason is required, up to 5,000 characters. "Deny Refund" confirms.
Nothing is sent to Shopify and no money moves. The request moves to the "History" tab as "Denied" with your reason, an internal note with the reason is added to the ticket the request is linked to, and the denial is added to the refund log when that is switched on.
Denying does not email the customer and does not make the AI reply. If the customer should hear about it, reply in the ticket. A denial cannot be reversed from the queue. A request whose last refund attempt failed can still be denied; one that shows "Refund pending" cannot.
Manual
Needs the 'Process Refunds' permission.
"Manual" opens "Mark as Manual", with optional notes of up to 5,000 characters. "Mark Manual" confirms.
Use it when you handle the refund yourself outside the queue, for example directly in Shopify. Squid sends nothing to Shopify. The request moves to the "History" tab as "Manual" with your notes, and an internal note on the linked ticket says the order was marked for manual refund processing. It is not added to the refund log, and Squid does not check afterwards whether the refund was made. It cannot be reversed from the queue.
Edit
Needs the 'Process Refunds' permission.
"Edit" opens "Edit Refund Amount". Type the amount that should be refunded and click "Save Amount".
- The lowest amount is 0.01 and the highest is the order total recorded on the request. The currency cannot be changed, and neither can the items the refund covers.
- The request stays in the queue. Editing does not approve it: you still click "Approve".
- The card then shows "Edited · AI suggested …" with the AI's original amount, also after a second edit.
- Shopify's own limit can be lower than the order total, for example after an earlier refund. That limit is checked when you approve.
- Only a waiting request can be edited, not one that shows "Refund pending".
Refund pending and failed refunds
"Refund pending" on a card means the refund was approved and is being created in Shopify. The buttons are disabled while it runs.
"Refund failed" means the last attempt did not go through. The card stays in the queue and shows the reason. "Retry refund" approves it again, with the same checks. If the cause is the amount, use "Edit" first. Where an earlier attempt may already have reached Shopify, the retry reuses that attempt's request, so Shopify does not pay twice.
By default, a refund still unfinished after 10 minutes comes back as failed when the queue is next checked, unless its worker is holding it while processing, with the message that Shopify may or may not have paid it. Approving again first checks Shopify for a refund that was already made and records that one instead of paying again. If Shopify cannot be read, or the refunds on the order cannot be matched, nothing new is sent and the card says to check the order in Shopify.
Two outcomes are only visible on the "History" tab: "Refund failed" there means Shopify accepted the refund but the payment provider failed to pay all of it. Some money may already have reached the customer; check the failure reason for a partial payout. "Needs reconciliation" means the refund was made in Shopify but Squid could not record it normally, so check the order in Shopify.