Coupons

Coupons
Create percentage and fixed-amount discounts with redemption codes, duration rules, and usage limits for subscriptions and one-time sales

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.


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.
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.
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
ValueDescriptionImplications
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.

Create coupon code

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

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.

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
ValueDescriptionImplications
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.

Looking for help? Contact us
Stay informed with Changelog