Promo Code Activations in IZI

Promo Code Activations: Full Usage Log Across Your Club Network

The Activations section in IZI CRM is a timestamped log of every promo code redemption across your entire organization. Each record captures the activation date, the client (player), the club where it happened, the promo code used, and the bonus amount credited to the player’s balance. The list consolidates data from all clubs in your network into a single view you can filter and export. Activations are created automatically — when a player enters a code in the mobile app or at the front desk, IZI runs a series of checks (is the promo campaign active, is the code available at this club, has this player already used it?) and, if everything passes, atomically credits the bonus and writes the activation record.

What Each Activation Record Contains

A successful activation writes the following fields:

CRM column	Contents
Activation date	Exact date and time of the event
Client	Player name, clickable to the client card
Club	The club where the activation happened
Promo code	The code string, clickable to the code card inside the campaign
Bonus	Amount credited to the player’s balance at the moment of activation

Clicking a row opens the detail card, which also shows technical identifiers — activation ID, client ID, and promo code ID — useful when contacting support or debugging integrations.

How the Activation Mechanism Works

Understanding what happens under the hood helps you interpret the data correctly.

Sequence of events

1. A player enters the code in the app or at the desk.
2. IZI looks up the promo code by string and organization.
3. The system checks the campaign: is it active, has the start date passed, has the end date not expired?
4. Club check: if the code has a club allowlist, the current club must be on it.
5. Uniqueness check: the pair (this promo code + this player) must not already exist — one player cannot activate the same code twice.
6. Limit check: if maxActivations is set, usedCount must be below the ceiling.
7. If all checks pass, IZI atomically creates the activation record and credits the bonus.
8. If the bonus credit fails, the activation is rolled back entirely — no orphaned records.

This means every record in the Activations log guarantees that the bonus was actually credited. There is no state where a player “activated but did not receive the bonus” in normal operation.

Failed activation attempts

Failed attempts do not appear in the log — no record is created. Possible rejection reasons:

• Promo code not found in the organization
• Campaign is archived or inactive
• Campaign period has not started yet or has already ended
• Code is not available at this club
• This player has already used this code
• Activation limit is exhausted

If a client says a code “did not work” but there is no record in the log, one of the checks above rejected the attempt.

Filters and Export

Available filters

The filter panel at the top of the section accepts any combination of conditions:

Filter	Purpose
From / To	Narrow by activation date range
Client	Show activations for one specific player
All Promo Codes	Select a single code for deep analysis
Clubs	Restrict to one or more clubs in the network
Bonus Amount	Set a from/to range for the credited bonus

Common filtering scenarios

Analyze a specific promotion. Open the Activations section, pick the target code in the Promo Codes filter, and see every client who used it — with dates and clubs.

Resolve a client support request. Set the Client filter to the player in question. You immediately see their full activation history, making it easy to confirm or refute their claim.

Compare clubs. Filter by club and date range to understand how promo codes perform at a specific location. Repeat for another club to compare uptake.

Find anomalies. Use the Bonus Amount range filter to surface activations with unexpectedly high bonus values — for example, if a high-denomination code was shared more broadly than intended.

Export

Click Export in the top-right corner to download all records matching the active filter. Without filters, the full history is exported. Typical uses:

• Importing into a spreadsheet for financial reconciliation
• Building campaign effectiveness reports
• Cross-checking with external loyalty systems
• Sharing raw data with your marketing team

Permissions

The Activations section is visible to CRM users with the PROMO_CAMPAIGN_READ organization permission. Creating and editing promo codes and campaigns requires PROMO_CAMPAIGN_WRITE. Both permissions are managed in user roles at the organization level.

How Activations Fit into the Full Promo Chain

Activations are the outcome layer of a three-part structure in IZI:

1. Promo Campaigns — the container: name, active period, club scope, status.
2. Promo Codes — individual codes inside a campaign, each with a bonus amount and an optional activation limit.
3. Activations (this page) — the ledger of actual uses: who redeemed which code, when, and at which club.

This separation lets you, for example, run a single campaign with hundreds of unique single-use codes (one per invited client) and then verify exactly who redeemed their offer — either here in the Activations log or through the client history view.