Coupons
Recurly supports the addition of coupon codes to customer accounts, enabling merchants to offer a variety of promotions, discounts, and special offers. Coupons are supported via the Hosted Payment Pages, Recurly.js, and API. They can also be added to an account via the Recurly admin console.
Dashboard
Your coupons dashboard is divided into active (redeemable) and expired coupons. This overview page will also display basic coupon stats and the number of coupon redemptions per coupon.
Creating Coupons
From your main coupon page, click New Coupon. To create a new coupon you’ll need to define the following parameters:
- Coupon Code
- The unique identifier for a coupon code. Subscribers will enter this code upon subscribing.
- Coupon Name
- The name of the coupon.
- Discount
- The dollar or percentage amount that will be subtracted from the cost of a subscription.
Lifespan
- Single Use
- A one-time flat discount. Any discount amount over the initial purchase total is disregarded.
- Forever
- A recurring discount that will be applied to each billing cycle.
- Limited Time
- A recurring discount that is only valid for a specified number of months.
Constraints
- Limit to Plans
- Allows a coupon code to be applied to select subscription plans or all plans (including those subscription plans created in the future).
- Max Redemptions
- The maximum number of times a coupon can be used before it expires.
- Redeem-by Date
- The date/time through which a coupon offer is valid for redemption.
Other Settings
- Hosted Payments Page Description
- A short description that will display on the Hosted Payments Page.
- Invoice Description
- A more detailed description of the coupon offer that appears on the customer invoice.
Updating Coupons
Once a coupon has been created, it cannot be modified.
Deleting Coupons
A coupon can be deleted from the main coupon view page. Once deleted, the coupon will move to the “Expired Coupons” view and is no longer eligible for redemption.
Coupon Invoice Display
Coupons will display as an invoice subtotal “discount” amount.
Applying Coupons
Coupons are only applied to recurring charges. They will not apply to one-time charges on an account. The only exception is one-time setup fees with dollar-off coupons. If a subscription is $10 a month with a $25 setup fee, the initial invoice will be $35. A percentage-off coupon will only apply to the $10 recurring portion. A dollar-off coupon will apply to the full $35 on the initial subscription invoice. When the subscription renews, both types of discounts will only apply to the recurring charge.
Redeeming Coupons
Coupons can be redeemed from a user’s account through the Recurly admin console, via the API, or on the Hosted Payments Page. A account can only have one active coupon at a given time.
Removing Coupon Redemptions
Coupons can be removed from a user’s account either through the Recurly admin console or the API.