Beltoft Gift Cards for WooCommerce

Description

Beltoft Gift Cards for WooCommerce lets you sell gift cards in your store. A customer picks an amount, writes who the card is for and adds a personal message. When the order is paid, the recipient gets an email with a unique gift card code. They type the code in the normal coupon field at checkout, and the amount is taken off their order. Anything left on the card can be used next time.

Features

Selling gift cards

• A “Gift card” product type with fixed amounts (for example $25, $50, $100), a custom amount within limits you set, or both.
• The customer adds the recipient’s name, email and a personal message.
• Shop pages show the price range, such as “From $25”.
• Works with page builders like Bricks and Elementor through the [bgcw_product_form] shortcode.

Delivery

• The gift card is emailed to the recipient in your store’s normal email design.
• A “Shop Now” button in the email opens your store with the gift card already applied.
• You decide whether cards are sent when an order is “Processing”, “Completed”, or both.

Using a gift card

• Codes work in the standard WooCommerce coupon field. No setup needed.
• Optionally show a separate “Apply Gift Card” field on the cart and checkout (or place it with the [bgcw_apply_field] shortcode).
• Works with both the classic checkout and the newer block checkout.
• Part of a card can be used now and the rest later.
• A card can be locked to one product, so it can only be used for that product.
• Regular coupons can’t be used to buy gift cards at a discount (you can turn this off).

For your customers

• A “Gift Cards” page in My Account with each card, its balance and its history.

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. Create a product and choose “Gift card” as the product type.
2. A customer buys it, picks an amount and enters who it is for.
3. When the order is paid, the recipient gets an email with their code.
4. The recipient enters the code at checkout and the amount is deducted.
5. Any 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.

Technical details