Agent refunds
In the app: Refund Hub → Agent Refunds
Needs the 'Review Agent Refunds' permission.
Refunds that teammates submit themselves with the manual refund form on a ticket. This tab is where a second person checks the ones that need QA before any money moves, and where every submitted refund is on record.
Agent Refunds
A teammate submits a refund from a ticket with the "Manual refund" form. Which offers the form has, and which of them need QA, is set under Settings → Refund Hub in "Manual refund policies".
- An offer that does not need QA is refunded in Shopify while the form is being submitted. It goes straight to "History" here, as "Auto refunded" or, when Shopify did not complete it, as "Shopify failed" or "Unconfirmed".
- An offer marked "Needs QA" is held. It waits in the "Queue" here until a reviewer approves or rejects it; nothing is paid before that.
- A refund whose amount was raised more than 0.01 above what the offer would refund always waits for QA, also when the offer itself does not need it.
The line under the title counts the refunds in the current view: "3 awaiting QA." or "41 settled.". The queue count includes approved refunds whose payment is still running, and the settled count includes failed, rejected and unconfirmed refunds.
The tab is only shown to, and can only be opened by, people with the 'Review Agent Refunds' permission. Submitting the form needs both the 'Process Refunds' and the 'Edit Subject and Dismiss Bounces' permission. A teammate whose access is limited to certain stores only sees those stores' refunds.
Queue and History
- "Queue": refunds waiting for QA, and approved or retried refunds whose payment in Shopify is still running. Most recently submitted first.
- "History": every other submitted refund: paid without QA, approved, rejected, failed and unconfirmed. Most recently submitted first.
- Store filter ("All stores"): shows one store's refunds. The choice is shared with the other Refund Hub tabs.
- "Filter by agent name...": type part of a name and press Enter or click "Filter" to show only refunds submitted under that agent name. Capitals do not matter. The name is the one on the card: the submitter's own name, or the name they typed in the form when submitting for someone else is allowed. Empty the field and filter again to show everyone.
- Refresh (the round arrow) reloads the list. The list does not reload on a timer; a card that shows "Refund pending" updates by itself when its payment finishes.
- The list shows 50 refunds; "Load more" adds the next 50.
What a refund card shows
The store and order number, the agent name it was submitted under and when, the refund amount, and a status label:
- "Awaiting QA": waiting for a reviewer.
- "Refund pending": approved; Shopify is processing the payment. The card updates by itself.
- "Auto refunded": the offer did not need QA and Shopify accepted the refund on submit.
- "QA passed": a reviewer approved it and Shopify accepted the refund.
- "Rejected": a reviewer flagged an issue. Nothing was paid.
- "Refund failed" (in the queue): Shopify refused the refund after a reviewer approved it, so nothing was paid. The refund is back with the reviewer and the reason is on the card.
- "Shopify failed" (in History): Shopify refused the refund, or Shopify accepted it and the payment provider later failed to pay some or all of it. The reason is on the card.
- "Unconfirmed": Shopify did not confirm the refund, so the money may or may not have moved. The reason is on the card.
"Raised above offer (…)" means the agent entered an amount more than 0.01 above what the chosen offer gives; the amount in brackets is what the offer would have refunded.
An accepted refund can still be waiting for the payment provider to pay it out. A later payout failure changes its status to "Shopify failed".
Below that are the details from the form: "Offer", "Reason", "Product type", "Product category", "Payment method", "Supplier refund", "Dispute" and, when filled in, "Return location". "Items:" lists the products, "Notes:" the agent's notes, and "QA note" what the reviewer wrote with who wrote it. "View conversation" opens the ticket.
QA passed
"QA passed" opens "Approve this refund?", which states the amount, the order and the store. "Approve and refund" confirms.
Squid checks once more that the amount is still within what the order allows; if it is not, the approval is refused with the reason and the refund keeps waiting. Otherwise Squid creates the refund in Shopify in the background, for the items chosen in the form. The card shows "Refund pending" and leaves the queue once Shopify confirms; it is then in "History" as "QA passed", and is added to the refund log when that is switched on under Settings → Refund Hub. The refund cannot be undone from Squid.
Approving needs the 'Review Agent Refunds' permission only. 'Process Refunds' is not needed to approve.
You cannot approve a refund you submitted yourself: the button is disabled with "You submitted this refund, so someone else has to approve it." This holds for every role, owners and admins included. You can still flag an issue on your own refund.
When Shopify refuses the refund, the card stays in the queue as "Refund failed" with the reason, and the button becomes "Retry refund". A retry asks for the confirmation again, repeats the check and sends the same request again. When Shopify's answer is unclear, the refund moves to "History" as "Unconfirmed" instead (see "Retry with Shopify").
Flag issue
"Flag issue" opens "Flag an issue". Describe what is wrong; the text is required. "Reject refund" rejects the refund.
Nothing is sent to Shopify and no money moves. The refund moves to "History" as "Rejected" with your note and your email address, and the rejection is added to the refund log when that is switched on. Squid does not notify the agent who submitted it; the note is only on this tab. A rejection cannot be reversed: a corrected refund has to be submitted again with the form.
Retry with Shopify
Needs the 'Process Refunds' permission.
An "Unconfirmed" refund shows "Retry with Shopify". There is no confirmation step: the retry starts when you click. Check the order in Shopify first. The retry runs in the background: it first looks in Shopify for the refund and then reuses the original request. If it can identify the earlier refund, it records that refund instead of sending another. If Shopify confirms there was no earlier refund, it sends the original request. If the check fails or the result is unclear, it stays "Unconfirmed" and sends nothing new. If Shopify then refuses it outright, the refund becomes "Shopify failed" and nothing was paid.
Do not submit the form again for an order with an unconfirmed refund: a new submission for that order is refused until this one is settled. The same holds while a refund on the order shows "Refund pending".
A stuck refund is shown as "Unconfirmed" when the list or card is next read, so it can be retried. The waiting limit defaults to 10 minutes; an active refund being processed is skipped until its processing finishes.
The retry needs the 'Process Refunds' permission, on top of 'Review Agent Refunds' to open the tab.