Beltoft Gift Cards for WooCommerce

Managing gift cards

• A dashboard showing how much has been issued, how much is still unused, and how much has been redeemed or expired.
• A searchable list of all gift cards where you can disable, delete or unlock cards.
• Create gift cards by hand, for example for a customer paying in the store, a promotion or a compensation.
• Every card records where it came from, so your accounting can tell paid cards from free ones.
• Cards expire after a number of days you choose (365 by default), or never.
• See on each order which gift cards it created and which it used.
• If an order is cancelled or refunded, the money goes back onto the gift card, including for partial refunds.

And also

• A REST API so other systems (accounting, POS, CRM) can read and manage gift cards.
• Optional integration with Loyalty Rewards for WooCommerce.
• Compatible with WooCommerce High-Performance Order Storage (HPOS).
• Translation-ready, with Portuguese (pt_PT) included.

Need more? The Pro add-on adds PDF gift cards, scheduled delivery, gifting any product, bulk generation, CSV import/export, BOGO promotions and reports.

How It Works

1. 01Create a product and choose “Gift card” as the product type.
2. 02A customer buys it, picks an amount and enters who it is for.
3. 03When the order is paid, the recipient gets an email with their code.
4. 04The recipient enters the code at checkout and the amount is deducted.
5. 05Any remaining balance stays on the card for next time.

For Developers

REST API

Base: https://your-store.example/wp-json/wc-bgcw/v1/ . Authenticate with WooCommerce REST API keys or a WordPress application password. Requires the manage_woocommerce capability.

• GET /gift-cards — List. Params: page, per_page (up to 100), search, status, source, orderby, order.
• POST /gift-cards — Create. Body: amount*, source* (paid_offline, promotion, compensation), recipient_name, recipient_email, sender_name, sender_email, message, expires_at, product_id, send_email (default true).
• GET /gift-cards/{id} — Single card.
• GET /gift-cards/code/{code} — Single card by code.
• PATCH /gift-cards/{id} — Update status (active/disabled), source, recipient/sender fields, message, expires_at, product_id.
• POST /gift-cards/{id}/adjust — Change balance. Body: amount (positive adds, negative deducts), note.
• GET /gift-cards/{id}/transactions — Transaction history.
• DELETE /gift-cards/{id}?force=true — Permanently delete a card.

Dates are ISO 8601 in UTC (for example 2032-01-31T00:00:00Z ). Every card includes source and is_paid , and orders that used a gift card record the paid and free amounts redeemed.

Example: curl -u ck_xxx:cs_xxx "https://your-store.example/wp-json/wc-bgcw/v1/gift-cards?source=promotion"

Hooks

Actions: bgcw_gift_card_created , bgcw_gift_card_deleted , bgcw_after_deduct_balance , bgcw_after_restore_balance , bgcw_my_account_card_actions , bgcw_product_form_after_recipient_fields .

Filters: bgcw_gift_card_creation_args , bgcw_add_to_cart_validation , bgcw_add_to_cart_data , bgcw_validate_amount_limits , bgcw_should_send_email_now , bgcw_email_template_html , bgcw_coupon_valid_for_gift_card , bgcw_refund_as_store_credit , bgcw_show_recipient_name_field , bgcw_show_recipient_email_field , bgcw_show_personal_message_field , bgcw_rest_permission .

Example — hide the Recipient Email field (the buyer’s email is used instead):

add_filter( 'bgcw_show_recipient_email_field', '__return_false' );

The email template can be overridden by copying templates/emails/gift-card-delivery.php to your theme’s woocommerce/emails/ folder.