Docschargebeedocs

HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee


  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee


  • Chargebee Agents
  • Chargebee Copilot
  • Chargebee MCP Server (Model Context Protocol)

Developer Resources


  • Developer Resources Overview
  • Articles and FAQ

Product Catalog


  • Product Catalog Overview
  • Coupons
    • Coupon Sets
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers


  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Entitlements


  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing


  • Understanding Usages
  • Setting up Usage Based Billing
  • Usage Alerts
  • Metered Billing
  • Articles and FAQ

Chargebee CPQ


  • Chargebee CPQ
  • Chargebee CPQ for Salesforce
  • Chargebee CPQ for HubSpot

Invoices, Credit Notes, and Quotes


  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes


  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Managing Payments with Chargebee.js
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Approvals
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Multi Business Entity


  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions


  • Overview
  • Omnichannel Subscriptions
  • Omnichannel One-Time Orders
  • Mobile Subscriptions (Legacy)

Reports and Analytics


  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations


  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Ecommerce Management
  • Articles and FAQ

Data Privacy & Security


  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations


  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  2. Product Catalog
  3. Coupons
  4. Coupon Sets
  1. Billing
  2. Product Catalog
  3. Coupons
  4. Coupon Sets

Coupon Sets

Coupon sets are collections of unique coupon codes that are associated with a specific coupon. Each coupon code can be redeemed only once.

Use coupon sets for campaigns that require multiple single-use promo codes. Instead of creating many individual single-use coupons in Chargebee Billing, you can create a coupon, set its properties, and then generate or upload a coupon set with the number of unique codes you need.

All coupon codes in a set are subject to the rules and behavior of the linked coupon.

Create coupon sets

To create coupon sets manually or by using the auto-generate option, follow these steps:

  1. Log into your Chargebee site.

  2. Go to Product Catalog > Coupon Sets > click + Create Coupon Sets.

    Create Coupon Sets page

Auto-generate coupon sets

Use the Auto-generate a set option to create the required coupon set automatically.

  1. Enter a value between 1 and 1000 in the Number of Coupons field.

  2. Enter the Prefix, Suffix, and Coupon Set Name. The Coupon Set ID is auto-generated but can be edited.

  3. Select a coupon from the Coupon drop-down to link this set to.

    Auto-generate coupon set form
  4. Click Submit to generate the coupon set with the specified number of coupons.

Upload coupon sets manually

Select Upload Manually to upload a CSV file containing the coupon sets, then click Upload.

Manual upload option

Limitations

  • The coupon sets must be in CSV file format and contain only the coupon codes.
  • Coupon codes must be unique and can contain only letters and numbers. Special characters (such as !, @, #, $, %, ^, &, *, (, )) are not allowed.
  • There is a limit of 1000 coupon codes per coupon set. If you need to upload more than 1000 codes, create another CSV file and upload the remaining codes as a separate coupon set.

How coupon sets work

Coupons vs. coupon codes

A coupon can be used on multiple subscriptions at the same time. In contrast, each coupon code from a coupon set can be used only once. To prevent customers from reusing a discount, share only coupon codes—not the linked coupon.

Redemption limits

The number of coupon codes that can be used from a coupon set depends on the redemption limit set for the linked coupon and how many times it has already been redeemed.

  • If a coupon's redemption limit is 10 and the coupon set has 100 codes, only 10 codes can be used.
  • If the coupon's redemption limit is 10 and it has already been redeemed 9 times, only 1 more code from the set can be used.
    You can change the coupon's redemption limit or redemption count at any time.

Applying coupons and coupon codes

The following table illustrates how applying coupons and coupon codes works in different scenarios:

ScenarioAction AttemptedResult
Subscription currently has a coupon attached.Apply the same coupon again.Not allowed.
Subscription currently has a coupon code attached.Apply the linked coupon or another coupon code linked to the same coupon.Not allowed.
Subscription currently has a coupon or coupon code attached.Apply a different coupon (or coupon code linked to a different coupon).Allowed if multiple coupons per subscription are enabled in Chargebee Billing.

Deleting coupon sets

When you delete a coupon set, any unused coupon codes are deleted. Codes that have already been used are archived for your records.

Archiving coupons

If you archive the linked coupon, unused coupon codes are deleted and used codes are archived.

FAQ

1) Can coupon codes be added to Quotes?

Yes, you can add coupon codes to Quotes.

Articles & FAQs

What are coupon codes/ coupon sets in Latest Product Catalog?
What are coupon codes/ coupon sets in Latest Product Catalog?
How will the coupon code behave?
How my customer used the one-time coupon twice on the same subscription. How to prevent this from happening?

Was this article helpful?