Voucher System

The voucher system lets you manage collections of promotional codes that are automatically distributed to players when they win prizes. Each code is tracked individually — from creation through to claim.

What is a Voucher Set?

A voucher set is a named collection of unique codes organized for a campaign or promotion:

• Holiday discount codes
• Gift card codes
• Product trial keys
• Event-specific offers

Each set includes:

Property	Description	Required
Name	Descriptive label (e.g., “Summer Sale 20% Off”)	Yes
Description	Internal notes about the set’s purpose	No
Expiry Date	When all codes in the set expire	No

A single voucher set can be linked to multiple games simultaneously — the dashboard shows which games are currently using each set.

---

Creating a Voucher Set

1. Go to your Organization dashboard
2. Click Vouchers in the sidebar
3. Click Create Set
4. Enter a name, optional description, and optional expiry date
5. Click Create

The set is now ready for codes to be added.

---

Adding Codes

You have two options for populating a voucher set:

Upload CSV

Upload a .csv or .txt file with one code per line:

1. Click Upload CSV on the set
2. Select your file or paste codes into the text area
3. Click Upload

Accepted format (plain text, one code per line):

SUMMER2024-001
SUMMER2024-002
SUMMER2024-003

Multi-column CSVs are accepted — only the first column is used. All codes are automatically converted to uppercase, and duplicates are silently ignored.

You can also paste codes directly into the upload text area (one per line) without needing a file.

Generate Codes

Auto-generate unique, human-readable codes:

1. Click Generate on the set
2. Configure the settings:

Setting	Range	Description
Count	1–1,000	Number of codes to create
Prefix	0–10 chars	Optional prefix (e.g., PROMO)
Random Length	4–16 chars	Length of the random portion

3. Preview a sample code
4. Click Generate

Example output (prefix PROMO, length 8):

PROMO-A8K2M9X1
PROMO-B3N5P7Q2
PROMO-C1R4S6T8

Readability

Generated codes exclude easily confused characters (I, O, 1, 0) — only using ABCDEFGHJKLMNPQRSTUVWXYZ23456789 for the random portion.

---

Voucher Statuses

Each code has one of four statuses:

Status	Color	Description
Available	Green	Ready to be won and distributed
Claimed	Amber	Won by a player — includes player ID and timestamp
Expired	Gray	Past the expiry date, no longer distributable
Disabled	Red	Manually deactivated

Status transitions:

• available → claimed — When a player wins a linked prize
• available → expired — Automatically when the expiry date passes
• Only available vouchers can be deleted individually

---

Managing Vouchers

Dashboard View

Each voucher set displays:

• Total / Available / Claimed counts at a glance
• Linked games — which games currently use this set as a prize
• Expandable list of all individual codes with status badges

Copy Codes

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

Export

Download all codes from a set as CSV:

1. Click Export on the set
2. A file downloads named {set-name}-vouchers.csv

Export format:

code,status
PROMO-A8K2M9X1,available
PROMO-B3N5P7Q2,claimed
PROMO-C1R4S6T8,expired

Deleting

• Single code — Click the delete icon (only available for available codes; claimed codes cannot be deleted)
• Entire set — Click delete on the set header

Permanent Action

Deleting a voucher set removes all codes permanently — including claimed codes and their history. This cannot be undone.

---

Expiration

DailyPlay supports two levels of expiration:

Level	Scope	Effect
Set-level	All codes in the set	Set once when creating the set
Per-code	Individual voucher codes	Overrides the set-level expiry for specific codes

When a set or code expires:

• Status changes to expired — codes are no longer distributable
• If a player tries to claim a prize from an expired set, the system blocks the claim
• Expired dates are shown in red in the dashboard

---

Linking to Games

Voucher sets connect to games through prize configuration:

1. In the game editor, open the Prizes section
2. Add a prize slot with type Voucher Set
3. Select your voucher set from the dropdown
4. Set the win probability (0–100%)
5. Publish the game

Setting up a voucher set with a game:

Result in the voucher page:

Automatic Distribution Flow

When a player wins a voucher-set prize:

1. Server picks the next available code from the set (FIFO order)
2. Code status → claimed with the player’s UUID and timestamp
3. Player sees their unique code on the result screen
4. Connection integrations fire (Zapier, webhooks, etc.)

A single voucher set can serve multiple games — codes are drawn from the shared pool regardless of which game triggered the win.

---

Claim Tracking

Every claimed voucher records:

Field	Description
Player UUID	Anonymous browser-fingerprint player ID
Claimed At	Exact timestamp of the win
Play ID	Which game session triggered the claim

This data is available via the API and export — useful for reconciliation, fraud checks, and analytics.

---

Best Practices

Naming Conventions

Use clear, campaign-specific names:

• Summer-Sale-2024-20%Off
• Launch-Event-Free-Trial-7d
• VIP-Early-Access

Avoid generic names like Codes1 or Test — you’ll have multiple sets over time.

Code Prefixes

Prefixes make codes identifiable at a glance and help with external tracking:

Prefix	Campaign
SUMMER24-	Summer promotion
LAUNCH-	Product launch
VIP-	Exclusive/loyalty codes
GIFT-	Gift card codes

Inventory Planning

Campaign Size	Suggested Codes	Reasoning
Small (< 500 plays)	150–250	~30% win rate + 20% buffer
Medium (500–5,000 plays)	500–1,500	Scale with expected traffic
Large (5,000+ plays)	2,000+	Monitor daily and top up if needed

Avoid Stockouts

When a voucher set runs out of available codes, the linked prize slot becomes inactive. Players may land on it and get nothing. Always maintain a buffer — monitor the Available count and add more codes before campaigns peak.

Expiration Strategy

• Set expiry dates after your campaign end date (give players time to redeem)
• For ongoing promotions, leave expiry empty and manage manually
• Export codes before deleting sets so you have a record

---

Troubleshooting

”No vouchers available”

The set is empty or all codes are claimed/expired.

Fix: Upload or generate more codes into the set.

Codes not appearing in game

1. Confirm the voucher set is linked to a prize slot (check “Linked games” in the set)
2. Verify the set hasn’t expired
3. Ensure at least one code has available status

Player didn’t receive a code

1. Expand the voucher set and search for recently claimed codes
2. Check that the prize draw and claim both completed (network issues can interrupt)
3. If the code was claimed, it will show the player UUID and timestamp

Duplicate codes ignored

The system silently skips duplicate codes during upload. If your import count is lower than expected, some codes already existed in the set.

---

Next Steps

• Configure Prize Slots →
• Create a Game with voucher prizes