The Reference Docs Developer Hub

Welcome to the Reference Docs developer hub. You'll find comprehensive guides and documentation to help you start working with Reference Docs as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Multiple Coupons Per Account

Allow your customers to redeem multiple coupons and receive multiple discounts at a time.

Why Allow Multiple Coupons on an Account?

Allow currently discounted customers to partake in a second campaign, or let customers redeem more than one coupon on your checkout page. For example, if you gave a customer an early adopter coupon that gives them 10% off forever, you can now let them also partake in another coupon campaign and use a $20 off single use coupon. If both coupons are eligible for a purchase, we will apply both discounts to the invoice line item.

Which Coupons Are Applied to the Invoice?

If you enable Multiple Coupons Per Account and multiple coupons are redeemed on an account, we will apply all coupon discounts that are eligible to each purchase invoice. This is the default behavior of the feature and cannot be configured to limit one coupon per invoice. If you would like to limit purchases to one coupon discount, but would like to allow multiple active coupons on customer accounts, use our Subscription Level coupon option to tie a coupon discount to a specific subscription.

Order of Application

When you enable Multiple Coupons Per Account, you need to decide in what order you would like us to apply percentage discounts and fixed amount discounts in the event both discount types are eligible for a single line item on an invoice.

Apply Percentage First

"Apply percentage first" will apply all percentage discounts to the line item amount first, in order of oldest redeemed on the account to most recently redeemed on the account.

  • After all percentage discounts are applied, if there is a remaining amount on the line item, fixed amount discounts will be applied in order of oldest redeemed on the account to most recently redeemed on the account.
  • Once the line item is fully discounted, we will no longer apply coupon discounts, so an eligible coupon may not end up being used on the invoice in the event other coupons achieved a 100% discount first.
  • This option favors the customer, returning a larger discount.

Apply Fixed Amount First

"Apply fixed amount first" will apply all fixed amount discounts to the line item amount first, in order of oldest redeemed on the account to most recently redeemed on the account.

  • After all fixed amount discounts are applied, if there is a remaining amount on the line item, percentage discounts will be applied in order of oldest redeemed on the account to most recently redeemed on the account.
  • Once the line item is fully discounted, we will no longer apply coupon discounts, so an eligible coupon may not end up being used on the invoice in the event other coupons achieved a 100% discount first.
  • This option favors the merchant, returning a smaller discount.

Example

Coupon A is 10% off and Coupon B is $20.00 off. Line item purchase of $50.00.

  • Apply percentage first would result in a ($5.00) discount from Coupon A and a ($20.00) discount from Coupon B, for a total discount on the line item of ($25.00). The purchase subtotal would be $25.00.
  • Apply fixed amount first would result in a ($20.00) discount from Coupon B and a ($3.00) discount from Coupon A, for a total discount on the line item of ($23.00). The purchase subtotal would be $27.00.

Multiple Percentage Discounts

When you enable Multiple Coupons Per Account, you need to decide how you want to apply multiple percentage discounts in the event more than one percentage discount is eligible for a single line item on an invoice.

Apply to Full Line Item Amount

"Apply to full line item amount" will apply each percentage discount to the full line item amount, in order of oldest redeemed on the account to most recently redeemed on the account.

  • If your settings apply fixed amount first and you have fixed amount coupons discounting the invoice, the percentage discounts will be applied to the net amount after all fixed amount coupons are applied, not the full line item amount.
  • Once the line item is fully discounted, we will no longer apply coupon discounts, so an eligible coupon may not end up being used on the invoice in the event other coupons achieved a 100% discount first.
  • This option favors the customer, returning a larger discount.

Compound the Discounts

"Compound the discounts" will apply each percentage discount to the net result of the previous discount, in order of oldest redeemed on the account to most recently redeemed on the account.

  • Once the line item is fully discounted, we will no longer apply coupon discounts, so an eligible coupon may not end up being used on the invoice in the event other coupons achieved a 100% discount first.
  • This option favors the merchant, returning a smaller discount.

Example

Coupon A is 10% off and Coupon B is 50% off. Line item purchase if $100.00.

  • Apply to full line item amount would result in a ($10.00) discount from Coupon A and a ($50.00) discount from Coupon B, for a total discount on the line item of ($60.00). The purchase subtotal would be $40.00.
  • Compound the discounts would result in a ($10.00) discount from Coupon A and a ($45.00) discount from Coupon B, for a total discount on the line item of ($55.00). The purchase subtotal would be $45.00.

Enable Multiple Coupons Per Account

  1. Visit the Coupons page under Configuration.
  2. At the top right of the page, click the button called "Settings".
  3. Under "Multiple Coupons Per Account", select the Enable option.
  4. Before you save the page, confirm the "Order of Application" and "Multiple Percentage Discounts" are set to the options you want.
  5. Then save the page.

Proration

When prorated credits and charges are created in mid-billing cycle subscription changes, their associated discounts will be prorated at the individual coupon redemption level for each line item. For example, if the line item had 3 different coupon redemptions applied, each of the 3 resulting discount portions would be prorated individually and then summed to create the line item discount amount for the prorated charge or credit.

Refunds

  • Line Item Refunds will retain the discount amount and identity down to the individual coupon redemptions on the line item. Line item level discounts will show on the invoice and the exports will show the individual coupon redemption discounts.
  • Open Amount Refunds will refund the correct amount, but will not retain the discount amount or identity. The refund invoice and exports will not show any mention of a discount.

Invoices

The Discounts Applied notes section on the invoice will show all coupons that were applied to the invoice. In the case where multiple redemptions of the same coupon were appled to the same invoice, you will see one mention of the coupon with a count in parentheses of the number of redemptions.

Exports

Merchants can report on multiple discounts in the Invoices - Summary, Invoices - Line Items, and our new Invoices - Line Item Coupons exports.

Invoices - Summary

This export answers which coupons were applied to the invoice.

  • The coupon_code column will show a comma separated list of coupon codes if the invoice had more than one coupon code applied.
  • The coupon codes are a unique list of coupons applied to the invoice. If the coupon had multiple redemptions applied to the invoice, you will see the coupon mentioned only once in this list.
  • Coupons used to calculate returned credits will show in this list.

See the details of this export in our Invoices - Summary export documentation.

Invoices - Line Items

This export answers which coupons were applied to the line item and the total discount they created on the line item.

  • The adjustment_discount column will show the total discount for the line item.
  • The adjustment_coupon_code column will show a comma separated list of coupon codes if the line item had more than one coupon code applied.
  • The coupon codes are a unique list of coupons applied to the line item. If the coupon had multiple redemptions applied to the line item, you will see the coupon mentioned only once in this list.
  • Coupons used to calculate returned credits will show in this list.

See the details of this export in our Invoices - Line Items export documentation.

Invoices - Line Items - Coupons

This export answers what the individual discounts were for each coupon applied to the line item. This export will only show if you have the Multiple Coupons Per Account feature enabled in your coupon Settings.

  • This export creates a row for each line item discount. A line item with multiple discounts applied will have multiple rows in the export.
  • The adjustment_discount column will show the portion of the line item discount created by the specific coupon in the adjustment_coupon_code column for that row.
  • The adjustment_coupon_code will only show one coupon code. If you see two rows for the same line item with the same coupon code, it means the coupon was redeemed more than once and more than one redemption discounted the line item.
  • Line items for credits will also show any coupons and discounts applied to calculate the correct credits to return.

See the details of this export in our Invoices - Line Items Coupons export documentation.

Multiple Coupons in a Multiple Subscription Purchase

If you allow Multiple Subscriptions in a purchase in addition to multiple coupons per account, below are some rules around how both interplay with each other.

Coupon Setting

If you enable your coupon settings to allow Multiple Coupons Per Account, we will allow your customers to redeem more than one coupon in a [multiple subscription (https://docs.recurly.com/v1.0/docs/multiple-subscriptions) purchase or hybrid purchase. This is the default behavior of the feature and cannot be configured to limit one coupon per purchase invoice. If you would like to limit a discount to a single subscription in the purchase, but would like to allow multiple active coupons on customer accounts, use our Subscription Level coupon option to tie a coupon discount to a specific subscription plan.

If this setting is not enabled, then only one coupon is ever allowed on an account at a time.

Order of Application

When you enable Multiple Coupons Per Account, you need to decide in what order you would like us to apply percentage discounts and fixed amount discounts in the event both discount types are eligible for a single line item on an invoice. In this particular case of multiple coupons being applied to multiple subscriptions or a hybrid purchase, we will preserve the order of coupon application that is configured in your coupon settings. Coupons that are for configured for one-time purchases, will apply based on what type of discount (percentage or fixed amount).

Subscription level coupon application

  • Multiple subscription level coupons that are redeemed in a purchase where >1 subscription in eligible, the coupons will apply to the first eligible and more expensive subscription (if applicable)
  • If a subscription level coupon is redeemed in a purchase but it's eligible subscription is already entirely discounted (presumably by other coupons or credits), the coupon will still be redeemed to the subscription without applying a discount and should remain active and unused until the subscriptions next invoice.
  • Subscription-level coupons that are fixed amount, will not carry over any leftover discount to other eligible subscriptions

Account Level Coupon Application

Fixed amount account level

  • A fixed amount, account level coupon, that is eligible to all plans and one time charges will apply first to a setup fee if there is one, and then other setup fees - if there is additional discount remaining, first subscription plan, and work it's way down the plan fees and then the adjustments if the discount can.

  • If an account level coupon is redeemed in a purchase but it's eligible charge(s) are already entirely discounted, the coupon will be redeemed to the account and should remain active and unused until the next invoice

Ordering of gift cards and credits after coupons apply

After coupon discounts are applied in a purchase, gift card(s) will be applied in order of oldest gift card on the account first (e.g we will apply a gift card purchased earlier than another gift card first). Once gift cards have been applied, any uninvoiced credits on the account will apply to the purchase in order of oldest first.

Updated 24 days ago

Multiple Coupons Per Account


Allow your customers to redeem multiple coupons and receive multiple discounts at a time.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.