HomeProduct DocsAPI ReferenceChangelog
RecurlyAPI GuidesRecurly.jsWebhooksAPI ReferenceSupportBook demo
Product Docs

Multiple coupons per account

Multiple coupons per account lets subscribers hold more than one active coupon and receive all eligible discounts on each invoice. You control how discounts are sequenced and how multiple percentage discounts interact — giving you flexibility while keeping promotional spend predictable.
Available on all Recurly plans

Definition

Multiple coupons per account is a Recurly feature that allows subscribers to hold more than one active coupon redemption on their account. When multiple coupons are eligible for a purchase, all qualifying discounts are applied to the invoice automatically. You configure the order in which different discount types are applied and how multiple percentage discounts interact with each other.

Key benefits

Flexible stacking Let subscribers benefit from multiple campaigns simultaneously — for example, a perpetual loyalty discount alongside a limited-time promotional code.
Concurrent campaign management Run multiple promotional campaigns at once without forcing subscribers to choose between them.
Granular discount control Configure whether percentage or fixed amount discounts apply first, and choose how multiple percentage discounts compound — keeping promotional margins in check.

How multiple coupons are applied

When multiple coupons per account is enabled, any eligible coupon redeemed on the account is automatically applied to each qualifying invoice. All eligible coupons apply — there is no single-coupon-per-invoice cap with this feature active.

If you want to limit invoices to one discount while still allowing multiple coupons to exist on an account, use subscription-level coupons instead. This associates a specific discount with a particular subscription rather than applying all account coupons to every invoice.

Subscription-level coupon application

  • When multiple subscription-level coupons are redeemed in a purchase where more than one subscription is eligible, the coupons apply to the first eligible and most expensive subscription.
  • If a subscription-level coupon is redeemed but the eligible subscription is already fully discounted by other coupons or credits, the coupon is still redeemed to the subscription — it remains active and unused until the subscription's next invoice.
  • Fixed amount subscription-level coupons do not carry leftover discount to other eligible subscriptions.

Account-level coupon application

  • A fixed amount account-level coupon eligible for all plans and one-time charges applies first to any setup fee, then to other setup fees, then to the first subscription plan fee, working down through plan fees and adjustments as the discount allows.
  • If an account-level coupon is redeemed but all eligible charges are already fully discounted, the coupon is redeemed to the account and remains active and unused until the next invoice.

Order of coupon application

When both percentage and fixed amount discounts are eligible for a single line item, you choose which type applies first. This setting is configured when enabling multiple coupons per account:

Apply percentage discounts first — Percentage discounts are applied before fixed amount discounts. This typically results in a larger total discount for the subscriber.

Apply fixed amount discounts first — Fixed amount discounts are applied before percentage discounts. This results in a smaller total discount and is more favorable to the merchant.

When coupons apply across multiple subscriptions or a hybrid purchase, the configured order is preserved. Coupons set for one-time purchases apply based on their discount type (percentage or fixed amount).

Multiple percentage discounts

When more than one percentage discount is eligible for a single invoice line item, you choose how they interact.

Apply to full line item amount

Each percentage discount is applied to the full original line item amount, sequentially from the oldest to the newest redemption on the account.

  • If fixed amount coupons are configured to apply first and have already reduced the line item, percentage discounts then apply to the net amount after those deductions — not the original full amount.
  • Once a line item is 100% discounted, no further coupon discounts apply — even if eligible coupons remain.
  • This method is more favorable to the subscriber, producing a larger total discount.

Compound the discounts

Each percentage discount is applied to the net amount remaining after the previous discount, sequentially from oldest to newest redemption.

  • As with the full line item method, a fully discounted line item stops further coupon applications.
  • This method is more favorable to the merchant, producing a smaller total discount.

Example

Coupon A offers 10% off. Coupon B offers 50% off. Applied to a $100.00 line item:

MethodCoupon A discountCoupon B discountTotal discountSubtotal
Apply to full line item amount$10.00 (10% of $100)$50.00 (50% of $100)$60.00$40.00
Compound the discounts$10.00 (10% of $100)$45.00 (50% of $90)$55.00$45.00

Proration, refunds, and invoices

Proration

When a subscription changes mid-billing cycle, prorated credits and charges are calculated individually at the coupon redemption level for each line item. If a line item has three coupon redemptions, each discount fragment is prorated separately, then aggregated into the total discount for that line item.

Refunds

Line item refunds preserve the discount amount and identity down to the individual coupon redemption. The invoice shows line item–level discounts and exports include per-redemption discount details.

Open amount refunds return the correct total but do not retain discount attribution. The discount amount and coupon identity are absent from both the refund invoice and exports.

Invoice display

The Discounts Applied section on each invoice lists all coupons that contributed a discount. If a coupon was redeemed more than once on the same invoice, it appears once with a count in parentheses indicating the number of redemptions.

Enabling multiple coupons per account

1

Navigate to Coupon Settings

Go to Configuration > Coupons, then click the Settings button in the top right of the page.

2

Enable Multiple Coupons Per Account

Find the Multiple Coupons Per Account section and select Enable.

3

Set the order of application

Under Order of Application, choose whether percentage discounts or fixed amount discounts apply first when both are eligible for a single line item.

4

Configure multiple percentage discounts

Under Multiple Percentage Discounts, choose Apply to Full Line Item Amount or Compound the Discounts.

5

Save and test

Click Save. Recurly recommends verifying your configuration in a sandbox environment to confirm coupons are applied in the expected order.

Exports

Multiple coupon discounts are available across three exports. Access all of them from the Exports page under Analytics.

ExportWhat it shows
Invoices – SummaryThe coupon_code column lists all coupon codes applied to the invoice as a comma-separated value. Each coupon appears once even if redeemed multiple times on the same invoice. Coupons contributing to returned credits are also included.
Invoices – Line ItemsThe adjustment_discount column shows the total discount for the line item. The adjustment_coupon_code column lists all coupon codes applied to the line item. Each coupon appears once per line item regardless of redemption count.
Invoices – Line Items – CouponsOnly available when Multiple Coupons Per Account is enabled. Each coupon discount on a line item gets its own row. The adjustment_discount column shows the discount from the specific coupon in the adjustment_coupon_code column. Two rows with the same coupon code on the same line item indicate multiple redemptions of that coupon.