Voucher System

The voucher system lets you manage promotional codes that can be distributed to players as rewards.

What is a Voucher Set?

A voucher set is a collection of codes organized for a specific purpose:

• Holiday promotion codes
• Product discount codes
• Gift card codes
• Event-specific codes

Each set can have:

• A descriptive name
• Optional description
• Expiry date
• Multiple voucher codes

---

Creating a Voucher Set

Step 1: Navigate to Vouchers

1. Go to your Organization dashboard
2. Click Vouchers in the menu

Step 2: Create a New Set

1. Click Create Set
2. Enter the set details:

Field	Description	Required
Set Name	Descriptive name for the set	Yes
Description	Purpose of these vouchers	No
Expiry Date	When codes expire	No

3. Click Create

---

Adding Voucher Codes

You have three options for adding codes to a set:

Option 1: Upload CSV

Upload a file containing your codes:

1. Click Upload CSV
2. Select your file (one code per line)
3. Preview the codes
4. Confirm upload

CSV Format:

SUMMER2024-001
SUMMER2024-002
SUMMER2024-003

Option 2: Paste Codes

Paste codes directly:

1. Click Upload CSV or open the upload modal
2. Paste codes in the text area (one per line)
3. Click Upload

Option 3: Generate Codes

Auto-generate unique codes:

1. Click Generate
2. Configure generation settings:

Setting	Description
Number of Codes	How many to generate (e.g., 100)
Code Prefix	Optional prefix (e.g., “PROMO”)
Random Part Length	Length of random characters

3. Preview a sample code
4. Click Generate

Example generated codes:

• PROMO-A8K2M9X1
• PROMO-B3N5P7Q2
• PROMO-C1R4S6T8

---

Managing Vouchers

Viewing Codes

Expand a voucher set to see all codes with:

• Code value
• Status (Available, Claimed, Expired, Disabled)
• Assigned game (if linked)
• Actions

Voucher Statuses

Status	Description
Available	Ready to be claimed
Claimed	Assigned to a player
Expired	Past the set’s expiry date
Disabled	Manually deactivated

Copying Codes

Click the copy icon next to any code to copy it to your clipboard.

Exporting Codes

Export all codes in a set:

1. Click Export on the voucher set
2. Download the CSV file
3. Use for external tracking or backup

Deleting Codes

To delete individual codes or entire sets:

• Single code: Click the delete icon
• Entire set: Click delete on the set header

:::caution[Warning] Deleting a voucher set removes all codes permanently, including claimed codes. This cannot be undone. :::

---

Linking Vouchers to Games

Connect voucher sets to game prizes:

During Game Creation

1. Enable prizes in the game editor
2. Add a prize slot of type “Voucher Set”
3. Select the voucher set
4. Set the probability

How Distribution Works

1. Player wins a voucher prize
2. System selects an available code from the set
3. Code is marked as claimed
4. Player sees their unique code
5. Code is linked to their session/email

---

Best Practices

Naming Conventions

Use clear, descriptive names:

• ✅ Summer-Sale-2024-20%Off
• ✅ Launch-Event-Free-Trial
• ❌ Codes1
• ❌ Test

Code Prefixes

Use prefixes to identify campaigns:

• SUMMER24- for summer campaign
• LAUNCH- for product launch
• VIP- for exclusive codes

Inventory Planning

Campaign Size	Suggested Codes
Small (< 500 plays)	100-200 codes
Medium (500-5000 plays)	500-1000 codes
Large (5000+ plays)	2000+ codes

:::tip[Buffer] Always generate 20-30% more codes than expected plays to avoid running out. :::

Expiration Management

• Set realistic expiry dates
• Send reminders before campaigns end
• Have backup codes for extensions

---

Troubleshooting

”No vouchers available”

The set is empty or all codes are claimed. Add more codes or create a new set.

Codes not appearing in game

1. Verify the voucher set is linked to the prize
2. Check the set isn’t expired
3. Confirm codes are in “Available” status

Player didn’t receive code

1. Check if the code was claimed (should show in voucher list)
2. Verify the player’s email was captured
3. Check for email delivery issues

Next Steps

• Learn about Prize Configuration
• Create a Game with voucher prizes