Coupon refers to a customizable discount on a subscription

Using coupons in your subscription-based business can attract new customers, increase their loyalty, and drive sales. Use these coupons to offer discounts on your subscription plans. In addition, you have the option to generate special codes that your customers can apply to get a discount on their subscription.

This feature is intended for recurring billing and subscription services only. It does not apply to once purchases due to the lack of trial periods for such purchases.

With coupons and their codes, you have flexibility:

  • Apply discounts to all invoices (note - invoices automatically generated by a subscription are records that detail the amounts owed to customers and track the status of payments from draft to finalization), a single invoice, or for a predefined period of time.
  • Reduce the total amount of an invoice by a fixed amount or by a certain percentage.
Additionally, you can set up coupons that need to be redeemed by a certain date or that have a maximum redemption limit for all customers.


To facilitate customer savings and promote sales, coupons can be converted into discounts during the payment process.

These coupons can have different configurations such as being a fixed amount or a percentage off, having various durations like once, forever, or limited time, and even having usage limitations based on the number of redemptions or specific expiration dates.

The following sections will guide you through the comprehensive management of coupons, including their creation, customization, and tracking. You’ll learn how to set parameters like discount type, duration, redemption limits, and expiration dates, all of which are crucial for executing effective promotional strategies.
chevron down chevron up
Coupon properties
This is an organizational unit in a payment or subscription system that connects an account to multiple shops for various types of transactions. It defines payment methods, environment settings, and rates, serving as a bridge between accounts and shops.

A single channel can host multiple shops, each specializing in a specific type of transaction like card payments, alternative payments, or subscriptions.

In the dashboard, coupons are organized in a list, each identified by a specific name. This name serves as an internal label for easy reference and management, but is not visible to customers. Including a descriptive and meaningful name can streamline the process of managing various coupons.

For example, a coupon offering a discount on a customer’s first purchase could be named “First purchase” to quickly identify its purpose.

Discounts can be categorized into two main types: percentage and fixed amount discounts. Each type functions differently in how it reduces the invoice amount, and understanding these differences is crucial for effective coupon management.

  • Percentage

This type of coupon reduces the invoice by a specific percentage. The discount amount is dynamically calculated based on the total value of the customer’s purchase.

Example: If you offer a 50% discount coupon and a customer applies it to a $200 invoice, the discount will be $100, reducing the invoice to $100.

For promotions such as “20% off on your first purchase,” if a customer opts for an online course costing $50, the coupon would grant them a $10 discount, which is 20% of $50.

  • Fixed amount

Unlike percentage discounts, this coupon type subtracts a fixed amount from the invoice. These coupons are usually applicable only once per billing cycle.

Example: If a customer has a $50 fixed amount coupon and their total invoice is $100, the coupon would reduce the invoice to $50.

The fixed amount is set in the currency of your choice, like $25 USD. For instance, a coupon with a fixed amount of $25 would reduce the customer’s invoice by $25, regardless of the total amount.

As of now, there is no option to set a minimum purchase value to apply these discounts, but we are working on it.

  • Once

With this setting, the coupon applies a discount only once and is not usable again after being redeemed. It’s particularly useful for promotions targeting new subscriptions or one-off purchases.

Example: If you offer a $10 once discount, the coupon will reduce the first invoice by $10. After that, the coupon becomes inactive for that subscription.

  • Forever

Choosing this duration means the discount will apply continuously for as long as the subscription remains active. This can be an effective way to retain customers over an extended period.

Example: If you have a $5 ‘Forever’ discount on a $20 monthly subscription, the customer will always pay $15 as long as the subscription is active.

  • Limited time

The number of billing cycles during which the coupon remains active can be specified. This setting is well-suited for seasonal promotions or limited-time offers.

Example: If you want to offer $5 off for three months of a subscription, you would set the Duration to ‘Limited time’. The discount will apply for the first three months, after which the subscription will revert to its original price.

It’s essential to choose the appropriate Duration type to align with your marketing objectives and customer engagement strategy.

The redemption limit sets the maximum number of times a coupon can be used. For example, a limit of 5 means the coupon expires after 5 redemptions. This limit counts redemptions across all customers.

The system tracks each coupon’s usage but does not currently support per-customer redemption limits.

The expiration for a coupon can be set to a specific date and time. The coupon becomes active immediately and remains so until the chosen expiration time.

The time zone for the expiration period is determined in relation to the account.

Create coupon

Create coupons in the HUB:

  • On the subscription tab, open the Products (new Hub) section
  • Open Coupons page
  • Click + Create coupon
  • Provide the coupon information, including the coupon’s parameters
  • Click Create coupon

Delete coupon

When it comes to deleting a coupon, there are certain limitations and considerations to keep in mind:

  • No Redemptions
    The coupon can be freely deleted when it has not been redeemed by any customer.
  • Irreversible action
    Once a coupon is deleted, it will be removed from the coupon listing and cannot be restored. This makes it unavailable for any future uses. Additionally, deleting a coupon also removes all its associated coupon codes.

It’s important to be certain about your decision before proceeding with the deletion, especially because this action is irreversible and may impact ongoing promotional strategies.

Archive coupon

If a coupon has been redeemed one or more times, the only option available is to archive it, rather than delete it.

  • Visibility
    An archived coupon remains visible in the coupon listing for record-keeping purposes.
  • Immutability
    Once archived, no further actions or modifications can be performed on the coupon. It becomes a read-only item in your system. Archiving a coupon also archives all its associated coupon codes.

Archiving allows you to retain a history of used coupons while preventing any further redemptions or modifications, thereby safeguarding the integrity of past transactions.

Coupon statuses

Status Description Implications
Active The coupon has been created and is available for use. Customers can apply this coupon to eligible purchases for discounts. The parameters of the coupon can still be modified unless it has been redeemed.
Expired The coupon has reached its set expiry date and is no longer valid. Customers can no longer use this coupon for new purchases. Existing redemptions prior to the expiry date remain valid.
Utilized The coupon has reached its maximum number of redemptions as set in the redemption counter. The coupon is automatically deactivated and cannot be used for further discounts. Existing redemptions remain valid.
Archived The coupon has been manually archived by an administrator or user. The coupon remains visible in the system for record-keeping but becomes read-only. It cannot be applied to new transactions or modified in any way.

Coupon code

Coupon codes are alphanumeric strings designed for customer use at checkout to apply specified discounts. Created within an internal coupon management system, these codes are the customer-facing component that allows for the application of discounts as defined in the coupon’s settings.

They can be distributed through various marketing channels and are entered by customers during the checkout process. These codes offer a flexible way to incentivize purchases, attract new customers, and measure the effectiveness of promotional campaigns.
chevron down chevron up
Coupon code properties

The code is an alphanumeric string that serves as a unique identifier for the discount, which customers can enter during the checkout process. While the code should be memorable for easy customer recall, it’s essential to maintain a level of complexity to deter unauthorized use.

Example, instead of using a straightforward code like FIRST20 for a 20% first-time purchase discount, a more secure alternative could be F1RST20XyZ. This adds an extra layer of security while still being relatively easy for genuine customers to remember.

The redemption limit for coupon codes defines the maximum number of times each individual code can be redeemed.

Example: If a coupon code has a limit of 3, it can be redeemed only three times.

Each coupon code’s limit cannot exceed the coupon’s total redemption limit, but multiple coupon codes can each have their own individual limits, based on your marketing strategy.

The system tracks the usage of each coupon code but, as of now, does not offer the option to set redemption limits per customer for each code.

Each coupon code can have its own expiration date and time, which cannot exceed the overall expiration date set for the parent coupon. Once set, the coupon code becomes active immediately and will expire at the specified date and time, in accordance with the account’s time zone.

Example: Each coupon code can have a distinct expiration date, provided it falls within the validity period of the parent coupon.

Create coupon code

Create coupon code in the HUB:

  • In the HUB on the Coupon information page in Codes block, click the + Add code button
  • A form will appear. In this form, enter the alphanumeric code you’d like customers to use for redeeming the coupon
    • Optionally, you can set a Redemption limit to control how many times this specific code can be used
    • Optionally, you can also set an Expires at date to specify when this code will no longer be valid
  • Once you’ve filled in all the necessary fields, click the Add button to add the code to the coupon

Delete coupon code

If you need to delete a coupon code, be aware that certain limitations apply.

Once deleted, the coupon code will be removed from the listing and cannot be restored.

Coupon code statuses

Status Description Implications
Active The coupon code has been created and is ready for use. Customers can apply this coupon code to eligible purchases for discounts. The parameters of the coupon code can still be modified unless it has been redeemed.
Expired The coupon code has reached its expiry date and is no longer valid. Customers can no longer use this coupon code for new purchases. Any existing redemptions made before the expiry date will still be honored.
Utilized The coupon code has reached its maximum number of redemptions as set in the redemption counter. The coupon code is automatically deactivated and can't be used for further discounts. Existing redemptions remain valid.
Archived The coupon code has been archived either manually by a user or because the parent entity (the coupon) has been archived. The coupon code remains in the system for record-keeping purposes but becomes read-only. It can't be applied to new transactions or modified in any way.

Applying a discount

There are two primary ways to apply discounts to customer subscriptions: the predefined and the direct flow.

These two approaches offer flexibility in how you can incentivize customers to make purchases or commit to subscriptions.

Predefined flow

In this method, you can add a coupon directly to a customer’s order. There’s no need for coupon codes; the discount is applied “behind the scenes.”

Example, you wish to offer a time-sensitive deal, such as a 30% discount on cart items for the first three months if the payment is completed within the next 10 minutes. Instead of customizing new prices in the system, you can set up a coupon and apply it directly to the customer’s order.

For information on how to apply the coupon to an order, consult the Guide
In this flow, the coupon ID is embedded and encrypted in the paymentIntent during payment initialization. Once the form is initialized, the applied discount will already be present.
documentation available here

Direct flow

In this approach, customers can redeem coupon codes to get discounts on their subscriptions. They can enter the code at checkout to receive the discount.

Example, you create a coupon offering a 15% discount for the next two months and generate a coupon code for it (SUMSALE15OFF). Customers receive this code via email or another notification channel. The checkout page includes a designated field where customers can enter the code to apply the discount.

Detailed guidance on how to integrate this option into your checkout process is Guide
In this flow, the coupon code is applied after the payment form has been initialized using a special applyCoupon method.
available here

Coupon info

This section provides guidelines on editing coupon details and understanding how discounts interact with trial subscription options.

Editing сoupons

Currently, neither coupons nor coupon codes are available for editing.

Once a coupon is created, its editable fields are limited to the following:

  • Name
  • Description
Coupon codes themselves do not have an option for editing.

Handling discounts with trial options

For products that feature a trial period, discounts from coupons will not be applied to the trial price. Instead, the discount will take effect on the subsequent recurring payment.

In situations where the coupon’s expiration date precedes the next recurring payment, the system will preserve the discount for that particular payment.

Example, let’s say a product costs $20 and offers a 1-month trial. If a coupon with a “once-duration” setting expires in the next 20 days, and a user applies this coupon to their subscription, the coupon’s discount will be applied to the first recurring payment after the trial period, regardless of its expiration date.