New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
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
  • 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
  • eInvoicing
  • 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
  3. Product Catalog
  5. Articles and FAQ
  6. Coupons
  1. Billing
  3. Product Catalog
  5. Articles and FAQ
  6. Coupons

Why can't I apply offer-quantity coupons to flat-fee plans?

Problem statement

You are unable to apply an offer-quantity coupon to a subscription that uses a flat-fee plan, resulting in an error or the coupon not being applied.

Related Scenarios

  • How do I apply coupons to flat-fee plans?
  • Can I use offer-quantity coupons with metered addons?
  • What types of coupons are compatible with flat-fee plans?

Solution

When attempting to apply multiple coupons to a subscription with a flat-fee plan, you may encounter issues if one of the coupons is an offer-quantity coupon. Offer-quantity coupons are designed to work with per-unit plans and are not compatible with any other pricing model, plans, and addons. This article explains why this limitation exists and how to work around it.

Steps to Resolve

  1. Identify the Plan Type: Confirm that your subscription is on a flat-fee plan.

    • Navigate to Subscriptions > Subscription Index page.
    • Select your subscription and click Plan Details in subscription details page.
    • Check if the plan is listed as a Flat Fee plan.

  2. Review Coupon Compatibility: Understand the types of coupons that can be applied.

    • Offer-quantity coupons are only compatible with per-unit plans.
    • For flat-fee plans, use flat-rate or percentage-based coupons.

  3. Test with Compatible Coupons: Apply a compatible coupon to your subscription.

    • Navigate to Subscriptions > Subscription Index page.
    • Select your subscription and click Apply Coupon.
    • Select a flat-rate or percentage-based coupon.
    • Click Apply to test if the coupon works.

Note

Offer-quantity coupon limitation is for both the plan and the addon.

Important Notes

  • Offer-quantity coupons are specifically designed for per-unit priced items (both plans AND addons) and will not function with flat-fee, tiered, volume, or stairstep pricing models.
  • The limitation applies to all subscription items, not just the main plan. Offer-quantity is also incompatible with Tiered, Volume, Stairstep pricing models. If you attempt to apply an offer-quantity coupon to a non-per-unit item, you may see the error: "Offer quantity discounts can only be applied to per unit items"
  • Always verify the pricing model of all items in the subscription before applying offer-quantity coupons.

Was this article helpful?