Handle Duplicate Voucher Codes

Learn how CleverTap handles duplicate voucher codes to maintain data integrity and prevent redemption conflicts.

Overview

To maintain data integrity and prevent redemption conflicts, CleverTap enforces strict duplicate checks when uploading voucher codes. The system validates voucher codes based on the combination of List Tag and Partner across all active voucher lists (lists that are not archived).

This document outlines the rules, scenarios, and best practices for handling duplicate voucher codes in CleverTap.

Duplicate Voucher Code Rules

CleverTap follows a structured approach to prevent duplicate voucher codes while ensuring flexibility where needed.

Duplicate Voucher Codes Blocked

CleverTap prevents duplicate codes within the same partner and list tag to avoid unintended voucher conflicts and redemption errors.

  • A voucher code cannot be uploaded again within the same voucher list (if the List Tag and Partner are the same).
  • A voucher code cannot be uploaded to another list under the same Partner if the List Tag already contains that code in any active voucher list.

The following table illustrates different scenarios of voucher code duplication across lists. The Available Codes column represents the existing codes in active voucher lists, helping you verify duplication before uploading new codes.

List NamePartnerList TagAvailable CodesCodes UploadedDuplication Allowed?
List DPartner AList Tag ACode1, Code2, Code3Code1, Code2, Code3Not Allowed (Same Partner and List Tag)

Duplicate Voucher Codes Allowed

In certain cases, CleverTap permits duplicate codes to enable cross-partner distribution and list reusability. This ensures businesses can manage vouchers effectively without unnecessary upload restrictions.

  • A voucher code can be uploaded under the same List Tag but with a different Partner, as each partner operates independently.
  • Once a voucher list is archived, its codes are no longer checked for duplication, allowing the same codes to be uploaded again.

The following table illustrates different scenarios of voucher code duplication across lists. The Available Codes column represents the existing codes in active voucher lists, helping you verify duplication before uploading new codes.

List NamePartnerList TagAvailable CodesCodes UploadedDuplication Allowed?
List APartner AList Tag A-Code1, Code2, Code3Allowed (First-time upload)
List BPartner AList Tag BCode1, Code4, Code5Code1, Code4, Code5Allowed (Different List Tag under the same Partner)
List CPartner BList Tag ACode1, Code2, Code3Code1, Code2, Code3Allowed (Different Partner, different redemptions)
List EPartner AList Tag A (Archived)Code1, Code2, Code3Code1, Code2, Code3Allowed because List A is archived

Manage Duplicate Voucher Codes Across Partners

Consider a scenario where Customer X runs a New Year sale campaign and collaborates with multiple partners to distribute discount vouchers. Each partner, such as Partner A and Partner B, operates independently, managing their own set of voucher codes.

As each partner controls their own redemption platform, CleverTap enforces duplication checks within the same partner but allows the same code across different partners.

ScenarioActionAllowed?Reason
Uploading Code 1 under different partners
  • Code1 is uploaded under Partner A (similar to List A).
  • Code1 is uploaded under Partner B (similar to List C).



  • YesDifferent partners operate independently, preventing redemption conflicts.
    Uploading Code 1 again under the same partner
  • Code1 was already uploaded under Partner A (similar to List A).
  • Customer X attempts to upload Code1 again under Partner A in another active list (similar to List D).



  • NoPartner A already has an active list with Code 1. CleverTap prevents duplicates within the same partner across active lists.
    Re-uploading Code 1 after archiving the original list
  • Code 1 was in List A (archived).
  • Customer X attempts to re-upload Code 1 under a new list (similar to List E).



  • YesOnce a list is archived, its codes are no longer checked for duplication, allowing re-upload.