Skip to content
ESC

Searching...

Quick Links

Type to search • Press to navigate • Enter to select

Keep typing to search...

No results found

No documentation matches ""

Batch Voucher Generation.

Generate hundreds of unique voucher codes from a template for marketing campaigns.

Dec 18, 2025

Batch generation creates hundreds or thousands of unique voucher codes from a single template. Each code is unique, making it perfect for email campaigns, in-store promotions, social media giveaways, and printed marketing materials.

When to Use Batch Generation

Email Campaigns Send unique codes to your email list. Each subscriber gets their own code, so you can track which emails converted.

In-Store QR Promotions Print a QR code on signage, receipts, or table tents. Customers scan to claim their unique voucher.

Social Media Giveaways Share a claim link or QR code. Followers claim vouchers on a first-come, first-served basis.

Event Handouts Generate codes for trade shows, grand openings, or special events. Each attendee gets a unique voucher.

Before You Begin

Make sure you have:

  • At least one active, non-expired manual voucher to use as a template
  • Partner dashboard access

💡 Tip: Create a dedicated "template" voucher for batch generation. Set it as inactive and non-public—use it only to define settings that batches will copy.

Creating a Batch

Step 1: Navigate to Batch Generation

  1. Go to Campaigns > Batches
  2. Click Generate Batch

Step 2: Select Your Template

The wizard shows all your eligible vouchers—active ones that haven't expired.

What gets copied from the template:

  • Discount type and value
  • Title and description (all languages)
  • Design (colors, logo, background)
  • Usage rules (limits, validity period)
  • Targeting rules (tiers, new members, etc.)

What's different for batch vouchers:

  • Each gets a unique auto-generated code (e.g., ABCD1234)
  • is_visible_by_default = false (not publicly browsable)
  • is_active = true (always active, regardless of template)
  • Member targeting is ignored (batch vouchers aren't for specific individuals)

Click a voucher card to select it as your template.

Step 3: Configure Batch Settings

Batch Name (required) Internal identifier for this campaign. Use something descriptive:

  • ✅ "Q1 2025 Email Campaign"
  • ✅ "Grand Opening Promo"
  • ❌ "Batch1"

Quantity (required) How many unique codes to generate. Enter between 1 and 10,000.

Quantity Generation Time
1-500 5-10 seconds
500-1,000 10-15 seconds
1,000-5,000 30-45 seconds
5,000-10,000 60-90 seconds

⚠️ Important: Voucher codes cannot be edited after generation. Double-check your template settings before proceeding.

Step 4: Review and Generate

Review your configuration:

  • Template voucher details
  • Batch name
  • Quantity
  • Note about immutable codes

Click Generate Codes to start batch creation.

A loading spinner appears while the system:

  1. Creates unique 8-character codes for each voucher
  2. Copies template settings to all vouchers
  3. Sets up the QR code claim URL
  4. Prepares analytics tracking

Step 5: Success!

You're redirected to the Batches dashboard with a success message. Your batch is now:

  • Active and ready for members to claim
  • Has a unique QR code and claim URL
  • Appears in your Batches list with metrics

How Batch Codes Work

Each voucher in a batch gets a unique 8-character alphanumeric code:

ABCD1234
XY7Z9W2Q
MN4K8P3R

These codes are:

  • Automatically generated (no manual entry)
  • Case-insensitive for entry
  • Unique across your entire account
  • Not guessable (random generation)

Sharing Your Batch

After generation, share your batch with customers:

QR Code

  1. Go to Campaigns > Batches
  2. Click the QR icon on your batch card
  3. In the modal:
    • Copy Link — Copies claim URL to clipboard
    • Download QR — Downloads high-resolution PNG
    • Visit Page — Preview the claim page

Best uses for QR codes:

  • In-store signage (posters, table tents, window decals)
  • Printed receipts
  • Flyers and brochures
  • Product packaging

Claim URL

The claim URL format: https://yoursite.com/en-us/claim/TOKEN123

Best uses for URLs:

  • Email campaigns (hyperlink "Claim your voucher")
  • SMS marketing
  • Social media posts
  • Website banners

Both Methods

Both QR code and URL lead to the same claim page. Use whichever fits your channel.

What Members See

When members visit the claim page:

Not Logged In

  1. See voucher preview (design, title, value)
  2. Claim My Voucher button
  3. Prompted to log in or register
  4. After authentication, return to claim page

Logged In

  1. See voucher preview
  2. Click Claim My Voucher
  3. Loading animation
  4. 🎉 Confetti celebration!
  5. Redirected to voucher detail page
  6. Confirmation email sent

Already Claimed

  1. "You've already claimed this voucher" message
  2. Link to view their voucher
  3. Link to My Cards

Batch Paused

  1. "Promotion Temporarily Paused" message
  2. Batch details visible
  3. No claim button
  4. "Back to Home" option

Voucher Allocation

Each claim assigns one unique voucher from the batch to that member.

Example: You generate 500 vouchers. After 150 claims:

  • 150 vouchers are now assigned to specific members
  • 350 vouchers remain available for new claimers
  • If all 500 are claimed, the next visitor sees "No vouchers available"

Media Optimization

Batch vouchers share media files efficiently:

  • Logo and background images stored once (not duplicated 1,000 times)
  • First voucher holds the media
  • Other vouchers reference it transparently
  • Members see identical designs, but storage is minimized

Best Practices

Start Small

Generate 100-500 codes for your first campaign to test the flow before scaling.

Use Descriptive Names

Name batches by campaign: "Summer Email 2025" not "Batch3."

Create Separate Batches by Channel

Generate different batches for email vs. social vs. in-store. This lets you compare performance across channels.

Set Expiration Dates

Always set valid_until on your template to create urgency. 30-90 days is typical.

Test Before Launching

Scan your own QR code to verify the claim flow works as expected.

Monitor Early

Check metrics in the first 24-48 hours. If claims are low, your promotion may need more visibility.

Limitations

  • Maximum 10,000 vouchers per batch
  • Codes cannot be edited after generation
  • Batch vouchers cannot target specific members
  • Cannot combine two batches (create larger batch instead)

Next Steps