How to Track Lemon Squeezy Partial Refunds
A Lemon Squeezy refund can cover the whole order or only part of it. SaneSales reads both from the Lemon Squeezy API and adjusts your revenue for you. Here is what you see in the app, how each kind of refund is counted, and how Stripe and Gumroad differ.
See a Refund in SaneSales
- 1 Connect Lemon Squeezy in Settings with your API key. The Lemon Squeezy guide shows where to find it.
- 2 Open Orders. A refunded order stays in the list. Its amount shows the original total, in amber.
- 3 Open the order. A Refunded Amount row shows what went back to the buyer. A full refund also shows a Refunded row with the date.
- 4 Go to Dashboard. Revenue totals, charts, widgets and the menu bar count what you kept, not what you charged.
Free and open source under the MIT License. Every feature stays unlocked. Donate if you want to support it.
How Lemon Squeezy Refunds Are Counted
SaneSales reads three things from each Lemon Squeezy order: its status, the refunded amount and the refund date.
- • Full refund. The order's status is Refunded, and the whole order leaves your revenue. It stays in the order list so you can still find it.
- • Partial refund, status still paid. Revenue counts the order total minus the refunded amount. A $50 order with $20 refunded adds $30.
- • Partial refund marked partial_refund. Lemon Squeezy's API docs list a partial_refund status. SaneSales doesn't recognize that status yet. The order shows as Unknown, and the whole order drops out of revenue, not just the refunded part. If you see Unknown next to a Refunded Amount row, this is why.
How Stripe and Gumroad Compare
- • Stripe. SaneSales reads the refunded amount on each charge. A full refund leaves revenue. A partial refund is subtracted, the same as Lemon Squeezy. Stripe refunds show no refund date in SaneSales, and disputes are not read.
- • Gumroad. SaneSales reads only Gumroad's yes-or-no refunded flag. A fully refunded sale leaves revenue. A partial refund isn't subtracted, so that sale still counts at its full price.
Refunds in a CSV Export
The CSV export keeps refunded orders. The Status column says refunded for a full refund, or unknown for the partial_refund case above. The Total column holds the original order total, not the amount you kept. The Refunded column holds a refund date, which only Lemon Squeezy full refunds supply.
The CSV has no refunded-amount column, so partial refunds don't show up in it. For partial refunds, use the totals in the app or your provider's own report.
Questions
Does SaneSales subtract Lemon Squeezy partial refunds?
Yes, when the order's status stays paid: revenue counts the order total minus the refunded amount. An order that Lemon Squeezy marks partial_refund shows as Unknown, and the whole order drops out of revenue.
Does SaneSales subtract Gumroad partial refunds?
No. It reads only whether a Gumroad sale is refunded. A full refund leaves revenue. A partial refund doesn't change it, so the sale counts at its full price.
Why is the Refunded column blank for a refunded Stripe order?
SaneSales doesn't get a refund date from Stripe charges. The column fills only when Lemon Squeezy sends a refund date, which it does for full refunds.