The difference between once, recurring, and forever coupon frequency

Lago supports three coupon frequency settings that control how many times a discount is applied to a customer's invoices: once, recurring, and forever.

How each works

Once applies the discount until the coupon's value is fully consumed: a single invoice for percentage coupons, or multiple invoices for fixed-amount coupons until the full credit amount is used, then it terminates automatically.

Recurring applies the discount for a fixed number of invoices, set by frequency_duration. Each finalized invoice decrements the remaining count by one, and the coupon terminates automatically once the count reaches zero.

Forever applies the discount to every invoice indefinitely, until it's manually removed.

Which to use

Use forever for a discount that should renew every billing cycle until you decide to remove it. Use recurring with frequency_duration set to the number of invoices when the discount should apply for a set number of billing periods and then expire automatically. To change a coupon's frequency after the fact, remove it via the UI or DELETE /api/v1/applied_coupons/{id} and reapply a new coupon with the correct setting. See the official coupons documentation for more detail.

This article reflects guidance drawn from customer case resolutions. It is not officially supported documentation and may not apply to all situations.