Assign Single-Use Codes

Knowledge Center > Commerce > Promo Codes > Assign Single-Use Codes

Assign Single-Use Codes

Table of contents
No headers

The custom fields required for recognition can either be manually entered after the initial creation or entered during the initial setup of the promo code in custom fields. Take the following steps to assign single-use codes:

  1. In the Promotions tab, click  in the line of the promo code that you want to configure and select Export Single Use Codes
  2. Click the Background Jobs tab. All background jobs will be displayed.
  3. Click  of the desired export job and select Show
  4. In the Job Details dialog, click the file link to download the exported CSV file. 
  5. Add or modify the custom fields in the following columns in the exported CSV file, and then save the file.
    • CustomFields.fieldKey - Determines how the customer will be identified by the system when using the promo code, for example, email, phone number, name, and so on.
    • CustomFields.fieldValue - The customer specific information for the selected field.
    • CustomFields.validateRequirement - Each custom field must have a value for this column.
      • True - A customer must enter the specified key-value pair in order to validate and apply the promo code discount.
      • False - The specified key-value pair does not need to be validated for a promo code discount to be applied.
        Manually Edit Custom Fields
  6. Upload the configured CSV file.
    1. Navigate to Background Jobs > Actions > Import - Update Single Use Codes.
    2. In the "New Single Use Codes - Update Job" dialog, click Upload File.
    3. Select the configured CSV file.
    4. Click Create. The file is then uploaded.
Last modified


This page has no custom tags.


(not set)