Why doesn't my fixed-rate coupon apply during subscription edits?

Problem statement

This article explains why a fixed-rate, one-time coupon does not apply immediately when you edit a subscription and clarifies how coupon application works during subscription edits.

Related scenarios

• What happens when I apply a fixed-rate coupon during a subscription edit?

• How do fixed-rate coupons affect billing terms in Chargebee?

• Why is my coupon not deducting from the current charge?

Solution

In Chargebee, coupons are applied at the time an invoice is generated and do not retroactively modify invoices that are already created.

When you apply a fixed-rate, one-time coupon during a subscription edit:

• If an invoice already exists for the current billing term, that invoice remains unchanged. The coupon will not apply to it.

• If the edit does not generate a new invoice (no proration), the coupon is attached to the subscription immediately but is applied only to the next invoice (typically at renewal).

• If the edit generates an immediate prorated invoice, the coupon can apply to that invoice, and the discount is reflected right away (based on coupon applicability).

This behavior can make it appear that the coupon is not applied, while it is actually scheduled for the next billing event.

Steps to verify coupon application

1. Go to Subscriptions > Edit Subscription.
2. Apply the coupon during the edit.
3. (Optional) Modify the plan, addons, or quantity to trigger a prorated invoice.
4. Navigate to Invoices, check upcoming invoices to verify when the coupon will be applied.

Additional information

• Coupons apply only at the time of invoice generation and do not affect already finalized invoices.

• If no prorated invoice is created during the edit, there is no immediate charge for the coupon to apply to.

• To have the coupon reflected immediately, ensure the edit triggers a prorated invoice.

• For more details, see the coupon document.