Coupons let you create and distribute discount codes for subscriptions and one-time purchases. You control the discount type, duration, and how many times a code can be redeemed.

With coupons and coupon codes, you can:

  • apply discounts to all invoices, a single invoice, or for a set period
  • reduce the invoice total by a fixed amount or a percentage

You can also set an expiration date for coupons or limit how many times they can be redeemed across all customers.


Coupon

Coupons help customers save while supporting sales by converting into discounts during payment.

  • Billing 1.0 supports coupons for subscriptions only and cannot be used when taxes are applied.
  • Billing 2.0 supports coupons for one-time purchases at the invoice level.

They offer flexible configuration. You can apply either a fixed amount or a percentage discount. Duration options include one-time use, unlimited, or limited time. You can also set usage limits based on redemption count or a specific expiration date.

You learn how to define discount type, duration, redemption limits, and expiration dates to run effective promotions.

Name

In the dashboard, coupons are listed and identified by unique names. These names act as internal labels for easy reference and management, making coupon management easier. They are not visible to customers, but choosing descriptive and meaningful names is key for efficient management.

For example, a coupon providing a discount on a customer’s first purchase might be aptly named First Purchase Discount, clearly indicating its intended use. It is important to note that each coupon code name must be unique within the account scope. You cannot create multiple coupon codes with the same name unless one is archived.
Discount

Percentage and fixed amount are the main types of discounts. Each type functions differently in how it reduces the invoice amount. Understanding these differences helps you apply the correct type.

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.

For example, if a customer applies a 50% coupon to a $200 invoice, the discount is $100, lowering the invoice to $100.

For example, for a “20% off on your first purchase” promotion, if a customer opts for an online course costing $50, the coupon grants them a $10 discount, which is 20% of $50.

If a 100% discount is applied to the invoice, the purchase is not entirely free. The customer is charged the minimum currency unit.

For example, if a 100% discount is applied to a $12 purchase, the customer is charged 1 cent.

Fixed amount

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

For 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. For example, a coupon with a fixed amount of $25 would reduce the customer’s invoice by $25, regardless of the total amount.

As with percentage discounts, the purchase is not entirely free for the customer when using this type of discount. The fixed discount amount may exceed the total value of the purchase.

For example, a $20 off coupon applied to a $15 purchase would result in the minimum charge of the currency unit, such as 1 cent.

There is no option to set a minimum purchase value to apply these discounts.

Duration

Choose the duration type that matches your promotion goals.

Once

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

For example, if you offer a $10 one-time discount, the coupon reduces the first invoice by $10. After that, the coupon becomes inactive for that subscription.

Forever

Choosing this duration means the discount is applicable continuously for as long as the subscription remains active.

For example, if you have a $5 ‘Forever’ discount on a $20 monthly subscription, the customer pays $15 as long as the subscription is active.

Limited time

You can use this setting to specify the number of billing cycles during which the coupon remains active. It is well-suited for seasonal promotions or limited-time offers.

For example, if you want to offer $5 off for three months of a subscription, you would set the Duration to ‘Limited time’. In this case, the discount is applicable for the first three months, after which the subscription reverts to its original price.
Redemptions limit

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 usage of a coupon but does not support per-customer redemption limits.
Expires at

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

To create a coupon, specify the discount type, amount, duration, and optional redemption limits or expiration date.

Coupon code names must be unique within an account. To reuse a name, archive the existing coupon first. Via Hub To create a coupon

  1. Go to Billing > Coupons.
  2. Click on the + Create coupon button.
  3. On the coupon information page, specify the required information:
    • Coupon name and description
    • Discount in percentage or fixed amount
    • Duration
    • Redemption limit
    • Expires at date
  4. Click on Create coupon to save a new coupon.

Delete coupon

When 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 is 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.
Via Hub To delete a coupon

  1. Go to Billing > Coupons.
  2. Find the coupon you need and click on it.
  3. In the top-right corner, click on Delete coupon.
  4. In the pop-up window, click on Delete to confirm.

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. This preserves a record of past transactions without allowing further changes.

Coupon statuses

Coupon statuses indicate whether a coupon is available, expired, fully redeemed, or archived.

Coupons list view
Value Description Implications
active The coupon has been created and is available for use. Customers can apply this coupon to purchases for discounts. You can still edit coupon parameters unless the coupon 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 customer. 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 that customers enter at checkout to apply discounts. Created in the internal coupon system, they represent the customer-facing discount tool. Using them applies discounts based on coupon settings.

They can be distributed through different 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.

Code

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 is essential to maintain a level of complexity to deter unauthorized use.

For 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.
Redemption limit

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

For example, if a coupon code has a limit of 3, it can be redeemed only 3 times.

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

The system tracks the usage of each coupon code. Per-customer redemption limits are not supported.

Expiration date

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 expires at the specified date and time, in accordance with the time zone of the account.

For example, each coupon code can have a distinct expiration date, provided it falls within the validity period of the parent coupon.

Create coupon code

In the Solidgate Hub , you can manually create coupon codes or generate and upload coupon codes from a CSV file.

Via Hub To create a coupon code manually

  1. Go to Billing > Coupons.
  2. Find the coupon you need and click on it.
  3. In the Codes section, click on + Add code.
  4. In the form that appears, specify the coupon code information:
    • Enter the alphanumeric code to use for redeeming the coupon.
    • Optionally, set the Redemption limit to control the code usage count.
    • Optionally, set the Expires at date to specify when this code becomes invalid.
  5. Click on Add to add the code to the coupon.


To generate and upload coupon codes

  1. Go to Billing > Coupons.
  2. Find the coupon you need and click on it.
  3. In the Codes section, click on + Add code.
  4. In the appeared form, select Upload coupon codes.
  5. Prepare a file with coupon codes.
    The file must follow the format provided in the sample:
    • Download a sample generator file to meet the requirements for the file data format.
    • Follow the instructions in the file to create coupon codes.
  6. Click on Upload your coupon codes to add a file with the codes.
  7. Once the file is uploaded, click on Add to confirm the upload of the coupon codes.
Coupon code upload restrictions
  • Each coupon code has a redemption limit equal to 1 and follows the coupon expiration date.
  • The file must be in CSV format and contain only coupon codes.
  • Coupon codes must consist solely of letters and numbers.
  • Each coupon code in the file must be unique.
  • The limit is 1,000 coupon codes per file. For more coupon codes, upload additional CSV files.

Delete coupon code

If you need to delete a coupon code, be aware that once deleted, the coupon code is removed from the listing and cannot be restored.

Via Hub To delete a coupon code

  1. Go to Billing > Coupons.
  2. Find the coupon you need and click on it.
  3. In the Codes section, find the coupon code you want to delete.
  4. Hover over the coupon code and click on Delete.
  5. In the pop-up window, click on Delete to confirm.

Coupon code statuses

Coupon codes also have statuses that indicate their availability and whether they have been redeemed. Understanding these statuses helps you manage coupon campaigns.

Coupon creation form
Value Description Implications
active The coupon code has been created and is ready for use. Customers can apply this coupon code to purchases for discounts. You can still edit coupon code parameters unless the coupon code 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 are still 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 cannot be used for further discounts. Existing redemptions remain valid.
archived The coupon code has been archived either manually by a customer 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 cannot be applied to new transactions or modified in any way.

Discount usage

Coupons can be applied automatically to an order (predefined) or redeemed by the customer using a code (direct). For trial-based products, discounts apply to the first recurring payment after the trial, not the trial itself. Coupon behavior also varies depending on whether the subscription is paused, cancelled, or restored, and when applied mid-cycle.

Edit coupon and coupon codes

Coupons and coupon codes have limited editing options after creation.

  • After you create a coupon, you can update only its name and description.
  • After you create a coupon code, you cannot edit it.