[Skip to main content](#vessel-content)

#  Gift cards for Events Booking plugin

Details    Written by: Administrator    Category: [Pther extensions](/support/documentation/hikashop/other-extensions)     Published: 14 November 2026     Hits: 36

This plugin lets the gift cards of your shop pay the registrations to your Events Booking events. Each card is a HikaShop coupon; the plugin gives it an Events Booking voucher with the same code and keeps the two in line, so a card spent on one side is spent on the other. Your customer has one code, and one link, for the shop and for the events.

It needs HikaShop and Events Booking (by Joomdonation) on the same Joomla site. The gift cards are usually made by HikaSerial, but the plugin also works with HikaShop coupons you create yourself, recognised by the beginning of their code.

## Installation

The steps below set up the gift cards with HikaSerial, Events Booking, then the plugin. If your gift cards already work in your shop, check them against steps 1 to 3 and go on to step 4.

### 1) The model coupon, in HikaShop

HikaSerial makes each card by copying a coupon used as a model. In HikaShop, go to Marketing &gt; Coupons and discounts, click New and set:

- **Code**: any code, for example GIFTCARD\_MODEL. The cards get their own code, the serial.
- **Type**: Coupons.
- **Flat amount**: an amount, for example 50, in the currency the cards are sold in (EUR for a shop in euros). With "Variable discount" at 100 in the generator (step 2), each card is worth the price paid for it instead. Leave **Percentage** at 0: a percentage coupon cannot become an Events Booking voucher.
- **Published**: No. The model must not be usable as it is; HikaSerial publishes each card it makes.
- **Quota** (in Discount features): 1, so that each card pays one purchase. A Quota of 1 is also what the "Shared balance" mode needs (see Configuration).
- Leave the restrictions empty (dates, products, categories, users): a card has to be accepted by any order and any event. The validity of each card is set in the generator.

![The model coupon in HikaShop: code GIFTCARD&#95;MODEL, type Coupons, flat amount 50 euros, not published, and a Quota of 1 in the Discount features](/images/doc/plugins/hikashop-eventsbooking/hikashop_eventsbooking_model_coupon.png)

### 2) The gift certificate generator, in HikaSerial

Go to Components &gt; HikaSerial &gt; Plugins, open "Coupon - HikaSerial Generator plugin" and click New:

- **Name**: Gift certificate, for example. **Published**: Yes.
- **Discount coupon id**: click the pencil and choose the model coupon of step 1.
- **Variable discount**: 100 to give each card the value of the price paid for it (a card product sold 75 € makes a 75 € card), or empty to give every card the model's amount. **Variable discount with tax**: Yes to take the price with taxes.
- **Discount validity period**: how long a card can be used after its purchase, for example 1 Years. It becomes the card's end date, in the shop and in Events Booking.
- **Restrict the coupon to the customer** (shown as DISCOUNT\_CUSTOMER\_ASSIGN in HikaSerial 6.1.1 and older): No for gift cards, which are given to someone else. With Yes, the card is limited to the buyer's account in the shop and in Events Booking.
- **Serial size** and **Serial format**: the code of the cards, for example 12 characters of \[a-zA-Z0-9\]{size}. Keep it to **20 characters at most**: Events Booking stores no longer code, and a longer card is not synchronised.

![The Gift certificate generator in HikaSerial: published, the model coupon chosen, a variable discount of 100 %, a validity of 1 year, not restricted to the customer, serials of 12 letters and digits](/images/doc/plugins/hikashop-eventsbooking/hikashop_eventsbooking_generator.png)

### 3) The pack and the gift card product

- In HikaSerial &gt; Packs, click New: a **Name** (Gift cards), **Pack Data** "No pack data provider", **Pack Generator** the generator of step 2, **Published** Yes. Set **Consumable serials** to Yes if your staff consumes the cards on site with HikaSerial's Consume module or page.
- Edit your gift card product in HikaShop and add the pack to it, in the **Serials** block HikaSerial adds to the product page: click Add, choose the pack, click "Add packs" and keep a quantity of 1. Each card bought then gets a serial, and the serial gets its coupon, once the order is confirmed.
- The serial reaches the customer in the order's email, or in an email or PDF of its own with the AttachSerial or PDFSerial plugins of HikaSerial. That is where the card's link goes (step 7).

![The Gift cards pack in HikaSerial: no pack data provider, the coupongen Gift certificate generator, published, with consumable serials](/images/doc/plugins/hikashop-eventsbooking/hikashop_eventsbooking_pack.png)

![The Serials block of the Gift card product in HikaShop, with the Gift cards pack and a quantity of 1](/images/doc/plugins/hikashop-eventsbooking/hikashop_eventsbooking_product_pack.png)

### 4) Events Booking

- In Events Booking &gt; Configuration, General tab, check in "Amount &amp; Currency" that the **Currency** is the currency of your gift cards (EUR for cards sold in euros). Cards in another currency are not synchronised.
- Check that **Enable Coupon** is on, in the same tab under "Registration Settings" for all the events, or in the options of each event the cards should pay. Without it, the registration form has no coupon field.
- There is nothing to create in Events Booking &gt; Coupons: the plugin makes the vouchers itself.

![The General tab of the Events Booking configuration: the currency set to Euro with the symbol, and Enable Coupon set to Yes](/images/doc/plugins/hikashop-eventsbooking/hikashop_eventsbooking_eb_configuration.png)

### 5) The plugin

- Download the plugin from your account on our website and install it with System &gt; Install &gt; Extensions.
- Go to System &gt; Plugins, search for "Events Booking" and open **System - HikaShop gift cards for Events Booking**.
- Choose the cards to synchronise and the events they are good for (see Configuration below; the default values suit HikaSerial gift cards usable once on any event), set **Status** to Enabled and save.

### 6) The page the card's link opens

Optional, but it gives your customers one link for both sides. Create an article, for example "Your gift card", with a few words, the tag {hikashop\_eventsbooking\_card} that shows the card's value and end date, and the modules they need to spend it: the Events Booking "Upcoming events" module and a HikaShop products module, loaded in the article or shown on its menu item. Give it a menu item, for example with the alias gift-card.

### 7) The link in the card's email or PDF

In the email or PDF that sends the serial, add the link to that page with the parameter of the plugin and the tag of the serial, for example https://www.example.com/gift-card?card={serial.serial\_data}. A QR code of the same link lets the card be scanned with a phone. Any page of your site works with ?card=, so a link to your home page or your events list does as well.

### 8) Check it

Buy a card on your shop and confirm the order, open its link, then register to an event with it: the amount is deducted in the registration form. The card now shows "has already been used" in the shop, and Events Booking &gt; Coupons lists its voucher with the note "HikaShop coupon #" and the coupon's number: with a Quota of 1, Times 1 and Used 1 once the card is spent.

![Events Booking Coupons list: the voucher of a 50 euros gift card, 25 euros used for a registration, Times 1, Used 1, valid until November 2027, with the note HikaShop coupon #2](/images/doc/plugins/hikashop-eventsbooking/hikashop_eventsbooking_eb_coupons.png)

## Configuration

The settings are in System &gt; Plugins, **System - HikaShop gift cards for Events Booking**, in this order.

![The settings of the plugin: cards to synchronise, HikaSerial packs, code prefixes, use of a card, Events Booking categories, registrations, applies to, access level, link parameter, card held during an online payment, serial status and log](/images/doc/plugins/hikashop-eventsbooking/hikashop_eventsbooking_settings.png)

- **Cards to synchronise** (default: HikaSerial gift cards): which HikaShop coupons get an Events Booking voucher.
- "HikaSerial gift cards": the coupons of the serials of the packs chosen below. The choice for cards sold with HikaSerial.
- "Coupons with a code prefix": the HikaShop coupons whose code starts with one of the prefixes below, for cards you create by hand or with another tool.
- "Both": either.

Whatever the choice, only coupons with a fixed amount (not a percentage), in the currency of Events Booking and with a code of 20 characters at most become vouchers. Any other coupon of the shop is left alone, and Events Booking's own coupons too.
- **HikaSerial packs** (shown with "HikaSerial gift cards" and "Both"): the packs whose cards are synchronised. The packs using the coupongen generator come first, marked "(coupongen)". Left empty, every pack using the coupongen generator. Choose your gift card pack when you have other coupongen packs whose coupons must stay in the shop only (a discount coupon given with a product, for instance).
- **Code prefixes** (shown with "Coupons with a code prefix" and "Both"): the beginnings of the coupon codes to synchronise, separated by commas, for example GIFT,CARD for GIFT-2026-001 or CARD75. Upper and lower case are the same. Left empty, no coupon is taken by its prefix.
- **Use of a card** (default: Single use):
- "Single use": a card is spent at its first purchase, in the shop or for an event, whatever its amount, and what the purchase does not use is lost, as with any HikaShop coupon.
- "Shared balance": a card with a Quota of 1 keeps what a purchase did not spend, for the shop and for the events alike, until nothing is left. In the shop it needs the Multi Coupon plugin (see "Shared balance" below). Cards with another Quota stay single use.

You can change it at any time: the vouchers follow at the next use of each card.
- **Events Booking categories** (default: empty): the event categories the cards can pay, from the categories of Events Booking. Left empty, all the events. Hold Ctrl (Cmd on a Mac) to choose several.
- **Registrations** (default: Individual and group): the kind of registration the cards can pay, "Individual and group", "Individual only" or "Group only".
- **Applies to** (default: Each registration): for a group registration, "Each registration" deducts the card once from the whole registration, "Each member" once for each member of the group. Keep "Each registration" for gift cards, so that a 50 € card is worth 50 € whatever the size of the group.
- **Access level** (default: Public): who can use the cards in Events Booking. Public for anyone, Registered for the visitors logged in only.
- **Link parameter** (default: card): the name of the parameter that carries the card's code in its link, card for https://www.example.com/gift-card?card=CODE. Change it only if another extension of your site already uses that name. Left empty, the links are turned off and the card has to be typed.
- **Card held during an online payment (minutes)** (default: 30): while an event registration paid with a card waits for its online payment (PayPal, Stripe...), the card is refused in the shop for this many minutes, so it cannot pay twice. A payment that comes in later still spends the card. 0 turns the hold off.
- **Update the serial's status** (default: Yes): the HikaSerial serial of a card goes to the "used" status when the card is spent, in the shop or on an event, and back to "assigned" when that purchase is cancelled. Your serials list then shows which cards are spent, and a spent card can no longer be consumed with HikaSerial's Consume module. No leaves the serials as they are.
- **Log** (default: No): writes the vouchers made and the coupons refused, and why, in the logs of HikaShop (System &gt; Logs in the HikaShop menu), under the source "Events Booking gift cards". Turn it on to find why a card is not accepted, and off once it works.

## How a card is used

- The card's uses are counted by its HikaShop coupon (its Quota and its number of times used). Its Events Booking voucher, with the same code, has the same number of uses allowed and made: with a Quota of 1, the card is good for one purchase, in the shop or for an event. In single use mode, a HikaSerial gift card whose coupon has no Quota is also good for one purchase.
- The voucher is made the first time the card is typed or opened on the events side, so it appears in Events Booking &gt; Coupons from then on, with the note "HikaShop coupon #" and the coupon's number. The cards sold before the plugin was installed are handled the same way: there is nothing to import.
- Spent in the shop: the coupon is counted as used when the order is created, before its payment, as HikaShop does for every coupon. An order left unpaid keeps the card until it is cancelled.
- Spent on an event: the card counts as used in the shop when Events Booking counts it, at once for an offline payment or a registration the card covers in full, at the payment for an online payment.
- Consumed on site: consuming the card's serial with HikaSerial's Consume module or page counts one use, so the card is spent in the shop and on events. A card already spent cannot be consumed.
- Cancelled purchase: when the order paid with the card is cancelled or refunded (the statuses of "Cancelled order statuses" in the HikaShop configuration), or the registration is cancelled or deleted, the card is given back on both sides. The payment made in addition to the card is refunded as usual, with your payment provider.
- Cancelled card: when the card's own order is cancelled or refunded, HikaSerial unpublishes its coupon and the plugin its voucher. Unpublishing or deleting the coupon, or changing its amount or dates, is followed by the voucher.

![The payment part of an Events Booking registration form: the gift card's code in the Coupon field, an amount of 15 euros, a discount of 15 euros and nothing left to pay](/images/doc/plugins/hikashop-eventsbooking/hikashop_eventsbooking_registration.png)

## Shared balance

- The card's balance is the amount of its HikaShop coupon. Each purchase lowers it, and the Events Booking voucher keeps the card's first amount with a used amount that leaves it the same balance (Events Booking &gt; Coupons shows for instance "40.00 / 100.00 Used"). A card with nothing left is spent on both sides; its coupon then shows an amount of 0.
- On an event: Events Booking deducts what is left on the card, up to the registration's price, and the coupon is lowered by that amount.
- In the shop: the remaining balance needs the Multi Coupon plugin ( https://www.hikashop.com/marketplace/product/164-multi-coupon-checkout.html ), which lowers the coupon's amount when an order costs less than the card. Without it, HikaShop counts a coupon as used at its first order, so a shop order spends the whole card. Multi Coupon compares the card with the order's total without taxes.
- Consumed on site: the Consume module spends what is left on the card.
- Cancelled purchase: the amount that order or registration took from the card is given back on both sides, also for the shop's orders, which Multi Coupon alone does not do.
- You can switch from one mode to the other at any time: the vouchers follow at the next use of each card, and a cancellation always gives back what the purchase took.

## The card's link

- Any page of your site opened with ?card= and the card's code (or the parameter you chose) checks the card. A valid card is kept for the visit, put in the shop's cart (as soon as HikaShop accepts it there, if the cart is empty; a coupon the customer already put in the cart is left as it is) and filled in the coupon field of the Events Booking registration forms; a message gives its value. A card already used, expired, not valid yet or disabled is refused with a message.
- Write {hikashop\_eventsbooking\_card} in an article to show there the card of the visit, its value and its end date. Without a card in the visit, the tag shows nothing.
- The link of a HikaSerial card goes in the email of the pack or in its PDF (the AttachSerial or PDFSerial plugins), with the tag {serial.serial\_data} for the code. A QR code of the same link lets the card be scanned.

![The page opened by a gift card link: the message saying that the 75 euros card will be deducted from the order or the event registration, and the card's value shown by the tag in the article](/images/doc/plugins/hikashop-eventsbooking/hikashop_eventsbooking_card_link.png)

## Troubleshooting

- **"This gift card does not exist." for a real card**: the coupon is not synchronised. Check that it matches "Cards to synchronise" (its pack or its prefix), that it has a fixed amount, that its code has 20 characters at most, and that Events Booking uses the same currency. Turn the Log setting on: the logs of HikaShop (System &gt; Logs) say which.
- **"The coupon you entered is invalid" in Events Booking for a card that was never used**: check that coupons are enabled for the event, that the event is in the categories of the settings, the kind of registration and the access level, and the card's dates.
- **"The gift card ... has already been used."**: the card was spent, in the shop, on an event or consumed on site. Its HikaShop coupon shows its number of times used; the HikaSerial serial is "used" when "Update the serial's status" is on. Cancel the purchase that spent it to give it back.
- **"The gift card ... has expired." or "cannot be used yet."**: the dates of the card's coupon, set by the validity period of the generator. Change the coupon's end date if you want to extend a card: the voucher follows.
- **"This gift card is being used for an event registration. Try again in a few minutes."**: a registration paid with the card is waiting for its online payment. The card is free again in the shop after the minutes set in the settings, or at once when you cancel that registration in Events Booking. If the payment comes in later, the card is spent.
- **No coupon field in the registration form**: "Enable coupon" is off for that event, in its options or in the Events Booking configuration.
- **The link shows no message**: check that the plugin is enabled and that the parameter of the link is the one of "Link parameter" (card by default).
- **A card spent but still usable on the other side**: the voucher is brought up to date at the end of each purchase. If a purchase was interrupted, open the card's link or type its code in the registration form: the voucher is updated before Events Booking reads it.
- **In shared balance mode, a shop order spends the whole card**: check that the Multi Coupon plugin is installed and enabled, and that the card has a Quota of 1.
- **A change of the settings does not show on existing vouchers**: changing the plugin's categories, registrations, applies to or access level does not change the vouchers already made. Edit them in Events Booking &gt; Coupons, or delete them: they are made again the next time the card is used.
