Refund Clover Payments from WooCommerce

Refunding a Clover-processed payment from WooCommerce should be one click — and with a properly-configured Clover gateway, it is. But there's a small list of behaviours worth understanding before you process a refund for the first time, especially around partial refunds, voided-vs-refunded distinctions, settlement timing, and how the WooCommerce order status changes when the refund completes.

Two types of refund (void vs refund)

Clover (like every card processor) handles refunds differently depending on whether the original transaction has settled yet.

• Void — the original charge has authorised but not settled. Voiding cancels the auth so nothing ever hits the customer's card. Voids are instant and free. Typically possible only on the same business day as the charge.
• Refund — the original charge has settled. Money has moved. Refunding pushes a reverse transaction back to the customer's card, which takes 3–10 business days to appear on their statement depending on their issuer.

CloverWoo decides which one to issue automatically based on the transaction state. From the WooCommerce admin's perspective, both look identical — you click 'Refund' and the right thing happens.

Step 1: Refund a full order

Open the order in WooCommerce → Orders → click into the order → click 'Refund' at the bottom of the line items. Enter the full order total as the refund amount. Check 'Refund via Clover' (the default if your gateway is configured). Click 'Refund $X via Clover'.

Behind the scenes CloverWoo calls Clover's refund API with the original transaction ID. Clover validates, processes, and returns a refund transaction ID. CloverWoo stores that ID against the WooCommerce order, updates the order status to 'Refunded', and adds a private order note documenting the refund with the Clover refund ID.

Step 2: Partial refunds

Same flow, just enter a smaller amount in the refund dialog. For an order that totaled $89 where you want to refund $25 (e.g., one returned item out of three), enter $25 in the refund amount field. Click refund. WooCommerce keeps the order in 'Processing' or 'Completed' status (not 'Refunded' — that's only for full refunds), but tracks the $25 partial refund on the order page.

You can issue multiple partial refunds against the same order, up to the original order total. The order goes to 'Refunded' status when the sum of partial refunds equals the order total.

Step 3: Refund a specific line item

Instead of entering a manual amount, click the 'Refund' link next to a specific line item. WooCommerce calculates the line item's contribution to the order (item subtotal + tax + applicable shipping) and pre-fills the refund amount. Click refund. The line item is marked as refunded in the order detail.

This is the cleanest way to handle returns where the customer keeps part of the order — the inventory restoration, refund amount, and order narrative all stay in lockstep.

Step 4: Restock or not?

When you refund a line item, WooCommerce asks whether to restock it. If you check that box, the WooCommerce stock count increments AND (with CloverWoo) the Clover inventory count increments to match. If the item is damaged/discarded, leave it unchecked and only the financial side reverses.

If you forget to restock during refund processing, you can adjust the Clover stock manually in the Clover Inventory app — the next webhook will sync the new count back to WooCommerce.

When refunds fail

Refund failures are rare but they happen. The common causes:

• Refund amount exceeds remaining refundable balance. You can't refund more than the original charge minus prior refunds. Check the order's refund history first.
• Original transaction not found. Usually means the original charge was voided already, or you're looking at an order whose payment didn't actually clear (look at the order's payment status — sometimes payment failed but the order was manually marked Processing).
• Clover account not in good standing. Rare, but if your Clover merchant account has a hold or restriction, refunds can be blocked. Clover support will tell you why.
• Refund window exceeded. Clover allows refunds for 180 days from the original transaction date. After that the refund must be issued as a manual credit (ACH or check), outside the card rails.

Settlement and statement timing

Card refunds aren't instant from the customer's perspective. The refund transaction posts immediately on Clover's side, but the customer's bank decides when to credit it back to the available balance. Typical timing:

• Visa / Mastercard: 3-5 business days for the credit to appear on a statement.
• Amex: 5-7 business days typically.
• Some debit cards: up to 10 business days.
• Voided transactions (not refunded): the auth simply drops off the customer's pending list within 1-3 business days, depending on the issuer.

If a customer says 'I haven't received my refund' within the first 3 business days, the answer is almost always 'wait — it's normal'. After 7-10 business days, escalate to Clover support with the refund transaction ID for investigation.

Edge cases worth knowing

Subscription renewal refunds

Refunding a subscription renewal charges the refund through normally, but does NOT cancel the underlying subscription. If the customer wants both the renewal refunded and the subscription cancelled, you have to do both actions explicitly — refund the renewal in the order page, then cancel the subscription in WooCommerce Subscriptions.

Tipped transactions

If the original charge included a tip (CloverWoo's tipping at checkout), the tip is part of the total transaction amount. Refunding the full transaction refunds the tip too. Partial refunds default to refunding pro-rata, but you can specify whether the tip is included.

Multi-currency stores

Refunds are denominated in the original transaction currency, not the current display currency. A charge captured in EUR is refunded in EUR, even if your WooCommerce store now displays prices in USD. Clover handles the currency at the gateway level — no manual conversion needed.

Audit trail

Every refund through CloverWoo writes a private note to the WooCommerce order including the Clover refund transaction ID, amount, timestamp, and the admin user who initiated it. That note is permanent and is your audit trail. The same refund appears in Clover's transactions list and in the Clover settlement report when funds move.

Next steps

• Payment gateway setup: Clover payment gateway for WooCommerce.
• When payments fail: Clover payment failure decode.
• Subscriptions handling: WooCommerce Subscriptions with Clover.