Skip to main content
The value of the coupon is deducted from the amount of the invoice before tax.

Create a coupon

To create a coupon through the user interface:
  1. Access the Coupons section via the side menu;
  2. Click Create a coupon;
  3. Choose a name and a code for your coupon;
  4. Select the type of coupon, fixed amount or percentage;
  5. Define its value and its frequency: once, over several periods or forever;
  6. Choose whether the coupon can be applied several times to the same customer account;
  7. Choose whether to set an expiration date, the date after which the coupon can no longer be redeemed;
  8. Select the plan(s) or billable metric(s) to which the coupon applies (applies to all plans and metrics by default); and
  9. Click Add coupon to confirm.
The expiration date displayed in the app is based on the organization’s timezone.
A coupon can be limited to plans or to billable metrics, not both. Setting both returns an only_one_limitation_type_per_coupon_allowed error.

Apply coupons

To apply a coupon to a customer:
  1. Select a customer from the list;
  2. Click Actions in the upper-right corner and select Apply coupon;
  3. Select a coupon;
  4. Override values and currency; and
  5. Click Apply coupon to confirm.

Application scope

You can apply several coupons to a customer. A non-reusable coupon can only be applied once to a customer account, even if it has not been fully consumed. A coupon applied to a customer continues to apply beyond the expiration date.
Coupons are deducted from future subscription invoices, before tax. For coupons whose value is a fixed amount:
  • When the coupon only applies once and its value is higher than the invoice amount, the remainder carries over to the following invoices until the coupon is fully consumed or removed; and
  • When the coupon is recurring and its value is higher than the invoice amount, any remaining unused amount is lost, even if it is the last application period; and
  • When the coupon applies forever and its value is higher than the invoice amount, the unused amount is lost as well, and the coupon applies again on every following invoice.
When several coupons are applied to the customer account, Lago deducts them in this order:
  • Coupons limited to specific billable metrics come first, if there is at least one subscription associated with the relevant metric;
  • Coupons limited to specific plans come next, if there is at least one subscription associated with the relevant plan; and
  • Coupons that apply to all plans come last, in the order in which they were applied. The coupon applied first is deducted first.
You can see the remaining value, or the number of remaining periods, for each coupon in the Coupons tab of the customer view. Customer account with several coupons
Coupons do not apply to add-ons or any other one-off charges.

Edit, terminate and delete coupons

In the Coupons section, click the ellipsis icon at the end of a coupon row, or open the coupon and click Actions, to see all available actions:
  1. Edit: change the name, code and settings of the coupon;
  2. Terminate: deactivate the coupon so that it cannot be applied to any new customer. Customers who already have it continue to benefit from it; and
  3. Delete: delete the coupon and remove it from the list. This action cannot be undone.
Once a coupon has been applied to a customer, you can only edit its name, description and expiration settings. The code, type, value, frequency, reusability and plan or metric limitations are locked.

Remove coupons

To remove a coupon that has been applied to a customer and is still active:
  1. Select the customer;
  2. Open the Coupons tab and locate the coupon;
  3. Click the bin icon on the right; and
  4. Click Remove coupon to confirm.
The coupon disappears from the customer view immediately and is not applied to the next invoice.