Writing · 18 November 2026

The Gift Card Nobody Could Spend

Someone buys a Christmas gift card in early December. The payment goes through. The confirmation email arrives. They think the present is sorted. Then Boxing Day comes, or the first week of January, and the recipient tries to spend it. At checkout, nothing happens. There is no code, or the code is not accepted, or there is nowhere obvious to enter one.

That’s a made-up composite, not one named shop. But the pattern is real: the purchase worked, and the spend did not. Those are two different paths, and I see shops test only the first.

Christmas is a little over five weeks away. Black Friday is 27 November, nine days from now, and some of those gift cards will be bought in the sale. If you sell them, this is the week to test both ends: buying a card, and actually spending one.

The purchase can look fine

WooCommerce does not include gift cards in the core plugin. Shops add them with an extension. I have a plain setup guide for adding gift cards. That post is about getting the feature in place. This one is about proving that a card can be spent once it has been bought.

The buying side is the part most people check. They place a test order, see a paid confirmation, and move on. From the buyer’s point of view, that is enough. From the recipient’s point of view, it is not.

In the official WooCommerce Gift Cards extension, a unique code is created when the order is paid or marked Completed. You can look it up under Marketing > Gift Cards. Other tools have their own list. If the order is still on hold, or never reaches the status your tool watches, the recipient may have nothing to spend, even though the buyer has a confirmation.

A card payment that is actually paid will usually create the code even if the order is still in Processing. A bank transfer left on hold will not, because the order has not been paid yet. I wouldn’t assume the confirmation email and the gift card code are the same event. Check that the code exists.

Then the email has to arrive

A code that exists in the admin is not the same as a code the recipient can use.

If the sender chose a delivery date, the official extension creates the code when the order is paid, but leaves it inactive until the email is sent. Manually turning the code on early does not send that email. If the scheduled send never goes out, the recipient has no message, and in that setup the card may still be inactive.

Those emails depend on Action Scheduler, the same background queue WooCommerce uses for other tasks. If WP-Cron is disabled without another way to run scheduled tasks, or the server cannot complete loopback requests, deliveries can be delayed or fail. Immediate sends normally go out within a few minutes. A card set for Christmas morning is only as reliable as that queue.

What they meet at checkout

This is the half that gets missed.

The official extension puts a “Have a gift card?” form on the checkout page by default. Look at the page the customer actually uses, including the block checkout if you have switched to it. A missing field is enough on its own: the card exists, and nobody can enter it.

Gift cards and coupons are not the same thing. If the only box on the page is for a coupon, a gift card code may not belong there. Some shops use a coupon as a voucher instead of a gift card tool. That is a different setup, with usage limits, an email restriction that only the buyer can satisfy, or an expiry date that has already passed. I have written separately about testing sale codes before they go live. If your “gift card” is really a coupon, run those checks as well.

Even when the field is there and the code is right, the spend can still fail. The official extension will not let a customer use a gift card, or their gift card balance, to buy another gift card. Funds can also be held on a pending payment, so a second attempt looks as if the balance has gone. And if you have set the card to expire a certain number of days after delivery, check that January is still inside that window.

The check I run on both ends

I do this before the cards go out as presents, not after the first awkward message in January.

Buy a gift card yourself, with an email you control. Go all the way through checkout, the way a customer would. If you offer a delivery date, place one for immediate delivery and one scheduled a day or two ahead, so you are not waiting until Christmas to find out.

Check that a code actually exists. Look it up in your gift card list, not only in the order notes. Confirm the order status, and that the tool treats the order as paid or completed.

Check the email. Immediate delivery should arrive at the address you used. For a scheduled card, confirm the date on the code, and look at Tools > Scheduled Actions if you use the official extension, or the equivalent in your tool, to see that the send is queued.

Then try to spend it. Add an ordinary product to the cart, not another gift card. Use the checkout as a guest, and again while logged in. Enter the code in the gift card field, if there is one. Confirm the total changes, and that you can complete the order. Try a cart the card should cover, and one it should only part-cover, so you see the remainder payment as well.

Read the expiry, if you have one, and don’t test this on a real customer’s card. Use a purchase you placed yourself, or a staging site.

What I’d do this week

Nine days to Black Friday is enough time to run the test and fix what you find. It is not enough time if you leave it until people start buying cards as presents.

If a test card never appears in the list, fix the order status first. If the code exists but the email does not arrive, fix the scheduled send before you sell cards for Christmas morning. If checkout has nowhere to enter the code, that is the checkout, not the product. Don’t ship a buying flow you have not also tried to spend.

Wrap Up

A gift card that can be bought but cannot be spent is not a present, it is an awkward conversation in January. Before those cards go out, buy one yourself, check that a code exists and that the email arrives, then spend it at checkout as a guest and as a logged-in customer. Test both ends, not only the purchase.

If you want a hand testing the buying and the spending before Christmas, book a quick call and we’ll go through both together.

Written by Connie, an AI, from Neil Matthews’ notes, archive, and direction. Neil directed and edited this piece. He did not write these words. Augmented publishing by Neil Matthews.

← All posts

Need help with your WooCommerce store?

Get a quote