Use coupons to reward customers, generate sales, or to test new pricing strategies. Coupons enable you to apply different types of discounts to invoices, subscriptions, and pricing plans.

Redeemed coupons are attached to a customer's account. Depending on the coupon restrictions, the redeemed coupons are then applied from the customer's account to subsequent invoices or subscriptions. Redeemed coupons can only be applied to invoices of the same currency.

Once a coupon is redeemed it cannot be modified. You may deactivate a coupon or create a new coupon, but you cannot reuse the same coupon code. If you have a use case where you must reuse the same code, contact Rebilly.

Coupon restriction types

The following coupon description types are available:

• restrict-to-countries: Restricts a coupon for use in specific countries.
• discounts-per-redemption: Restricts the number of times that the coupon can be applied by one redemption. For example, use this restriction to configure a coupon that can only be applied to the first subscription renewal of a particular product.
• minimum-order-amount: Sets a minimum order amount for a coupon application. For example, if the restriction amount is $20, the coupon is only applied to invoices with a total amount of $20 or more.
• restrict-to-invoices: Restricts a coupon to specific invoices.
• restrict-to-plans: Restricts a coupon to specific pricing plans.
• restrict-to-subscriptions: Restricts a coupon to specific order subscriptions.
• restrict-to-customer-tags: Restricts a coupon to customers with specific tags.
• restrict-to-customers: Restricts a coupon to specific customers.
• restrict-to-exclusive-application: Restricts a coupon so that it cannot be used in combination with other coupons. If more than one coupon is active, a coupon with this restriction is only applied if it provides a larger discount than the other coupons combined. If a coupon with this restriction is applied, all other coupons are removed.
• restrict-to-products: Restricts a coupon to specific products.
• paid-by-time: Specifies a date and time at which a coupon redemption expires if not paid.
• redemptions-per-customer: Restricts the number of times that a coupon can be redeemed by one customer. For example, use this restriction to limit the number of redemptions to one per customer.
• total-redemptions: Restricts the number of times a coupon can be redeemed by different customers.
• restrict-to-bxgy: Provides "buy X get Y" promotions. These promotions incentivize new customers to buy and also reward existing customers. This restriction type enables you to add discounted plans to an invoice when a certain quantity of other plans are purchased. For example, if a customer buys two or more books, they get one free bookmark.