Buying and Delivery

Buying a gift card

On the product page of a gift card product, the buyer chooses or enters the amount (see Gift card value). When personalisation is switched on for the product, the buyer can open Personalise your gift card and fill in:

Field	Shown for	Notes
For	all gift cards	Name of the recipient, up to 100 characters
From	all gift cards	Name of the sender, up to 100 characters
E-mail address of the recipient	digital gift cards	Empty: the gift card is sent to the buyer
Send on	digital gift cards with Buyers can choose when the gift card is sent	From tomorrow up to a year ahead. Empty: sent right away
Personal message	all gift cards	Up to 500 characters

Every field is optional. The cart, the checkout and the orders in My Account show the personalisation below the gift card line item.

When the gift card is created

The gift card and its code are created at the moment set in Activation action in the plugin configuration: when the order is placed, or when it is paid (default).

A gift card can only be redeemed in its sales channel: for a bought gift card, the sales channel it was bought in. Gift cards without a sales channel, e.g. imported ones, can be redeemed in every sales channel.

E-mail with the PDF

For a digital gift card, an e-mail with the gift card as a PDF is sent:

• to the buyer, or
• to the recipient, when the buyer entered the e-mail address of the recipient. The buyer gets a copy, unless Send the buyer a copy when the gift card is sent to someone else is switched off.

Without a Send on date, the e-mail is sent right away. With a date, it is sent on that day.

note

The e-mails are sent through Shopware's message queue, and gift cards with a Send on date are sent by the scheduled task lae_giftcard.send_scheduled, which runs every hour. Make sure the message queue workers and scheduled tasks of your shop run.

Physical gift cards get no e-mail and no PDF. Find the code in Orders > Gift cards and ship the card yourself.

The Administration shows when the e-mail was sent in the details of the gift card, where you can also resend it. See Administration.

E-mail template

The plugin installs the e-mail template "Template for email to client who bought giftcard". Edit it in Settings > Email templates, or choose another template in the plugin configuration.

The template can use these variables:

• giftcard: the gift card, e.g. {{ giftcard.code }}, {{ giftcard.initialAmount|currency }}, {{ giftcard.validUntil|date('d/m/Y') }}
• giftcard.payload.recipientName, giftcard.payload.senderName and giftcard.payload.message: the personalisation
• order: the order in which the gift card was bought. This is empty for gift cards created by hand in the Administration.

A personal e-mail for the recipient could start like this:

{% if giftcard.payload.recipientName ?? false %}
  Dear {{ giftcard.payload.recipientName }},
{% endif %}

{% if giftcard.payload.senderName ?? false %}
  {{ giftcard.payload.senderName }} sent you a gift card of {{ giftcard.initialAmount|currency }}.
{% endif %}

{% if giftcard.payload.message ?? false %}
  {{ giftcard.payload.message|nl2br }}
{% endif %}

The PDF is attached with the Filename of the product (see Advanced configuration).

Download in My Account

With Allow download of bought Giftcards in My Account > Orders switched on in the plugin configuration, the buyer can download the PDF of every bought gift card in the order details of My Account > Orders.

Cancelled orders

When an order with bought gift cards is cancelled, the gift cards are not taken back automatically. Book a transaction on the gift card in the Administration if needed. When an order that was paid with a gift card is cancelled, the amount goes back to the gift card. See Redeeming.