Player Enrollments¶

An Enrollment is the record that links a specific player to a Reward. Without an enrollment, a player cannot access their free bets.

Enrollment Lifecycle¶

When a player is enrolled, their status changes based on their interaction with the reward.

stateDiagram-v2
    [*] --> New
    New --> Active: Start Date Reached
    Active --> Claimed: All Bets Used
    Active --> Expired: Time Ran Out
    New --> Cancelled: Manual Action
    Active --> Cancelled: Manual Action
    Claimed --> [*]
    Expired --> [*]
    Cancelled --> [*]

How to Enroll Players¶

Manual Enrollment¶

Used for one-off gestures, such as rewarding a player for a customer service issue. You select a single player and assign them a reward.

Bulk Enrollment¶

Used for large marketing lists. You upload a list of player IDs to the backoffice.

CSV Enrollment with Overrides¶

When using Ranged Free Bets, you can provide specific values for each player in your list.

CSV Format Example:

OperatorPlayerId,BetValue,BetCount
player_001,2.50,10
player_002,5.00,5
player_003,1.00,20

Validation Rules:

• BetValue: must be between the Reward's Min and Max Bet Value.
• BetCount: must be between the Reward's Min and Max Bet Count.
• If you use a Fixed Free Bet reward, you only need to provide the OperatorPlayerId.

Bulk Job Lifecycle¶

When you upload a bulk enrollment list, it is processed in the background as a "Job".

1. Pending: The job is waiting to start.
2. Processing: The system is validating each player and checking budgets.
3. Completed: The job is finished. You will see a summary of successful enrollments and any rejections.
4. Failed: The job encountered a system error (rare).