Refunds and cancellations
Sooner or later an order has to be undone — the customer changes their mind, an item is out of stock, a payment turns out to be fraudulent. TitanCart gives you two tools: a refund, which sends money back through the gateway the customer paid with, and a cancellation, which closes the order without moving any money. They are not interchangeable, and the order you do them in matters. This article explains what each one changes — status, stock, e-mails, downloads, points — what each payment gateway does behind the scenes, and what TitanCart leaves for you to do by hand.
The click-by-click walk-through of the Refund and Cancel buttons is in Managing orders sections 6 and 7. Returned goods are handled by the Returns system, covered in Returns and RMA.
1. Refund or cancel?
| Situation | Do this | Result |
|---|---|---|
| The order was never paid (Pending Payment, Failed, or an offline order you never received money for) | Cancel Order | Status Cancelled, customer e-mailed. No stock to return — it was never taken. |
| The order was paid and you want to undo all of it | Refund Order for the full amount | Money goes back, status becomes Refunded by itself, stock is restored, customer e-mailed. You do not need to cancel as well. |
| The order was paid and you want to give part of the money back but keep the order | Refund Order for a smaller amount | Money goes back, order status and stock untouched, no e-mail. You can do this more than once. |
| The card was authorised but not yet charged (order On Hold) | Void on the Payment card | The hold is released, nothing was ever charged, status Cancelled. See Capturing and voiding authorised payments. |
| The order was paid and you want it both refunded and cancelled | Refund first, then Cancel if you still want the Cancelled label | Cancelling never moves money, and once an order is Cancelled the Refund button is no longer offered. A full refund already closes the order as Refunded, so the extra step is rarely needed. |
2. What a refund does
The Refund Order button opens the Issue Refund window with the amount pre-filled to the order total and an optional reason. When you confirm, TitanCart asks the original gateway to send that amount back to the card or account the customer paid with, waits for its answer, and only then records the result. The refund appears as a new line on the order’s Payment card (type refund, with the gateway’s refund id) and as a system note on the order. If the gateway says no, nothing is recorded and its message is shown in the window.
| Full refund (the whole order total) | Partial refund | |
|---|---|---|
| Order status | Moves to Refunded automatically | Unchanged |
| Customer e-mail | Order status changed: Refunded (if that status still has Notify customer on) | None |
| Stock | Every item on the order returns to inventory, because Refunded is set to Restore (less anything a completed return already put back) | Unchanged |
| Digital download links | Deactivated, when Revoke download links on refund is on (the default) | Unchanged |
| Subscriptions started by the order | Cancelled | Unchanged |
| Lottery tickets bought on the order | Voided | Unchanged |
| Revenue Reports | The order drops out of the figures entirely | The order still counts at its full total |
| Further refunds | No longer possible — the payment is marked refunded | Allowed, until the refunds add up to the order total; the one that reaches it behaves as a full refund |
Each refund is checked against the order total, not against what is left to refund, so two partial refunds that together exceed the total are stopped only by the gateway. Keep an eye on the Payment card when refunding in instalments.
3. What TitanCart does not reverse
A refund moves money and updates the order. It does not undo everything the original purchase set in motion. After a refund, check and adjust these yourself where they apply:
- Loyalty points — points the customer earned on the order stay earned, and points they spent on it are not returned. Adjust the balance under Growth → Loyalty Rewards → Customer Balances.
- Gift card balance — if the order was paid partly with a gift card, the refund goes to the gateway payment only; the gift card is not re-credited.
- Coupon usage — a coupon used on the order still counts towards its usage limits.
- Affiliate commissions — a commission earned on the order is not reversed; edit it in the Affiliate Marketing extension.
- Marketplace vendor payouts — a full refund reverses each vendor’s transfer; a partial refund from the order page does not claw anything back from vendors.
- Refunds made somewhere else — a refund issued in the Stripe, PayPal or Square dashboard is not reported back to TitanCart, so the order keeps its status and stock. Always refund from the order page. Authorize.net is the exception: with its webhook set up, a refund or void made in the Merchant Interface is recorded on the order like one issued here.
4. What each gateway does
- Stripe — refunds the charge behind the order’s payment, in the order’s currency. Full or partial, immediately.
- PayPal and Venmo — refund the captured payment. Full or partial, immediately.
- Square — refunds the payment. Full or partial, immediately.
- Authorize.net — a settled charge is refunded normally. A charge that has not yet settled (settlement runs daily at Authorize.net) cannot be partially refunded: TitanCart tells you so and offers the alternative — refund the full amount, which it carries out as a void and records as a refund. Wait about a day for settlement if you need a partial amount.
Every gateway answers while the window is open, and its own message is shown if it declines (expired keys, an already-refunded charge, a payment disputed at the provider). After any refund it is worth confirming it in the provider’s dashboard; the gateway’s refund id on the Payment card finds it.
5. Orders paid offline
Orders paid by Check, Bank Transfer or Cash on Delivery have no electronic payment TitanCart can send money back through, so a refund on them is a record: TitanCart writes the refund line on the Payment card and applies the full-or-partial rules of section 2, and you return the money yourself — a replacement check, a bank transfer, cash. Two things to know:
- TitanCart marks an offline payment as received the moment you move the order into Processing or Completed (the Payment card’s charge line turns from pending to completed). Until then — an order still On Hold waiting for the check to clear — there is nothing to refund and the button answers “No completed payment found for this order.”; cancel such an order instead.
- Before TitanCart 0.2.69 that mark was never set, so the button gave that answer on every offline order. On an older version, refund by hand: add a Staff Note with the amount and reference, and for a full refund move the order to Refunded from the Update Status card with Notify customer via email ticked — that restores the stock and sends the Refunded e-mail.
6. Cancelling an order
Cancel Order is a status change and nothing more: the order moves to Cancelled, the customer receives the Cancelled e-mail, the move is logged in the order’s activity, and — because Cancelled is set to Restore — any stock the order had taken returns to inventory. It does not contact the payment gateway. Three consequences follow:
- Cancelling a paid order leaves the customer’s money with you. The Cancelled e-mail tells them a refund is on its way, so refund before you cancel — or simply refund in full and skip the cancel.
- Once an order is Cancelled, Refund Order is no longer shown on it. A paid order cancelled by mistake has to be refunded from your payment provider’s dashboard, which TitanCart will not know about.
- An order with an open card authorisation is the one case where cancelling does touch the gateway: TitanCart voids the authorisation first, so the card is never charged, then cancels.
TitanCart also cancels orders for you in two situations: Cancel unpaid orders automatically (Settings → General Settings → Order Automation) closes Pending Payment orders that never received a payment after the set number of hours, without e-mailing the customer; and the hourly payment check cancels an order whose card authorisation was declined, voided or expired at the gateway. Customers cannot cancel an order themselves from My Account; they contact you.
7. Refunds through Returns
When a customer sends goods back through the Returns system and you complete the return with the Refund action, TitanCart restores the returned items to stock and refunds their value through the same gateway, in the same way. The difference is bookkeeping: the result is written to the return’s history and the refund line appears on the Payment card, but the order’s status is not moved to Refunded even when the whole order came back — set that yourself if you want it. Returns need a completed electronic payment for the same reason as section 5. See Returns and RMA.
8. Records and reports
- The order’s Payment card is the ledger: every charge, authorisation, capture, refund and void with its amount, time and gateway id.
- The Order Activity timeline and system notes record who refunded or cancelled, when, and why.
- Revenue Reports exclude orders in Refunded, Cancelled and Failed. They do not subtract partial refunds — a partly refunded order counts at its full total.
- Outgoing webhooks (API & Integrations) fire
order.status_changedfor a full refund or a cancellation andorder.cancelledfor a cancellation; there is no separate refund event, and a partial refund sends nothing.
TitanCart Lite refunds through Stripe only (PayPal, Venmo, Square and Authorize.net are Pro gateways) and has no Returns system, loyalty points, gift cards or webhooks, so sections 3 and 7 do not arise.
What refunds and cancellations do — and don’t
A refund moves real money back through the original gateway, is recorded on the Payment card, and — only when it covers the whole order — sets the status to Refunded, restores stock, e-mails the customer, revokes downloads and cancels subscriptions. A partial refund changes nothing but the money and the record. A cancellation changes the status, e-mails the customer and restores stock, and never moves money (except voiding an uncharged authorisation). Neither touches loyalty points, gift-card balances, coupon counts or affiliate commissions, and a refund made in a provider’s dashboard is invisible to TitanCart. Offline payments are refunded by hand and recorded with a note and a status change.
Troubleshooting
- “No completed payment found for this order.” Either the order is paid offline and still On Hold — the payment is marked received when you move it to Processing (section 5) — or the card is only authorised — void or capture it from the Payment card first — or the payment was already fully refunded. On TitanCart older than 0.2.69 every offline order answers this; refund those by hand.
- The Refund button is missing. It is hidden on orders that are Pending Payment, Failed, Cancelled or Refunded. If you cancelled a paid order by mistake, refund it in your provider’s dashboard and add a Staff Note.
- I cancelled a paid order and the customer is asking for their money. Cancelling does not refund (section 6). Refund them in the provider’s dashboard and record it with a note.
- A partial refund did not e-mail the customer or restore stock. By design — only a full refund does. Tell the customer yourself, and adjust stock by hand on the product if some items came back.
- Authorize.net refused a partial refund. The charge has not settled yet. Wait for the daily settlement or refund the full amount, which TitanCart processes as a void.
- I refunded in Stripe / PayPal / Square and the order still says Processing. Those dashboards do not report back. Move the order to Refunded by hand (which restores stock) and add a note with the provider’s refund id.
- The refund was declined by the gateway. The message in the window is the provider’s own. Common causes: live keys replaced since the order was paid, the charge disputed or already refunded at the provider, or an amount above what the provider holds for that payment.
- The customer’s points balance still shows the points from a refunded order. Points are not reversed automatically; adjust them under Growth → Loyalty Rewards.
- Revenue Reports still include an order I partly refunded. Expected — only Refunded, Cancelled and Failed orders are excluded, and partial amounts are not subtracted.
See also
- Managing orders (the Sales screen) — the Refund and Cancel buttons step by step.
- Order statuses (built-in and custom) — the Restore inventory setting on Cancelled and Refunded.
- Capturing and voiding authorised payments — when the right move is Void rather than Refund.
- Returns and RMA — refunds, exchanges and store credit for goods sent back.
- Going live: switching gateways from test to live — finding a payment or refund in each provider’s dashboard.