Gift Cards and Store Credit
Shoppers who can’t decide what to buy for someone still want to give your store. Without gift cards, they leave. And when an order goes wrong, a refund back to the card means the money leaves too, even when the customer would happily take credit instead.
Gift Cards and Store Credit sells gift cards as ordinary FluentCart products, emails each code once the order is paid, and lets buyers spend a card across several orders through FluentCart’s coupon field. Signed-in customers also get a store credit balance with its own history, and you can issue credit, adjust a balance or refund an order to store credit from one screen.
Turn On the Module
- Go to FluentCart → Stackless and switch on Gift Cards & Store Credit on the Stackless Dashboard. The switch saves at once.
- Open Settings on the card, check the options below and click Save changes.
The module needs FluentCart 2.3.1 or newer. On an older FluentCart it stays off and the admin says so.
- Code prefix: up to 8 letters or digits in front of new codes, such as GIFT.
- Gift cards expire after (months): 0 means never. Many countries set a minimum, so check yours. A card gets its expiry when it is issued, and store credit never expires.
- Apply a signed-in customer’s store credit at checkout by itself (they can remove it): on by default.
- Let buyers choose the day a gift card is emailed: on by default.
- Offer Refund to store credit on paid orders: on by default.
Sell a Gift Card
- Create a product in FluentCart with one option per card value, such as $25, $50 and $100.
- Choose Gift card from the product’s menu.
- Tick Sell this product as a gift card and click Save.
The screen lists each option with its Card value, which is that option’s price. Every unit bought issues one card worth one unit, in your store currency. A subscription option shows No card (subscription) and never issues a card. For a buyer-chosen amount, turn on Pay What You Like for the product: the amount the buyer pays becomes the card value.
What Buyers Fill In
Checkout shows Who is the gift card for? before the payment methods, once for each gift card line:
- Recipient email: leave it empty to get the card yourself.
- Recipient name and From. An empty From uses the buyer’s name.
- Message: up to 500 characters.
- Send on: a day from today up to 366 days ahead. Leave it empty to send the card as soon as the order is paid. This field only shows while the delivery-day setting is on.
Every unit on one line goes to the same recipient.
When the Code Is Sent
Cards are issued when FluentCart marks the order paid, and the order gets an activity note such as “2 gift cards issued.” A card with a delivery day is emailed at 9:00 in your store’s time zone on that day. The rest go out straight away.
The email is plain text from your site’s usual sender, to the recipient only. Its subject reads like “Alex sent you a gift card for Your Store”, and it holds the message, the value, the code, the expiry date if there is one, and a link to your shop. Codes look like GIFT-7KQM-4XPA-ZR2D-9HTN: four groups of letters and digits, without 0, O, 1, I or L, plus your prefix. Buyers can type a code in lower case, with spaces or without the hyphens.
On copies of the live store, gift card emails wait until you confirm the site is the live one.
Redeem a Gift Card
Recipients type the code into FluentCart’s coupon field. It works like a fixed discount worth what the card can still spend:
- Whatever isn’t spent stays on the card for the next order.
- Several cards can go on one order, beside your own coupons. Gift cards apply after every other coupon. The same card can’t go on one cart twice, however it’s typed.
- A card that covers the whole order brings the total to zero, and FluentCart completes the order without a payment.
- A card pays for products only: not shipping, subscriptions or other gift cards. Like every FluentCart discount, it applies before tax.
- Balances are kept in your store currency. In a cart priced in another currency, FluentCart converts the card’s value, and what’s spent is converted back at the order’s rate.
An unpaid order sets its gift card money aside, so the same balance can’t pay for two carts at once. The money is taken from the card when the order is paid, and given back if the payment fails, the order is canceled or it stays unpaid for a week. If a card no longer covers its share at payment, the order gets a “Gift card shortfall” note, so check it before you deliver.
A buyer whose card ran short while checking out sees “A gift card on this order no longer has enough balance. Check your order summary, then place the order again.”
Store Credit
Every signed-in customer can hold store credit. It never expires and only its owner can spend it. Customers see it under Store credit in their FluentCart account, with their balance and a History table of the last 30 entries.
- Spend it: with the auto-apply setting on, credit goes on the cart by itself and the customer can remove it. Otherwise the checkout summary shows a Use link with the amount, or the customer enters
STORE-CREDITin the coupon field. - Add a gift card to it: the customer enters a code under Add a gift card and clicks Add to my balance. The card’s whole balance moves onto the account.
- Show it elsewhere: put the
[gtfc_store_credit]shortcode on any page.
Guests can’t hold store credit. They can still spend gift cards.
Manage Cards and Balances
Open FluentCart → Gift cards. The list shows every gift card and store credit balance with its code, owner, balance, status and dates, plus the Outstanding balance that active cards and credit can still spend. Filter by Gift cards or Store credit, or search by code or email.
Store managers who can view FluentCart orders can see the screen. Changing a balance needs an administrator.
- Issue balance: choose A new gift card code or Store credit on a customer account, enter the amount, the email and a reason, and click Issue. Leave Email a new card to the recipient ticked to send the code. Store credit needs an existing customer account with that email.
- Adjust balance: open a card, enter a positive or negative amount with a reason, and click Adjust. A balance can’t go below zero.
- Disable card or Enable card: a disabled balance can’t be spent, and it stays on the card.
- Email the card again: sends the gift card email now.
Each card has a Ledger of every change: issued, spent, given back, adjusted, moved and refunded, with the order and the admin who made it. Reasons you type are kept there. The actions run as soon as you click them, without a confirmation step.
An order paid with gift cards, or one that bought them, also shows a Gift cards panel on FluentCart’s order screen.
Refunds and Cancellations
Money paid with a gift card or store credit goes back where it came from:
- Canceling an order gives back everything it took from cards and credit.
- A refund gives each card its share. The refund that empties the order gives back the rest.
Cards an order bought follow the order:
- A canceled or fully refunded order disables all its cards. Each keeps its balance, so you can enable it again.
- A refund of some units disables that many cards, those with the most left first.
- A refund by amount leaves the cards active and adds a note to the order. Disable a card yourself if the refund was for it.
Editing an Order in the Admin
FluentCart can’t recalculate a gift card or store credit discount in its order editor. So an order a card or credit paid for, even in part, can’t have its items, coupons or discounts changed there. Saving such an edit is refused with an explanation, and the order’s Gift cards panel says editing is locked. Status, addresses, notes and refunds still work.
To change what was bought, refund the order, which gives the card its share back, and create a new one. A new admin order can’t use a card code either: gift cards and store credit only work at checkout.
Refund to Store Credit
Use this when a customer would rather keep the money with you. On a paid order, open the Gift cards panel and choose Refund to store credit, or start from FluentCart → Gift cards. Enter the amount and a reason. It records a FluentCart refund, and no money goes back to the payment method:
- A signed-in customer’s order adds the amount to their store credit.
- A guest order gets a new gift card with the amount, emailed to the order’s address.
The amount can’t be more than what’s left to refund, and it has to fit within one payment on the order.
Limits
- Gift cards don’t pay for shipping, subscriptions, renewals or other gift cards.
- Gift card products get no Product Add-ons and no wholesale prices.
- One recipient per gift card line.
- The gift card email is plain text, and buyers don’t get a copy of it.
- Changing the expiry setting doesn’t change cards already issued, and a card moved onto store credit stops expiring.
- The privacy eraser removes names, emails and messages from cards but keeps balances and the ledger as accounting records.
- Turning the module off keeps every card, balance and ledger entry. Codes stop working until you turn it on again.
For Developers
Unpaid orders set gift card money aside for 24 hours against other carts. Change that with gtfc/gift_cards/hold_hours:
add_filter('gtfc/gift_cards/hold_hours', function () {
return 48;
});
[gtfc_store_credit] prints the customer’s store credit block, the same one the account page shows. See the hooks reference for the rest.