Skip to main content

Configure Promo Codes


Configure Promo Codes


Ensure that the Promotion Codes app is available under Marketplace in the left navigation panel of Zuora. See Install an App for more information.

Configure Promo Codes

Take the following steps to complete the configuration of the Promotion Codes app:

  1. Launch Promotion Codes from your Zuora tenant.
  2. In the Promotions tab, select Actions > New Promo Code to create a new promotion. The New Promo dialog is displayed.
  3. Set up a new promotion code or multiple promotion codes.
    1. Complete Promotion Details 
    2. Identify Eligible Rate Plans
    3. Configure Discount Rate Plans
    4. Add Custom Fields
  4. Click Create to save the configuration.

Alternatively, if you want to create multiple single-use codes via API, you can use the "Create a single use code campaign" operation listed in Swagger API Docs. The URL and credentials required to make requests are provided in the API Docs tab in Promotion Codes. 

Complete Promotion Details

  1. In the Promo Details tab, complete the following fields:
    • Effective From - Activation date of promo code
    • Effective To - Expiration date of promo code
    • Campaign - The name of the campaign that consists of a group of promotion codes.
    • Code Type - Determines if the code will be “1 multi-use code”, “many single-use codes”, or "Many multi-use codes".
      • 1 multi-use code - A single code specific for one promotion, but can be used by multiple customers. 
      • Many single-use codes - Numerous codes generated for one promotion. Each code is specific to one customer.
      • Many multi-use codes - Numerous codes generated for one promotion. Each code can be used by multiple customers.
  2. If you select 1 multi-use code for the Code Type field, complete the following fields: 
    • Initial Quantity - The amount of the codes that are initially issued. The value of this field cannot be changed after the initial configuration.
    • Available Quantity - The amount of the remaining codes that can be redeemed. 
    • Code - Identify code value to be linked to the campaign and will be utilized by customers
  3. If you select Many single-use codes or Many multi-use codes for the Code Type field, complete the following fields: 
    • Prefix - Characters or numbers that are placed before the app generated code.
    • Suffix - Characters or numbers that are placed after the app generated code.
    • # Auto-generated Characters - The number of characters for each generated code.
    • # Codes to Generate - The amount of the generated codes. An error message will be prompted if the number of auto-generated characters is insufficient to support the number of codes to be generated.
    • Redemptions per code - The number of times each code can be used. This field is available for Many multi-use codes.  

Identify Eligible Rate Plans

  1. Click the Eligible Rate Plans tab. 
  2. Select the rate plans where the promotion code campaign can be applied:
    • Apply to All - All active rate plans in your Zuora tenant can use the promotion code(s).
    • Apply to Select - Select the desired rate plan(s) in your Zuora tenant that can use the promotion code(s).
  3. If you click the Apply to Select button, you must select the desired rate plans in the dropdown list next to this button and click Add RatePlan. The selected rate plans are then added to the table. You can add multiple rate plans.  Eligible Rate Plans

Configure Discount Rate Plans

  1. Click the Discount Rate Plans to Add tab.
  2. Select a discount type. 
    • None - No discount will be applied to the selected rate plans.
    • Percent Discount Rate Plan - A percentage-based discount rate plan.
    • Fixed Amount Discount Rate Plan - A fixed amount discount rate plan.
  3. In the Product - RatePlan dropdown list, select the desired discount rate plan. Only the active product rate plans that contain only one discount charge of the selected discount type will be displayed. The information of the selected rate plan will be automatically populated as default.
  4. (Optional) Override the default information for the following fields:
    • Discount Percentage or Discount Amount - The discount percentage for percent discount rate plans or the discount amount for fixed amount discount rate plans
    • End Date - The end date for the promotion code.
    • Billing Period - The invoice billing period.

Add Custom Fields

  1. Click the Custom Fields tab.
  2. Click Add Field to add new key-value fields.
  3. Enter the key-value pair in the corresponding field. For example, enter country in the key field and United States as its value.
  4. Select the Require on Validate check box if you want to enable the additional validation for each promotion code. The validate API will require the key-value pair if the Require on Validate check box is selected. 
    Multiple fields can be added.

After multiple single-use promotion codes are generated, you need to assign these codes to different customers by updating the custom fields of the codes. The custom fields for single-use codes cannot be updated using the Edit action after the initial creation. If you want to assign single-use codes or update custom fields after the codes have been generated, you need to export the single-use codes, modify the CSV file locally, and then upload the file into the Promotion Codes app. See Assign Single-Use Codes for more information.


To help you better understand how a promotion code is configured, an example of the promotion code configuration is provided. See Example of Promo Code Configuration for more information.