Gift Card Management

This guide covers managing gift card products, tracking purchases, bulk importing vouchers, and reviewing gift card analytics in the admin panel.

Overview

Gift cards let customers purchase prepaid vouchers that can be redeemed during checkout. The admin panel provides tools for creating gift card products, monitoring purchases, bulk importing codes, and analyzing gift card revenue.

Location: /admin/gift-cards

Gift Card Products

Creating a Gift Card Product

Gift card products define what customers can purchase. Each product has a name, description, and pricing options.

Fields:

Field	Type	Required	Description
name	string	Yes	Display name (e.g., "Gift Card")
description	string	No	Customer-facing description
denominations	number[]	Yes	Available amounts (e.g., 25, 50, 100)
customAmount	boolean	No	Allow custom amounts
minAmount	number	Conditional	Minimum custom amount (if enabled)
maxAmount	number	Conditional	Maximum custom amount (if enabled)
expiryDays	number	No	Days until voucher expires (null = no expiry)
isActive	boolean	Yes	Whether product is available for purchase

Managing Products

From the gift cards page, you can:

• Create new gift card products
• Edit existing products (name, denominations, expiry)
• Activate/Deactivate products without deleting them
• View purchase history per product

Purchases

Tracking Purchases

The purchases table shows all gift card orders with:

• Purchaser name and email
• Recipient email (if different from purchaser)
• Amount and denomination selected
• Payment status (pending, completed, failed)
• Voucher code generated after payment
• Purchase date and expiry date

Purchase Workflow

1. Customer selects a gift card product and denomination
2. Customer enters recipient details (name, email, optional message)
3. Payment is processed via Stripe or Paytrail
4. System generates a unique voucher code
5. Confirmation email is sent to purchaser
6. Gift card email with code is sent to recipient

Bulk Import

Importing Voucher Codes

Bulk import allows you to create multiple vouchers at once from a CSV file. This is useful for corporate orders, promotional giveaways, or migrating codes from another system.

CSV Format:

code,amount,recipientEmail,expiresAt
GIFT-001,50.00,john@example.com,2027-12-31
GIFT-002,100.00,jane@example.com,2027-12-31
GIFT-003,25.00,,

Fields:

Column	Required	Description
code	Yes	Unique voucher code
amount	Yes	Voucher value in EUR
recipientEmail	No	Email to send the voucher to
expiresAt	No	Expiry date (ISO format)

Import Process:

1. Navigate to Gift Cards > Bulk Import
2. Upload CSV file
3. Review the preview (shows valid/invalid rows)
4. Confirm import
5. System creates vouchers and optionally sends emails

Validation Rules:

• Codes must be unique (duplicates are rejected)
• Amounts must be positive numbers
• Email addresses are validated if provided
• Maximum 1000 codes per import

Analytics

Gift Card Analytics Dashboard

Location: /admin/gift-cards (analytics tab)

The analytics view provides insights into gift card performance:

Key Metrics:

• Total sold — Number of gift cards sold
• Total revenue — Revenue from gift card sales
• Total redeemed — Number of vouchers redeemed
• Outstanding balance — Unredeemed voucher value

Charts:

• Revenue by product — Breakdown by gift card product
• Sales over time — Daily/weekly/monthly sales trend
• Redemption rate — Percentage of vouchers redeemed vs outstanding
• Top denominations — Most popular amounts

Reporting

Gift card data is also available in:

• Revenue reports — Gift card sales appear as a revenue category
• Scheduled reports — Include gift card metrics in automated reports
• Export — Download gift card data as CSV

Voucher Lifecycle

Created → Active → Partially Redeemed → Fully Redeemed
                 → Expired

States:

State	Description
Active	Voucher is available for use
Partially Redeemed	Some balance remaining
Fully Redeemed	Entire balance used
Expired	Past expiry date, no longer usable

Related Documentation

• Gift Cards API Reference — API endpoints for gift card operations
• Promotions & Vouchers — Promotion code management
• Financial Operations — Revenue tracking and reconciliation
• Reports — Analytics and scheduled reports