Description
Tlloancy People’s Giftcard turns any WooCommerce product into a gift card your customers can personalise. Suggested amounts or a free amount, a recipient, a message, a delivery date. After payment the recipient gets a designed email with a code. The balance is spent in the normal coupon field, in as many orders as it takes.
No upsell, no “Pro” tab. Every feature below is in the free plugin.
For your customers
- Pick an amount from suggested buttons (25 / 50 / 100…) or type any amount, within the limits you set.
- Personalise: recipient name and email, a message up to 300 characters, and a “send on” date for birthdays and holidays.
- Spend it your way: enter the code in the coupon field of the classic checkout or the checkout block. Whatever is not spent stays on the card.
- Two ways to redeem, your choice: as a discount (like a coupon) or as prepaid balance (money already paid, which also covers shipping and taxes). See the FAQ.
- Check the balance with the
[tlpg_balance]shortcode, or in My Account → Gift cards. - Clear error messages: “This gift card has expired”, not “Coupon does not exist”.
For you
- Know what you owe: the Gift cards screen shows the total balance owed to customers.
- Full history of every card: issued, spent, restored, adjusted, voided, with the order behind each movement.
- Issue cards by hand for a gift, a goodwill gesture or a contest prize, and email them.
- Adjust, void, resend, change the expiry of any card.
- Expiry per store or per product (some countries set a minimum validity, so check your local rules).
- Export to CSV for your accountant.
- Search and filter by code, email, name, order, or status (active, scheduled, used, expired, voided).
- Optional code prefix, such as
SHOP-ABCD-2345-WXYZ.
Built so you can trust the balance
- The balance is reserved when the order is created, not when it is paid. Two orders cannot spend the same money.
- Cancelled, failed or refunded orders give the balance back, and unused cards bought on that order are voided. If the order is paid again, everything is put back.
- Every change is atomic and logged. The history always explains the balance.
- Cards are issued once. A repeated payment notification never creates a second card.
- Codes are 12 random characters from an alphabet without look-alike letters (no 0/O or 1/I), and lookups are rate-limited against guessing.
- Nothing is deleted when you uninstall, unless you tick the box. Your customers keep their balances.
- HPOS (high-performance order storage) and Cart and Checkout blocks are supported.
- Privacy: integrates with WordPress’ personal data export and erasure tools.
Works with
WooCommerce 8.2+ with the classic or the block checkout, block themes and classic themes, any payment gateway, any SMTP plugin (emails go through WooCommerce’s mailer).
Translations
Translate it on translate.wordpress.org. The text domain is tlloancy-peoples-giftcard.
Installation
- Install and activate WooCommerce, then Tlloancy People’s Giftcard.
- Edit a simple product, tick Gift card in the General tab, and publish.
- Optional: open WooCommerce → Gift cards → Settings to set suggested amounts, a validity period and the email subject.
- Optional: add
[tlpg_balance]to a page so customers can check their balance.
FAQ
Does it replace the WooCommerce coupon field?
No. The customer enters the gift card code in the normal coupon field. That works in the classic checkout and in the checkout block, with no extra step.
Does a gift card pay for shipping?
In “Prepaid balance” mode, yes: the card pays the whole order, shipping and taxes included. In “Discount” mode, a card is applied as a discount on the products, as a coupon is, so shipping is not covered.
Can a gift card buy another gift card?
No. Gift card products are excluded from what a card can pay for.
What is the difference between “Discount” and “Prepaid balance”?
Open WooCommerce → Gift cards → Settings → Gift card redemption.
- Discount (default, the behaviour of 1.0.0): the card lowers the price of the products like a coupon, so taxes are calculated on the lower price. Shipping is not covered.
- Prepaid balance: the card is money already paid. It is taken off the order total, shipping and taxes included, as a “Gift card payment” line. The taxable amount of the order is not reduced.
Example: a customer holds a 20 card and buys 25 of products. The card pays 20 and the customer pays 5. If the order is 15, the card pays 15 and 5 stays on the card.
Is tax charged when the card is sold, or when it is spent?
It depends on the voucher and on your country, so ask your accountant. In the EU, tax on a single-purpose voucher is generally due when it is sold, and tax on a multi-purpose voucher when it is spent. As a rule of thumb, “Discount” suits the first case, and “Prepaid balance” with the gift card product’s tax status set to “None” suits the second. The plugin does not decide this for you.
What happens to the code if the order is refunded or cancelled?
A card bought on that order is voided if it was not used. A balance that paid for that order goes back on its card. A card the merchant voided by hand stays voided.
A partial refund does not change a card balance by itself: the order gets a note, and you can use “Adjust” on the card.
An order was never paid. Is the balance stuck?
No. A balance reserved by an order that stays unpaid for 48 hours is given back. If that order is paid later, the balance is taken again. Change the delay with the tlpg_release_pending_after_hours filter.
Can I send a card on a future date?
Yes. The buyer picks a “send on” date, up to one year ahead. WP-Cron sends the email on that day. Cards waiting to be sent are listed under the “Scheduled” filter.
Where are the cards stored?
In two tables of your database (tlpg_cards and tlpg_ledger). They are kept when you delete the plugin unless you tick “Delete all gift cards and history” in the settings.
I used “Gift Card Amount” before. Will I lose my cards?
No. On activation, Tlloancy People’s Giftcard imports the cards, the product settings and the code prefix from that earlier plugin.
How do customers check a balance?
Put [tlpg_balance] on any page. Logged-in customers also see their cards in My Account → Gift cards.
Screenshots





Changelog
1.1.0
- New: “Gift card redemption” setting. “Prepaid balance” takes the card off the order total as a payment (shipping and taxes included) without lowering the taxable amount. “Discount” keeps the previous behaviour and stays the default.
- New: a partial refund on an order paid with a card adds an order note.
- Fixed: a balance reserved by an unpaid order stayed locked for good; it is now given back after 48 hours.
1.0.0
- First release of Tlloancy People’s Giftcard. Replaces “Gift Card Amount”, whose cards and settings are imported automatically.
- New: suggested amounts, recipient name, personal message, scheduled delivery, expiry, balance checker, My Account tab, manual issue, adjust/void/resend, CSV export, history of every movement, balance owed to customers, privacy tools.
- Fixed: a card could be spent again if the order total included tax; the order now takes at most the card balance.
- Fixed: two unpaid orders could spend the same balance; the balance is now reserved when the order is created.
- Fixed: a repeated payment notification could issue the same card twice.
- Fixed: add-to-cart failed on pages served from a cache because of a stale nonce.
- Fixed: removing the plugin deleted every customer balance; data is now kept unless you choose otherwise.
