Vouchers

Vouchers (promotional codes) allow you to offer discounts and credits to customers. This guide covers creating and managing vouchers.

Accessing Voucher Management

To manage vouchers:

1. Click Vouchers in the admin sidebar

2. Choose:

   • Vouchers - Create and manage codes

   • Voucher Usages - View redemption history

Required permission: access_vouchers or admin role

Understanding Vouchers

What are Vouchers?

Vouchers are promotional codes that provide:

• Discounts on purchases

• Free balance when topping up wallet

Voucher Types

1. Discount Vouchers:

• Percentage off purchase price

• Applied to server purchases

• Example: "SAVE20" = 20% off

2. Balance Top-up Vouchers:

• Free balance when adding funds

• Applied to wallet recharges

• Example: "BONUS10" = $10 free with topup

Voucher List

The voucher list shows:

• Code - The voucher code customers enter

• Type - Discount or Balance

• Value - Percentage or amount

• Used Count - How many times redeemed

• Max Uses - Maximum redemptions allowed

• Expires - Expiration date

• Active - Whether still valid

• Actions - Edit, delete, view usages

Creating Vouchers

How to Create a Voucher

1. Click Create Voucher or Add New

2. Fill in voucher configuration

3. Save to activate

Basic Fields

Code (required):

• Unique voucher code

• What customers type in

• Case-insensitive usually

• Examples: "WELCOME", "SUMMER2024", "FRIEND20"

Tips:

• Keep it memorable

• Avoid confusing characters (O vs 0, I vs l)

• Use theme/purpose in name

• Shorter is better for sharing

Type (required):

• Discount - Percentage off purchases

• Balance Top-up - Free balance with wallet recharge

Value (required):

• For Discount: Percentage (e.g., 20 for 20% off)

• For Balance: Amount (e.g., 10.00 for $10 free)

Description (optional):

• Internal note about voucher

• Purpose, campaign, or details

• Not shown to customers

Restrictions

Minimum Top-up Amount:

• For Balance vouchers

• User must add at least this much to use voucher

• Example: Minimum $20 topup to get $5 free

Minimum Order Amount:

• For Discount vouchers

• Purchase must be at least this amount

• Example: $10 minimum to use 20% off

Max Global Uses:

• Total number of redemptions allowed

• Limits voucher budget

• Leave empty for unlimited

One Use Per User:

• Checked - Each user can only use once

• Unchecked - Users can reuse (if global uses allow)

New Accounts Only:

• Checked - Only users who just registered

• Unchecked - Any user can use

Expires At:

• Expiration date and time

• Voucher invalid after this

• Leave empty for no expiration

Examples

Welcome Voucher:

Code: WELCOME
Type: Balance Top-up
Value: 5.00
Description: New customer welcome bonus
Minimum Top-up: 10.00
Max Global Uses: 100
One Use Per User: Yes
New Accounts Only: Yes
Expires: (30 days from now)

Flash Sale:

Code: FLASH50
Type: Discount
Value: 50
Description: 24-hour flash sale
Minimum Order Amount: 0
Max Global Uses: 50
One Use Per User: No
New Accounts Only: No
Expires: (tomorrow)

Friend Referral:

Code: FRIEND10
Type: Discount
Value: 10
Description: Friend referral discount
Minimum Order Amount: 5.00
Max Global Uses: (unlimited)
One Use Per User: Yes
New Accounts Only: No
Expires: (none)

Editing Vouchers

How to Edit a Voucher

1. Find voucher in list

2. Click Edit action

3. Modify fields

4. Save changes

What You Can Change

Editable:

• Description

• Max global uses

• Expiration date

• Restrictions

Cannot change:

• Code (creates confusion if used)

• Type (Discount vs Balance)

• Value (unfair to existing users)

To change immutable fields:

• Deactivate old voucher

• Create new voucher with different code

Voucher Usage Tracking

Viewing Voucher Usages

To see who used a voucher:

1. Go to Vouchers → Voucher Usages

2. Browse or filter usage history

Usage information:

• Voucher - Which code was used

• User - Who redeemed it

• Used At - Timestamp

• Order/Transaction - Related purchase or topup

Analyzing Voucher Performance

Metrics to track:

• Total redemptions

• Unique users

• Revenue impact

• Conversion rate

Questions to answer:

• Which vouchers are most popular?

• Are discounts driving sales?

• Are users sharing codes?

• When do redemptions peak?

Deactivating Vouchers

How to Deactivate

Options:

1. Delete voucher - Removes from list

2. Set expiration - Auto-deactivates at date

3. Set max uses - Stops after X redemptions

When to deactivate:

• Campaign ended

• Budget exhausted

• Code leaked publicly

• Abuse detected

Voucher Security

Preventing Abuse

Built-in protections:

• One use per user option

• Max global uses limit

• Expiration dates

• Minimum purchase requirements

Manual monitoring:

• Watch for unusual redemption patterns

• Check if same user using multiple accounts

• Verify usage aligns with campaign

If abuse detected:

1. Deactivate voucher immediately

2. Review recent usages

3. Investigate suspicious accounts

4. Create new code if needed

Best Practices

Creating Effective Vouchers

Do:

• Set clear expiration dates

• Use memorable, easy-to-type codes

• Limit uses to control budget

• Match discount to campaign goal

• Track performance metrics

Don't:

• Create unlimited high-value vouchers

• Use confusing codes (0O, l1)

• Forget to set expiration

• Allow unlimited uses without monitoring

Voucher Strategy

Welcome vouchers:

• Small balance boost or discount

• New accounts only

• Encourage first purchase

• Limited time (create urgency)

Seasonal promotions:

• Larger discounts

• Limited duration

• Targeted marketing

• Track campaign ROI

Referral programs:

• Moderate discount

• One per user

• Ongoing availability

• Encourage sharing

Retention campaigns:

• Re-engage inactive users

• Targeted codes (sent via email)

• Personalized offers

• Time-limited

Communication

Promote vouchers:

• Announce in Discord/forums

• Email marketing

• Social media

• Website banners

Clear terms:

• State restrictions clearly

• Include expiration date

• Specify minimum amounts

• Explain usage limits

Troubleshooting

Voucher Not Working

Common issues:

• Code expired

• Max uses reached

• User already used (one per user)

• Minimum amount not met

• New accounts only (existing user)

• Code misspelled

Solutions:

1. Verify voucher is active

2. Check usage count vs. max

3. Confirm user hasn't used it

4. Verify cart/topup meets minimums

5. Check spelling and case

Too Many Redemptions

If voucher used more than expected:

Possible causes:

• Code shared publicly

• No max uses set

• Bot abuse

• User creating multiple accounts

Actions:

1. Deactivate voucher immediately

2. Review usage history

3. Investigate suspicious patterns

4. Create new limited code

5. Communicate with legitimate users

Wrong Value Applied

If discount/bonus incorrect:

Check:

1. Voucher type (Discount vs Balance)

2. Value field (% or amount)

3. Calculation logic

4. Recent voucher edits

Solutions:

• Verify voucher configuration

• Check system logs

• Test with new voucher

• Contact support if system issue

Related Guides

• Payments & Orders - Payment tracking

• Managing Users - User accounts

• Logs & Monitoring - Usage tracking

Need Help?

For voucher questions:

• Check FAQ

• Join Discord Community

• Contact technical support