Skip to main content

Reward Codes

Reward codes are unique codes generated and delivered to customers when they redeem a catalog reward that requires a code — for example, a partner voucher, a digital gift card, or a subscription code.

How It Works​

  1. Customer redeems a reward that has codes attached.
  2. Loyal Guru assigns a unique code from the available pool to the customer.
  3. The code is delivered via the customer-facing channel (app, email, or SMS).
  4. The customer presents or enters the code to claim the item.
  5. Code inventory is consumed in order (FIFO). When the pool runs out, redemption fails until new codes are uploaded.

Code Types​

TypeDescription
Single-useEach code can only be assigned to one customer
Multi-useA shared code any customer can use (e.g. a partner discount link)

Configuration​

Go to Loyalty and Promotional engine → Rewards → [Reward] → Codes tab in the Owner App.

Uploading Codes​

Codes are uploaded as a batch via CSV:

  1. Navigate to the reward detail page and open the Codes tab.
  2. Click Upload external codes (CSV file).
  3. Select a CSV file — one code per line, no header.
  4. After upload, the file name and size are confirmed on screen.
  5. The reward list displays Remaining codes to track inventory at a glance.
info

Upload new batches before the remaining code count reaches zero to avoid redemption failures for customers trying to redeem.

Code Inventory Visibility​

The rewards list includes a Remaining codes column that shows live inventory for code-type rewards. This allows operations teams to proactively refill before stock depletes.