Generate, import and export codes

Give a campaign its codes: generate up to millions, import codes you already have, export them with QR links to print or send, and delete ones you don't need.

For: Admins

Code states

StateMeans
PendingCreated, not given to anyone yet. Print it, hand it out, or give it to a customer later.
AllocatedGiven to a customer (by email, phone or recipient ID), waiting to be redeemed.
RedeemedUsed. A code can be redeemed once.
ExpiredCancelled by hand, or unused when the campaign ended. Can't be redeemed.

Codes in a campaign's menu counts each state. When a campaign ends, its unused codes become Expired; if you extend the end date, they become usable again.

Generate codes

  1. Save the campaign with the prefix and code length you want, then open Codes in its menu.
  2. Under Generate codes, enter how many (1 to 5,000,000) and click Generate.

New codes are Pending. Export them to print or hand out, or give them to customers later. If the prefix and length don't allow enough unique codes, you're told how many were added: increase the code length and generate the rest.

Import codes you already have

  1. Prepare a .csv or .txt file with one code per line. Only the first column is used.
  2. Under Import existing codes, click the box to choose the file (or drag it onto the box) and check the preview. Tick First row is a header if the first line is a column name.
  3. Click Import.

Imported codes are Pending. Codes your company already has, in any campaign and in any letter case, are skipped, so running an import again is safe. Codes that are empty, longer than 64 characters or contain spaces are counted as invalid and skipped.

Codes are unique across your company, ignoring case: SUMMER10 and summer10 are the same code. The scanner finds a code in whichever campaign it belongs to.

Export codes

  1. Under Export codes, choose All states or one state.
  2. Keep QR code links ticked to add a link to each code's QR image.
  3. Click Export CSV and stay on the page. The file downloads when it's ready.

The file has each code's status, customer, recipient ID, redemption time, wallet pass link and (if ticked) QR link. QR links keep working until a year after the campaign ends, and messaging apps such as WhatsApp can show them.

Delete codes

  1. Under Delete codes, choose a state, for example PENDING to remove codes nobody has received. REDEEMED and All states can be chosen once the campaign has ended: until then, redeemed codes are the record of what was used and who won its prize draws.
  2. Type the campaign name exactly as it is written.
  3. Click Delete … codes.
Deleting removes the codes for good, with their redemption history, and analytics stop counting them. There is no undo.

Plan limits

Every generated, imported or issued code counts towards your plan's vouchers per month. If a batch would go over, none of it is created. See Plans, billing and limits.

Next guideIssue vouchers to a customer list from CSV or Excel