Discounts getting started


Recharge discounts have been created with flexibility in mind while trying to keep simplicity and clarity for discount management so you can create different discounts quickly and easily.

   Creating discounts

Discounts are often a part of a marketing campaign or a loyalty program. Before creating a discount, make sure you have taken the time to consider the rules for how it will be applied.

Here is a checklist for you to use when considering how you want to set up your discounts.

     Discounts checklist

Gather some context (understanding why and what we are creating will help put things in context and ensure the discount(s) created fit(s) the purpose)
  • Do we want to use individualized codes for discounts?
  • What naming convention do we want to use for the discount?
  • What is the amount we want to assign the discount?
What do we want the discount to be about?
  • What is the discount worth? (e.g. $10, 25% off, free shipping)
  • What products or collections should be promoted with the discount?
  • Do we want to set specific conditions for the discount?
  • For new customers only?
  • Is there a minimum order amount we want to set?
What types of products or collections do we want to have the discount applied to?
  • All product types
  • One-time products
  • Subscription products
Do we want to limit where the discount can be applied?
  • Merchant Portal
  • Customer Portal
  • API
Do we want to specify specific usage limits to the discount?
  • Can the discount be applied to more than one charge?
  • Should the discount only be applied when a certain charge amount has been reached?
  • Do we want to restrict the discount to only one product, or multiple products?
Time validity
  • When do we want to have the discount begin?
  • Do we want to have an end date for the discount?

     Discount creation using the Merchant Portal

A discount created using the Merchant Portal gives you the opportunity to interact with it visually as it is being created.

For detailed instruction on how to navigate the Merchant Admin portal, please refer to our panel guided tour, which can be found on the Discounts In Depth page.

     Discount creation using the Recharge API

A discount may also be created programmatically using the Recharge API, allowing you to speed up the creation process, while still enabling your team to customize the discount to your specifications. You can find detailed information about how to create a discount using the Recharge API, as well as the discount creation process, in the Create a discount section of the Recharge API Reference Guide.



You can create large numbers of discount codes in one batch using the Async Batch resource. Using this resource, you can process large volumes of operations asynchronously. For more information on how to use the Async Batch resource, refer to the Async Batches section of the Recharge API Reference Guide.

Applying discounts

You can apply a discount in several different ways and in different channels, giving you flexibility in how you choose to manage discounts. Recharge discounts can be applied in the following ways:

  • at the time of checkout
  • in the Customer Portal
  • in the Merchant Portal
  • automatically via 3rd party app integration


A discount may be automatically applied at the time of checkout to ensure a smooth checkout experience for a customer. When a customer reaches the checkout page (similar to the example shown below), they can enter the discount code either on the Shipping or Billing pages (it does not matter which of these pages they use to enter the discount code).

During the checkout process, the discount code is validated to ensure it can be applied to the order.




It does not matter whether you choose to use the UI or Recharge API for a discount; discount codes are validated in the same way.

For more detailed information about how a discount can be applied automatically at checkout, please refer to the In Depth section of this guide.

   Customer Portal

Enabling a customer to apply a discount themselves in their Customer Portal provides a greater level of management and control over their current and future orders.

You can also manage how discounts are applied by logging into your Merchant Portal. Once you are logged into your Merchant Portal, click on the Storefront link and select Customer Portal. You will see a Discounts section where you can select two different checkboxes.

  • Selecting the ‘Allow customers to input discount code on customer portal’ checkbox enables users to add discount codes on their own in their customer portal.
  • Selecting the ‘Remove discounts from customer addresses after discount limit has been reached’ checkbox removes discounts once the discount limit has been reached.

   Merchant portal

The Merchant Portal is the place where you view and manage discounts applied for your customers. You can add the discount code by navigating to Customer ->Address ->Additional Info & Settings and entering the discount code in the Add Discount code field.


   3rd party app integration

Discounts may also be applied by certain 3rd party apps on a merchant’s behalf to help with lifetime value (LTV). Recharge has not only partnered with apps that can provide value to your customers, but has also created several of its own apps that can extend the ability to automate discount applications.

In the Merchant Portal integration, the apps shown below, along with others, make use of discounts to grow a customer’s LTV.

  • Klayvio
  • LoyaltyLion
  • ReferralCandy
  • Alloy
  • Recharge SMS

   Managing discounts

The Merchant Portal was designed to be intuitive and easy-to-use so you can manage your discounts without requiring complex actions and tasks. You can perform the following actions when working with discounts:

  • edit
  • deactivate
  • fully disable
  • delete

     Edit discount code

You can edit a limited set of attributes for existing discounts using the Edit function. For detailed information about how to edit a discount, please see the Editing discount codes page in the Recharge Help Center.

     Deactivate discount code

Deactivating a discount code allows you to prevent any further use of that discount for new charges; while the code remains active in charges where it has already been applied to (e.g. the discount is supposed to last for a certain number of future charges). For detailed information about how to deactivate a discount, please see the Deactivating discount codes page in the Recharge Help Center.



You may reverse this action by selecting the discount code and clicking on the reactivate discount code option.

     Fully disable discount code



Choosing the fully disable discount code option moves the discount code into the fully_disabled state, which carries with it significant implications. The discount will no longer be applied to any new charge and will also be removed from any queued charge. While you may reverse this action later, the discount will not be re-applied to addresses that it had been applied to before the discount was disabled.

     Delete discount code



If you choose to delete the discount code, the discount will be immediately removed from the Recharge system. One this action is performed, this action cannot be undone.

For a detailed explanation of the complete discount lifecycle and its different states, refer to the Discounts Overview page.

Need Help? Contact Us