Helm › Helm University › Track 6 › Lesson 6.5
Lesson 6.5You can approve, offer part of it, or decline with a reason. What you cannot do is nothing, because the clock runs whether you answer or not.
Prefer to listen? This is the same lesson, word for word. The text below is the transcript.
This lesson prepares you to: Respond to a refund claim you believe is wrong, inside the window, with evidence that counts.
When a buyer opens a refund claim you can approve it, you can offer part of it, or you can decline it with a reason. Most sellers only think of the first and the last, and the middle one is the one that ends most disputes.
| Response | What happens |
|---|---|
| Approve | The refund is processed. The order's refund state becomes full. |
| Offer a partial | You name an amount and the buyer gets 48 hours to accept or refuse it. |
| Decline | You give a reason, up to 500 characters. The claim is marked declined and the order goes back to having no open refund. |
A partial is worth reaching for more often than sellers do. A buyer who says the colour was not what they expected usually does not want their money back so much as they want to stop feeling ignored. Twenty percent and a straight answer closes it.
These are the windows, and they are counted in the code, not by anyone's goodwill.
| What | You have |
|---|---|
| A cancellation request, before it ships | 24 hours |
| A refund claim on an order under $100 | 2 business days |
| A refund claim on an order of $100 or more | 4 business days |
| The buyer, to answer a partial offer you made | 48 hours |
Business days mean business days. Weekends do not count, and neither do New Year's Day, Juneteenth, Independence Day, Veterans Day or Christmas Day. Those five dates are written into the calculation. So a claim that lands on the Friday before a long weekend gives you more real time than the number suggests.
The buyer's own claim window is 30 days from delivery. If nothing was ever marked delivered, it is 30 days from purchase instead.
Not answering is not neutral. The window expires and the claim proceeds without your side of it. You have given up the partial offer, the decline, and any chance to put evidence in front of the decision.
Worse, an open refund freezes the payout on that order. It stays frozen while the claim is open, and the freeze is long: the code holds it for up to a year. A refund always beats a payout. So the order you are ignoring is also the money you are not being paid.
Evidence you created before the dispute existed. Nothing you write after the claim opens carries the same weight as something timestamped before it.
What does not work: arguing about the buyer's motives, restating your policy, or explaining that you are a small business. None of it is evidence about this order.
A declined claim clears the refund state and unfreezes the payout, but every refund that does complete counts toward your refund rate, and the rate has no fault field. There is no category for "refunded but it was not my fault." Above 5% you drop back to the introductory payout hold no matter how many orders you have shipped. That is covered in track 9.
One line in the refund code is a comment rather than logic, and it is worth reading anyway. It notes that a seller should offer in good faith, and points at the rule Whatnot uses. The reason is not sentiment. A seller who fights every claim generates more completed refunds, not fewer, because unresolved claims resolve against them. The refund rate is the thing that eventually costs you, and you control it mostly by how quickly you settle the small ones.
Verified in src/services/refunds.js:
CANCEL_RESPOND_HOURS = 24,
REFUND_SMALL_ORDER_CENTS = 10000,
REFUND_RESPOND_DAYS_SMALL = 2,
REFUND_RESPOND_DAYS_LARGE = 4,
BUYER_OFFER_RESPOND_HOURS = 48,
CLAIM_DAYS_FROM_DELIVERY = 30. Holidays excluded from business days
are 01-01, 06-19, 07-04, 11-11 and 12-25. Open refund states are requested,
offered, approved and processing. A decline reason is stored up to 500 characters.
The payout freeze on an open refund is set to 365 days.
That is track 6 complete. Every lesson in Refunds and Returns is now written.