> For the complete documentation index, see [llms.txt](https://docs.terragon.io/documents/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.terragon.io/documents/terragon-manual/solutions/player-module.md).
# Player Module
## **Introduction**
Welcome to the **Player Page Module Documentation** for Terragon’s Back Office. This guide is designed to provide you with clear and concise information on how to manage and optimize player accounts. Whether you’re handling account verifications, tracking player activity, or managing VIP statuses, this documentation will serve as a helpful resource for all your back-office needs.
## **Overview**
The **Player Page Module** is a central component of our backoffice system, offering tools to manage all aspects of player accounts. It allows you to access detailed player profiles, handle KYC verification requests, manage VIP schemes, create players in batches, and much more. The module is designed to streamline your workflow, ensuring that all player data is organized, secure, and easy to access.
**Key Features**
* **Player Profiles:** Access and manage comprehensive player information.
* **KYC & Compliance:** Handle KYC requests to ensure adherence to industry regulations.
* **VIP Management:** Track VIP statuses and customize loyalty programs.
* **Tag Management:** Organize players using custom tags for better segmentation.
* **Batch Player Creation:** Add multiple players at once for quicker onboarding.
* **Player Interaction:** Enable tipping, manage restrictions, and promote responsible gaming.
* **Full Audit Trail** – Game logs, action logs, and activity breakdowns.
\
Whether you are a part of the **compliance team**, a **VIP manager**, or a **customer support agent**, this module ensures that you have all the necessary information at your fingertips to deliver exceptional service and stay in line with regulatory standards.
## **Scope**
* [**Logic & Functionality**](#id-1.-logic-and-functionality)
* [**Player Page Features - Terragon Backoffice**](#id-2.-player-page-features-terragon-backoffice)
* [**KYC Requests**](#id-3.-kyc-requests)
* [**VIP Schemes**](#id-4.-vip-schemes)
* [**Boost VIP Management**](#id-5.-boost-vip-management)
* [**Tag Management**](#id-6.-tag-management)
* [**Create Player By Batch**](#id-7.-create-player-by-batch)
* [**Best Practices for Player Management**](#id-8.-best-practices-for-player-management)
* [**Compliance & Security Considerations**](#id-9.-compliance-and-security-considerations)
* [**Final Summary**](#id-10.-final-summary)
## **1. Logic & Functionality**
**How the Player Page Module Fits into the iGaming Backoffice**
At **Terragon**, the **Player Page Module** serves as the **core** component of our backoffice system, centralizing all player-related data in a single, easily accessible location. It acts as the **hub** where you can monitor, manage, and update player profiles, ensuring a smooth and efficient experience for both players and internal teams.
This module integrates seamlessly with other areas of our backoffice, facilitating effective communication across departments like **Customer Support**, **Risk & Compliance**, **Marketing**, and **VIP Management**. Each department can access relevant player information, track player behavior, and ensure that every player is managed in compliance with both internal policies and industry regulations.
By consolidating player data, our Player Page Module plays a key role in streamlining operations, increasing efficiency, and ultimately improving **player retention** and **engagement** across the platform.
**Core Data Structure & Key Player Attributes**
The Player Page Module is built around a strong **data structure** that stores and organizes key player attributes, allowing for effective player management and decision-making. These attributes are critical to maintaining a personalized and dynamic gaming experience while ensuring compliance and risk management.
Key player attributes in the Player Page Module include:
* **Basic Information:** Name, date of birth, email address, phone number, country of residence, and more.
* **Account Status:** Current status (Active, Suspended, Banned, Self-Excluded) and any ongoing actions.
* **Player Activity:** Transaction history, games played, betting behavior, recent logins, etc.
* **KYC Status:** Information on whether the player has completed KYC verification and if there are any pending documents.
* **Loyalty/VIP Status:** Details on the player's participation in loyalty programs, VIP tier, and associated benefits.
* **Responsible Gaming:** Information on tools or limits set by the player, such as deposit limits, self-exclusion, etc.
This data gives us a comprehensive view of each player, allowing us to make informed decisions, enhance personalization, and improve overall player experiences across the platform.
## **2. Player Page Features - Terragon Backoffice**
At Terragon, our Player Page within the backoffice serves as a central hub for managing player-related data, interactions, and account settings. This module provides a **comprehensive view of player activities**, allowing you to efficiently manage player profiles, monitor financial transactions, ensure compliance, and optimize user engagement. The Player Section is designed to offer **seamless navigation, detailed filtering options, and extensive management tools**, ensuring an intuitive and efficient workflow for you.
The Player Page consists of various **subsections**, each catering to different aspects of player management. From **searching and filtering players** to **monitoring wagering requirements and financial transactions**, this module plays a crucial role in providing a secure, data-driven, and user-friendly gaming experience.
### **2.1 Player List & Quick Filters**
The **Player List** page is the primary gateway to managing player data. This section allows you to **search, filter, and access player details** using various quick filter options. The available filters include:
* **Registration Date** – Search for players based on their sign-up date.
* **Player Username / Email / Name / Phone Number** – Find players using specific identifiers.
* **Account Status** – Active, Suspended, Banned, Self-Excluded, etc.
* **KYC Status** – Check players who have completed or are pending KYC verification.
* **Affiliate & Referral Information** – Track players referred via specific affiliate campaigns.
With these filters, you can quickly locate and manage specific player accounts, ensuring streamlined player administration.
### **2.2 Player Profile Overview**
Upon selecting a player from the list, you gain access to a **detailed player profile**, offering insights into account details, financial transactions, gaming activity, and more. The key sections include:
#### [Player summary](#id-2.2.1-player-summary)
#### [General Information](#id-2.2.2-general-information)
#### [Wagering Requirement](#id-2.2.3-wagering-requirement)
#### [History Data](#id-2.2.4-history-data)
#### [Activity Log](#id-2.2.5-activity-log)
#### [Responsible Gaming](#id-2.2.7-responsible-gaming)
#### [Player Notes](#id-2.2.8-player-notes-and-general-settings)
#### [General Settings](#id-2.2.8-player-notes-and-general-settings)
#### [Withdraw Options](#id-2.2.9-withdraw-options)
#### [Referrals](#id-2.2.10-referrals)
#### **2.2.1 Player Summary**
The **Player Summary** section provides a comprehensive overview of each player's account, offering key insights and actionable data. From this section, you can quickly access:
* **Main client information** – Includes the player's username, registration date, email, phone number, and account status.
* **VIP Level & Referral Details** – Check the player's VIP level, see by whom they were referred, and view their **referral code** and **affiliate ID**.
* **Status Management** – Update and edit the player's account status, activate or deactivate specific features, or impose account restrictions as needed.
* **Financial Activity Overview** – Track player balance changes, including:
* Deposits & withdrawals
* Claimed bonuses
* Total amount spent in the Casino
* GGR
* **Bonus History** – View all player bonuses, including:
* Bonus IDs and creation dates
* Bonus codes and awarded amounts
* Wager progress
* Filters for **date, status, award type (manual/automatic), and product type**
* **KYC, Affiliate Data,RAF codes** – Review the **KYC request list**, see verification statuses, and check if the player has referred friends. Additionally, view **affiliate-related data** such as marketing channels, sources, and campaign names and **RAF codes**.
This section serves as the **go-to place for a quick but detailed player overview**, helping you make informed decisions efficiently.
#### ***Global Player Actions***
Across all sections of the **Player Management** module, you have access to key actions that allow you to manage player accounts efficiently. These actions are available on every **player profile page** and include:
* **Manually adjusting player balances** – Modify the main or bonus balance when necessary.
* **Applying manual bonuses** – Grant bonuses individually, outside of automated systems.
* **Holding or processing withdrawals** – Hold withdrawal requests.
* **Banning player accounts** – Restrict access based on compliance or risk assessments.
* **Releasing OTP locks** – Assist players who are locked out due to some issues.
* **Kicking active player sessions** – Immediately kick out a player if needed for security or operational reasons.
These actions provide quick and effective ways to manage player accounts in real-time, ensuring smooth operations and compliance with platform policies.
#### **2.2.2 General Information**
This section provides a **comprehensive overview** of each player's profile within the system, helping operators manage accounts with ease and efficiency.
**Key Areas**
* **General Information**\
Displays core player details such as username, email, registration date, language, account status, and country. Operators can view player currency, VIP level, and signup source.
* **Affiliates**\
Shows affiliate-related fields including marketing source, campaign name, and referrer information (if applicable), offering a clear view of how the player was acquired.
* **Player Tags**\
Tags can be assigned to players to help categorize and segment them for internal management. Tags are organized by tag categories, and support flexibility for various operational needs.
* **KYC Status**\
This block provides a snapshot of the player's KYC (Know Your Customer) progress. If required, admins can request additional verification steps or document uploads.
* **Wallet Information**\
Lists the player's current wallets and balances, including the main wallet and any others linked to their account. Filter options allow quick search by currency type.
* **Bonus Program Points**\
Displays active bonus program balances associated with the player, allowing tracking of accumulation and reward eligibility.
* **Post-Wagered Bonus Points**\
Shows any earned progress under post-wagered bonus campaigns that are tied to longer-term reward systems.
* **Game Provider Usernames**\
Shows linked usernames for the player under different game providers, making it easier to track their in-game activities across platforms.
#### **2.2.3 Wagering Requirement**
The **Wagering Requirement** section allows you to track **bonus-related wagering conditions**. This section provides:
* A **breakdown of active wagering requirements** attached to player bonuses.
* Options to **adjust, waive wagering progress** if needed.
* Filters to search by **bonus type, status, or date range**.
you can ensure players meet all required conditions before withdrawing funds, maintaining fairness and compliance.
#### **2.2.4 History Data**
A crucial aspect of player management is reviewing **historical data**, which provides insights into player financial and gaming activities. This section includes:
#### **Financial Transactions**
* **Deposits & Withdrawals** – View all transactions made by the player, including amounts and payment methods.
* **Claimed Bonuses** – Track bonuses received, their activation dates, and wagering progress.
* **GGR (Gross Gaming Revenue)** – Monitor the player's contribution to overall revenue.
#### **Balance History & Game Logs**
* **Balance History** - Provides a **detailed log of all balance changes** over time.
* **Game Logs** - You can analyze spending patterns and detect potential irregularities.
#### **Action Logs & Point Histories**
* **Action Logs** – Tracks administrative actions performed by the operator on the player’s account.
* **Point Histories** – It's a history of points earned by the actions of players
These logs ensure transparency and facilitate auditing or dispute resolution when necessary.
#### **2.2.5 Activity Log**
The **Activity Log** provides a timeline of actions performed by the player, helping you analyze user behavior. This includes:
* **Login history** – IP addresses, device type, and login timestamps.
* **Channels used** – Whether the player accessed the platform via web, mobile, or desktop.
* **Player actions** – Deposits, bets, withdrawals, and bonus claims.
You can use this section for **fraud detection, security monitoring, and responsible gaming oversight**.
#### **2.2.6 Audit Log**
This is used to track all changes made to player profiles, including updates initiated from the backoffice by users and changes triggered by player actions on the site.
#### **2.2.7 Responsible Gaming**
For regulated markets, Terragon offers a **Responsible Gaming** section that enables you to enforce player protection measures. You can:
* **Set deposit, loss or bet limits** to promote responsible gaming habits.
* **Self-exclusion, Take a Break options** to restrict access for a specific period.
* **Close player accounts permanently** in cases of gambling addiction or regulatory compliance requirements.
This section ensures adherence to industry standards and responsible gaming commitments.
#### **2.2.8 Player Notes & General Settings**
You can add **internal notes** to a player’s profile, providing valuable context for future interactions. General settings allow for **modifications in account preferences and user permissions**.
#### **2.2.9 Withdraw Options**
* You can manually **create withdrawal options** (e.g., bank transfer, e-wallets).
* Monitor and manage **withdrawal requests**.
**Withdraw Options**
This section allows operators to manually configure and monitor all withdrawal-related activities linked to player accounts. Operators can manually create and manage various withdrawal methods such as:
* Bank transfers
* E-wallets
Each method can be tied to specific account types and adjusted for status, tracking, or updates. This flexibility allows platform admins to maintain accurate and secure withdrawal configurations per player or group level.
**Withdraw Transactions -** This table logs all withdrawal requests made by players, displaying essential data including:
* Country code
* Withdrawal method
* Requested amount
* Reference ID
* Request status
* Processing timestamps and admin handling
All entries are searchable, sortable, and include key audit information such as "Processed By" and platform used.
#### **2.2.10 Referrals**
The **Referrals** section provides a comprehensive overview of player referrals and their impact on the platform. Here, you can track key metrics such as:
* **Total Referrals Count** – The total number of players referred by others.
* **Total Referral Bonuses** – The cumulative bonuses awarded through the referral program.
* **Total Revenue** – The revenue generated from referred players.
Beyond just tracking numbers, this section allows you to **manage referral details** efficiently. You can see who referred whom, modify the **main referral plan** (adjusting the rewards per referred player), and ensure the program aligns with business goals.
Additionally, you can access **RAF codes** (Refer-A-Friend codes) and dive into detailed insights about each referred friend, including their activity and contributions to the platform.
## **3. KYC Requests**
The **KYC Requests** section is the second submodule under the **Players** module. This section allows you to manage and track player verification requests after they submit their KYC information. This has 2 main areas involved:
* **Backoffice**: where operators can collect KYC submission from players to verify and approve (or decline) accordingly. Operators can request players to re-submit the documents in case the submitted one does not have a good quality or any other reasons.
* **Front end**: where players are requested to verify their KYC upon deposit, withdraw or game play. It's up to operators to decide which stage (deposit, withdraw or game play) to require players submit their KYC requests.
**Additionally, the platform supports multiple KYC levels.** Operators can configure these levels directly from the Backoffice Settings. Each level represents a different degree of verification, and actions on the player’s side—such as deposits, withdrawals — can be restricted until the required KYC level has been successfully passed.
### **3.1 Backoffice**
#### **KYC Statuses**
Once a player submits their KYC documents, the request appears in the back office with one of the following **statuses**:
* **Pending** – The request is awaiting review.
* **Requested Resubmission** – The submitted documents were incomplete or incorrect, and the player needs to resubmit them.
* **Approved** – The player's KYC verification is successfully completed.
* **Declined** – The request was rejected due to invalid or insufficient documentation.
**Filtering & Search Options**
To efficiently manage KYC requests, you can **search for a specific player** using various filters, including:
* **Player Email**
* **Name/Surname**
* **Phone Number**
* **KYC level** (may vary depending on the market, as the required documents can differ based on specific regulations.)
* **Document Type**
* **KYC status** (Pending, Requested Resubmission, Approved, Declined)
* **Player Status**
* **VIP Level**
* **Document Number**
* **Created Date Period**
This section ensures a smooth **compliance process** by allowing you to review, approve, or request additional documentation efficiently.
#### **3.1.1 KYC Request Detail:**
The detail page displays all the information submitted by players.
In addition there's a few actions for operators to easily communicate with players
* **Request Resubmission:** this is to request players to submit the document again
* **Decline**: to decline a KYC request. Upon declined, players can't proceed with deposits, withdraw or game play (it's up to operators to configure this from the Backoffice)
* **Approve**: KYC is successfully verified
**Account duplicate** is used to identify most likely duplicated accounts based on checking against with:
* First Name, Middle Name and Last Name
* Document ID
* Phone Number
### **3.2 Front End**
This is an example how it looks like on front end.
Submit a KYC request:
Depends on each status, the FE will display accordingly to instruct players
## **4. VIP Schemes**
The **VIP Schemes** submodule provides a structured view and management options for **VIP levels** within the platform. This section allows you to track, create, and modify VIP levels while configuring **specific requirements and benefits** for each tier.
**VIP Overview**
Within this section, you can view key details related to each VIP level, including:
* **VIP Level & Name** – Identifies each tier by its designated label.
* **Number of Players** – Displays how many players are currently assigned to each VIP level.
* **Creation & Update Information** – Logs details about when the level was created and last modified.
* **Action Options** – Allows for modifications and updates to each VIP tier.
You can also **create a new VIP level** using the appropriate button, customizing it to fit specific player segmentation and engagement strategies.
### **4.1 Managing VIP Levels & Configuration**
By selecting a **VIP level** (under the “Action“ section), you can access a dedicated configuration page where they can:
* **Add new VIP setting.**
* **Edit the level name and status** (e.g., active or inactive).
* **Set deposit and withdrawal limits** per transaction or per day.
* **Define betting limits** on a **daily, weekly, or monthly** basis.
* **Configure the main settings** for VIP level eligibility and progression.
### **4.2 Create/Upgrade VIP & Maintenance Requirements**
Players can either **upgrade** their VIP status or **maintain** their current level. To manage this, we provide two separate configurations:
* **Upgrade Requirements** – Conditions that players must meet to advance to the next VIP tier.
* **Maintain Requirements** – The minimum criteria players must fulfill to keep their current VIP level.
Each requirement can be customized using a combination of **AND/OR** logic:
* "**AND**" – The player must complete all specified requirements to qualify.
* "**OR**" – The player needs to complete at least one of the listed conditions.
***Example Configuration***
*-You can define multiple requirements for each version. For example, to upgrade a player to the next VIP level, they may require:*
1. *The player to earn ≥10 points (Points are accumulated based on bets; e.g., every $10 bet earns 0.5 points).*
2. *The player to place bets totaling ≥$20.*
3. *The player’s total deposit amount to be ≥$30.*
At the top of the section, you can choose whether the player needs to complete all conditions (AND) or just one of them (OR) to meet the requirement.
In case all the conditions are empty, the system won't check any conditions and upgrade players to the respective level.
## **5. Boost VIP Management**
The **Boost VIP Management** submodule allows you to temporarily or permanently upgrade specific players to a higher VIP level using the **same logic as the main VIP requirements**. This feature enables flexible VIP promotions, allowing you to **enhance player engagement** and **reward loyal players** instantly.
### **5.1 Boosting a Player to a VIP Level**
To initiate a VIP boost, you can:
1. Click on the **“Boost a Player”** button.
2. Select the desired player(s) from the list.
3. Choose the **“Boost to a VIP Level”**.
4. Define the **target** and set eligibility conditions using **AND/OR logic**.
**Configuring Boost Requirements**
When boosting a player to a VIP level, you can set **custom conditions** to qualify for the upgrade. These requirements can be configured with:
* **AND Logic** – The player must complete **all** selected conditions.
* **OR Logic** – The player must meet **at least one** of the conditions.
Example boost requirements could include:
* The player must have **placed bets totaling ≥$50**.
* The player’s **total deposit amount must be ≥$100**.
## **6. Tag Management**
The **Tag Management** submodule allows you to categorize and segment players efficiently using a structured tagging system. This feature enables better **player tracking, targeted promotions, and personalized account management** by assigning relevant tags to players based on their activity, behavior, or status. With a very dynamic usage of this component, it allows operators to also dynamically create as many tag categories and tags as they wish
**Tag Categories & Structure**
On the **left side**, you can see the **main tag categories** that help organize tags into broader groups. This section allows you to:
* **View all existing categories**.
* **Create new tag categories** to fit specific business needs.
* **Modify settings** of existing categories.
* **Deactivate categories** that are no longer needed.
Each **main category** can contain **multiple subcategories** or simply **Tags** that define specific player attributes or characteristics.
### **6.1 Managing Tags**
On the **right side**, you can see the list of **Tags** associated with the selected category. Here, they can:
* **Create a new tag** and assign it to a category.
* **Edit existing tag settings**, such as the name, category, or status.
* **Deactivate tags** that are no longer in use.
Tags can be used to classify players for internal tracking, marketing campaigns, compliance monitoring, and risk assessment, ensuring that every player is effectively categorized for optimized management.
#### **6.1.1 Create a new tag category**
* Name: define a tag category name
* Mode:
* Single Selection: this tag category supports only single selection taken place at he Player Detail page
* Multiple Selection: this tag category supports multiple selection
* Status: to activate or deactivate a tag category
#### **6.1.2 Create a new Tag**
* Name: define a tag name
* Category: select the Tag Category
* Status: to activate or deactivate a tag
At Player Detail page at Tag section only display ACTIVE Tag Categories and Tags
## **7. Create Player by Batch**
The **Create Player by Batch** submodule is designed to facilitate **mass player migration and bulk account creation**. This feature is particularly useful when transferring players from an existing system to the **Terragon platform** or when onboarding large groups of users efficiently.
### **7.1 Viewing Existing Player Batches**
You can check previously created **player batches**, including:
* **Batch name and ID** – Identifying different migration processes.
* **Creation date and status** – Tracking when the batch was imported and whether it was successful.
* **Results summary** – Reviewing the number of successfully migrated players and any errors that may have occurred.
### **7.2 Creating a New Player Batch**
To **migrate or create new player accounts**, you can follow these steps:
1. Click the **“IMPORT”** option.
2. **Download the template file**, which provides the required format for bulk player creation.
3. **Fill in the player details** in the template (e.g., username, email, phone number, initial balance, referral info).
4. **Save the document** in the appropriate format.
5. **Upload the completed file** and import it to the platform.
The system will **process the batch** and display the results, highlighting any failed entries that need corrections. This ensures a **seamless migration** and allows for quick onboarding of multiple players while maintaining accuracy and compliance.
## **8. Best Practices for Player Management**
To ensure smooth operations and compliance, here are some **best practices** when managing player accounts:
* **Use filters efficiently** to quickly find player profiles and take necessary actions.
* **Regularly review KYC requests** to keep the verification process smooth and prevent delays.
* **Leverage VIP & Boost VIP features** to enhance player engagement and retention.
* **Use Tag Management strategically** to segment players for promotions, risk assessment, and support.
* **Monitor Player History & Activity Logs** to detect unusual behavior and ensure compliance with gaming regulations.
## **9. Compliance & Security Considerations**
Managing player data requires strict adherence to **security protocols and compliance regulations**. You should:
* **Ensure proper KYC verification** to prevent fraudulent activities.
* **Follow responsible gaming policies** and apply necessary account limits when required.
* **Use secure login practices** and be cautious when handling player accounts.
* **Regularly check withdrawal transactions** for unusual activity and apply necessary security measures.
## **10. Final Summary**
The **Player Module** in **Terragon’s backoffice** is a powerful tool designed to give you full control over **player management, compliance, and engagement**. From handling **KYC verifications and VIP settings** to monitoring **player activity and transactions**, this module ensures an **optimized, efficient, and secure** gaming environment. By utilizing the features outlined in this guide, you can ensure smooth player experiences while maintaining **regulatory compliance and operational efficiency**.
*Thank you for using this guide!*