> ## Documentation Index
> Fetch the complete documentation index at: https://updates-proxy.gpappmanager.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bonus

For Bonus related concerns, you may check out the following articles:

## Guide to Bonuses

In the backoffice, we have a dedicated page that is designed to accommodate Bonuses. Here you may create a bonus according to what you want.

Currently, we are offering three types of Bonuses which are **Deposit, Manual, and Cashback**.

***Deposit*** **-** are bonuses that are automatically given (based on settings) whenever a player makes a deposit.

***Manual*** **-** are bonuses that can be setup so that you may give a player a bonus anytime you choose to.

***Cashback*** **-** are bonuses that are automatically given in consideration of a player's losses in a given period of time.

When creating a bonus you are able to choose which type of bonus you want to create. First go to CHARM>Bonuses:

![image-20241226-072415.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20241226-072415.png)

Then on the upper right hand of the screen. You may click on the ![image-20241226-073656.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20241226-073656.png) to create a bonus:

![image-20241226-072459.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20241226-072459.png)

You may choose either bonus depending on your needs. Once you have selected a bonus type you want to create, click it and you will see a new page where you can now begin to set the content of your bonus.

Let us proceed in creating a Deposit Bonus:

![image-20241226-074818.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20241226-074818.png)

The bonus is split into different categories of settings: General Settings, Display Settings, Bonus Settings, Finance Settings, and Product Settings. These settings need to be filled-in so you are able to create the bonus. Let us discuss all of these settings below:

1. **General Settings**

![image-20240316-203711.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-203711.png)

Here you may set the following fields:

**a. Bonus Name -** This will be the name you are assigning to the bonus. ex. "Daily Reload Bonus"

**b. Product Type -** You can select which product you will be assigning the bonus to be wagered on. For now, we only allow it to be on Sportsbook or Casino.

![image-20240316-203731.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-203731.png)

If you select Sportsbook, then the bonus can only be wagered by a player in any of the sportsbook that we have and if Casino, then you will be only letting the player wager the bonus in any of the casino games. Whatever you choose here, will open up the Product Settings which we will discuss below.

**c. Bonus availability** - Here you can set the period in which you want the bonus to be available to the player. You can set it to happen in the future or you may set it immediately and for the duration, you may set it to just today or you can set it to any duration you want (even years).

![image-20240316-203756.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-203756.png)

When you select the custom range, you can choose in the pop-up calendar the duration you want it to be. Just click on the start date you want and then click on the end date. Take note that the months and years can be clicked so that you can extend the dates more or if you want you can edit the date manually by typing on it after selecting a period.

![image-20240316-203801.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-203801.png)

\*This option isn't available in cashback since it will be covered under the cashback campaign settings.

**d. Expiration Type and Number of Days After Activation -** Whenever a player receives the bonus, you may set for how long the bonus will be available to them before it expires. For now, we only have number of days after activation.

![image-20240316-203830.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-203830.png)

**e. Payment System -** You can choose which payment options are allowed for the bonus when making a deposit. This settings lets you enable or disable payment systems.

![image-20241226-074559.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20241226-074559.png)

2. **Display Settings**

![image-20241226-074916.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20241226-074916.png)

Here you are able to set the bonus name and description of that bonus based on the available languages that you have. Whatever you set here will be the name and description that will be seen by the player. For example, If a player is using the korean language then he will see the korean name and description.

To illustrate when we set the bonus name in korean and put in a korean description, this is what the player can see under his available bonus:

![image-20240316-203912.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-203912.png)

3. **Bonus Settings**

![image-20241226-075313.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20241226-075313.png)

Here you may set the following fields:

**a. Deposit Count Type -** You can select which type of Deposit bonus you will use. We have Order and Reload as options here.

**>Reload -** depending on what type of period you set, a player receives a bonus whenever he makes a succeeding deposit from his first ever deposit.

**>Order -** depending on what order of deposit you set, the player will be able to receive a bonus once he reaches that number of deposits.

![image-20240316-203947.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-203947.png)

* **Reload**

i. Once you have selected Reload, "Schedule" will appear:

![image-20241226-075412.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20241226-075412.png)

You may then choose the schedule of when you want the reload bonus to apply to:

**>Day -** only happens daily

**>Week -** only happens weekly

**>Month -** only happens monthly

**>Year -** only happens yearly

**>None -** If you choose this then it means that every reload will have the reload bonus.

ii. Once you select a schedule you will then see two additional settings which are "Reload Period" and "Reload Count". If you choose None then these two settings will not appear.

![image-20241226-075641.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20241226-075641.png)

**>Reload Period -** you may set the period for the bonus here. Let's say you want the reload bonus to be applicable only once every 3 days then you can input here 3.

**>Reload Count -** this is how many times a player can claim a bonus during the period. So if I set the reload period to 3 and reload count to 1, then player can only claim this bonus once he reloads every 3 days.

* **Order**

i. Once you have selected Order, "Schedule" will appear:

![image-20241226-075818.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20241226-075818.png)

You may choose the schedule of when you want the order bonus to apply to:

**>Day -** will be based from daily deposits

**>Week -** will be based from weekly deposits

**>Month -** will be based from monthly deposits

**>Year -** will be based from yearly deposits

**>None -** If you choose this, then it means that order will start from player's first ever deposit

**ii. Deposit Order -** this is in what order of deposit made will the player be given the bonus. For example, if I put Schedule = Day and Deposit Order = 2, then that means that for every second deposit in a day the player will receive the bonus. If I put Schedule = None and Deposit Order = 1, then the first ever deposit made by the player he will receive a bonus.

b. Deposit Bonus Type - here you can set the basis of what amount the bonus can be set. We currently have two types which are Fixed amount or Percentage.

![image-20240316-204056.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204056.png)

**>Fixed amount -** regardless of any amount the player has deposited, he/she will just received a fixed amount of bonus

**>Percentage -** depending on the amount the player has deposited, he/she will receive a portion of that deposit. When you choose percentage this option will appear:

![image-20240316-204103.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204103.png)

**>Bonus Percentage -** just input the percentage amount you want the bonus to have, for example you can set "10" so that it will take 10% of the deposited amount as the bonus amount.

**c. Deposit Wagering and Bonus Wagering -** here you can set the wagering requirement of the bonuses

![image-20240316-204115.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204115.png)

**>Deposit Wagering -** you can set how many times you want the player to wager the deposit amount

**>Bonus Wagering -** you can set how many times you want the player to wager the bonus amount

For example, you have created a bonus and you want player to wager the deposit first by 2 or twice its amount and the bonus first by 3 or thrice its amount, then those will be your wagering requirements before the player can receive any winnings from the bonus. You can set it as 0 but we heavily advice you not to do so.

**d. Keep deposit on real balance and Restrict withdrawal if bonus is still active -** here you can set restrictions for the bonus and deposit amounts.

![image-20240316-204529.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204529.png)

**> Keep deposit on real balance -** this option allows the players to have their deposit on the real balance, without having to use it in bonus.

Bonus and Real balances can be seen by the player as such:

![image-20240316-204523.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204523.png)

**Real money balance -** composed of money that was earned by the player either through wagering and includes his deposit amount which can all be withdrawn anytime if the player chooses so.

**Bonus balance -** composed of money that was given as a bonus and may include a deposit if "Keep deposit on real balance" was left unchecked. This amount cannot be withdrawn and will be only transferred to Real money balance once the deposit and/or bonus wagering has been fulfilled.

**>Restrict withdrawal if bonus is still active -** this option restricts the player from withdrawing if the wagering requirements have not yet been fulfilled. This works with the "Keep deposit on real balance" option above so that the player may not withdraw while a bonus is active.

* Note that when you check "keep deposit on real balance", any split bets (bets composing both bonus and real money balance) made by the player that wins will also have its winnings split depending on its composition. For example I made a bet of 20,000 KRW which is actually composed of 15,000 KRW (real money balance) and 5,000 KRW (bonus). If the bet wins with odds of 3 then the returning amount would be 60,000 KRW = 45,000 KRW (real money balance) and 15,000 KRW (bonus). They will be going to their respective wallets as seen above.

**e. Prioritize Bonus Amount -** this toggle lets you choose if the system will prioritize in using the player's bonus amount or bonus win when placing a bet during bonus.

* To understand more of how this setting affects a bonus please see: Bonus Rules: How it is computed and paid out and/or How to check a Player's Bonus

**f. Allow Player to overwrite active bonus**

> **>Anytime -** if toggled on will allow player to overwrite active bonus anytime regardless if the bonus balance is 0/settled. This means that the player can claim a new bonus even if the bonus balance is not yet settled.
>
> **>If Bonus Balance is 0 -** if toggled on, this will allow players to overwrite active bonus only if the bonus balance is 0. This means that the player can only claim a new bonus if the bonus balance is 0 or settled.

![image-20241226-080214.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20241226-080214.png)

[Bonus New Update](https://updates-proxy.gpappmanager.com/en-bonus.md#p1520336928)

**g. Allow player to Cancel -** in this section, you can set which part the player can cancel a bonus.

![image-20240415-172928.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240415-172928.png)

* **If Bonus Wagering is Completed -**  The player should be able to cancel the bonus if bonus wagering requirement is met at any time, regardless of their balance. If the player has not met the bonus wagering requirement, they are not allowed to cancel the bonus.
* **If Bonus Balance is 0 -** Player should be able to cancel the bonus if bonus balance of the player is zero/0.
* **Anytime -** The player should be able to cancel the bonus at any time, regardless of their balance or whether the wagering requirement has been met. Deposit amount should be credited back to player's real money wallet upon cancellation of the bonus.

4. **Finance Settings**

![image-20240316-204513.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204513.png)

**a. Applicable to Currencies -** you may set the bonus to apply to any of the available currencies you have

![image-20240316-204435.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204435.png)

You can set it to apply to one currency only or to any multiple currencies you want. For example:

![image-20240316-204422.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204422.png)

![image-20240316-204428.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204428.png)

**b. Minimum and Maximum Settings -** These settings will fix the minimum and maximum amounts for the bonus. These are very important to think about as these settings cannot be changed anymore.

For Deposit:

![image-20240316-204413.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204413.png)

**Minimum Deposit -** smallest amount of a deposit so they can be considered for the bonus. Anything below this amount will not receive this bonus.

**Maximum Deposit -** largest amount of a deposit so they can be considered for the bonus. Anything above this amount will not receive this bonus.

**Maximum Payout -** largest amount of the winning bonus that will be paid to a player. Anything above this amount will not be paid to the player.

**Maximum Bonus Amount -** largest amount of bonus that will be given to the player. Anything above this amount will not be distributed to the player.

**For Cashback Attachment:**

![image-20240316-204407.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204407.png)

**Minimum Payout -** smallest amount of the cashback that will be paid to a player. Anything above this amount will not be paid to the player.

**Maximum Payout -** largest amount of the cashback that will be paid to a player. Anything above this amount will not be paid to the player.

5. **Product Settings**

Depending on what you have selected in the product type above, the respective product settings will then populate. Here you may choose to be specific in where you want the player to wager his/her bonus.

**For Sports:**

![image-20240316-204400.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204400.png)

**For Casino:**

![image-20240316-204351.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204351.png)

**a. For Sports:**

\>Bet Type - you may choose to what kind of sports betting you want the bonus to be wagered on. We have three options for this.

**i. Single -** bets which have only single selections on it.

**ii. Combo -** bets which have multiple selections on it.

**iii. System -** bets which have multiple selections on it (strictly for combo bets under BTi provider).

![image-20240316-204337.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204337.png)

**>Provider -** You can select which sportsbook you want the player to wager on. You can choose only one or multiple sportsbook

![image-20240316-204330.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204330.png)

**>Select Live/Pre-match -** You can select if you want the selections to be an on-going or live match versus  scheduled or pre-match. You are allowed to select them both as well.

![image-20240316-204325.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204325.png)

**>Select Sports and Competition -** You can select if you want the selections to be only for a specific sport or competition. For example, you only want the bonus to be wagered on basketball or specifically NBA. You are able to choose multiple if you want to.

![image-20240316-204311.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204311.png)

![image-20240316-204318.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204318.png)

**b. For Casino:**

![image-20240316-204303.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204303.png)

**> Game Type -** You can select if bonus will be wagered on Casino or Live Casino. You can choose both.

**> Provider -** You can select if bonus will be wagered only on a particular provider or multiple providers. You are able to choose only one or multiple if you want to.

![image-20240316-204257.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204257.png)

**>Select Categories and Games -** You can select if you want the casino or live casino to be only for a specific provider or competition. For example, you only want the bonus to be wagered on blueprint or you want it wagered on a specific game like "Ladder Game". You are able to choose multiple if you want to.

![image-20240316-204248.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204248.png)

![image-20240316-204241.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204241.png)

\*Creating a Manual Bonus will be the same as above but its bonus settings will only be this:

![image-20240316-204231.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204231.png)

***

That is it for creating a Deposit Bonus. All fields are required to be filled before you are able to save it.  Once you have successfully created a bonus it will appear under CHARM>Bonuses and you will be able to see if it is active or not. Active means that the bonus will be available to players and Inactive means that the bonus will not be available to them.

![image-20241226-082314.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20241226-082314.png)

You are able to activate/ deactivate a bonus anytime by clicking on the button to the left of the state:

![image-20240316-204214.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204214.png)

**Active -** bonus is available to players

**Inactive -** availability date has passed and as such not available anymore to players

**Disabled -** disabled manually and as such not available to players

As an additional feature we have these available for a backoffice user to use:

![image-20240316-204205.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204205.png)

![image-20240316-204147.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204147.png) **Edit Bonus Details -** You are able to edit a bonus but only for its name, description, and availability dates.

![image-20240316-204152.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204152.png) **View Bonus Details** - You are able to view the bonus details

![image-20240316-204159.png](https://sunny-genie-c9179b.netlify.app/1311768711/image-20240316-204159.png) **Duplicate Bonus -** You are able to copy and create a new bonus. This is for those times when you want to clone a bonus and you want to edit a few of its details to fit another bonus you want.

If you want to see how a player will see their bonus, you can go to this article: [How players see Bonus](https://updates-proxy.gpappmanager.com/en-bonus.md#p1311768836)

If you want to see how bonuses are computed and paid out to players, you can go to this article: [Bonus Rules: How it is computed and paid out](https://updates-proxy.gpappmanager.com/en-bonus.md#p1311867174)

If you want to see how a back office user can review a player's bonus, you can go to this article: [How to view a player's bonus](https://updates-proxy.gpappmanager.com/en-bonus.md#p1311867112)

Korean ver: [보너스 가이드](https://updates-proxy.gpappmanager.com/ko-bonus.md#p1356660779)

### Bonus New Update

Here are the updates for the Bonus.

**“Automatically set the bonus to finished when the bonus balance is zero."** The current **"finished"** status and its associated flow will be removed and will be replaced by new settings: **"Allow Player to overwrite active bonus,"** with options for **"If Bonus Balance is 0"** or **"Anytime."** This means that players can claim a new bonus, but their active bonus and bonus progress will be canceled.

##### Before

![image-20241210-030951.png](https://sunny-genie-c9179b.netlify.app/1520336928/image-20241210-030951.png)

##### After

![image-20241210-031235.png](https://sunny-genie-c9179b.netlify.app/1520336928/image-20241210-031235.png)

**Notes:**

* The overwrite implementation applies only to assigned bonuses, not claimed ones. Players can claim assigned bonuses if the **overwrite** setting is enabled. However, if the setting is disabled, the old behavior should still be followed (regarding when the claim button should be enabled or disabled)
* With this change, existing bonuses with the *"Automatically set the bonus to finished when the bonus balance is zero*" setting enabled will transition to the new setting *"Allow Player to overwrite active bonus"* with the option *"If Bonus Balance is 0.*"
* If the bonus status is canceled, nothing will be returned to the player unless it involves a split bet. In the case of a split bet, only the real money portion will be refunded.
* Overwritten active bonus are considered as canceled.

korean ver: [보너스 신규 업데이트](https://updates-proxy.gpappmanager.com/ko-bonus.md#p1520304154)

## How to view a player's bonus

The Bonus interface has been improved to make it easier to track a player's bonus transactions. You can access a player's bonus page by searching in Player Management>Player>Wallet>Bonuses.

![image-20240316-205608.png](https://sunny-genie-c9179b.netlify.app/1311867112/image-20240316-205608.png)

To use the improved interface, simply hover your mouse pointer over the bonus ID of the bonus you want to review. The bonus ID will light up when you hover over it, so you can click it. Here, we've selected the third bonus.

![image-20240316-205615.png](https://sunny-genie-c9179b.netlify.app/1311867112/image-20240316-205615.png)

button, a popup is displayed with details about the player's bonus transaction. Let's show an example of how the bonus is displayed:

![image-20240316-205626.png](https://sunny-genie-c9179b.netlify.app/1311867112/image-20240316-205626.png)

Above, you can see various details about the bonus:

1. **Bonus ID** - shows which bonus the player has received.
2. **Status** - Shows the current status of the bonus.
3. **Keep Deposit with Real Money** - Shows if the bonus includes the player's deposit.

No - means that the bonus includes the player's deposit.

Yes - means that the bonus does not include the player's deposit.

4. **Bonus amount priority** - Indicate whether the player is prioritized to use the bonus amount first when placing a wager.

No - Bonus wins are prioritized when the player places a wager.

Yes - The bonus amount is prioritized when the player places a wager.

5. **Total amount converted** - The amount transferred to the player's wallet.

The following lists the descriptions for each column:

1. **Reference ID** - refers to the bet the player placed. There are always two entries, one for the bet placement and one for the bet settlement. 2.
2. **Bonus bet amount** - the total bet amount for the transaction.
3. **Status Description** - Indicates the type of money used to fill the bonus bet amount.

**From Bonus Win** - This is the amount from previous bet win.

**From Deposit Amount** - The amount from the player's deposit (if the Keep Deposit in Real Money setting is unchecked or No).

From Bonus Amount - The amount from the bonus awarded to the player.

4. **Return Amount** - The amount from the bet settlement, which can come from winnings/rollbacks/canceled bets.
5. **Modified Date** - Contains the date and time when the bet was placed or the bet was settled.

There will always be a bet settlement transaction in every bet history to verify the transaction history.

This is how you can check your transaction history:

![image-20240316-205817.png](https://sunny-genie-c9179b.netlify.app/1311867112/image-20240316-205817.png)

You can use the reference ID to match your betting history with your deposit and withdrawal history. The table follows the order of bets and settlements in chronological order. The earliest transactions are shown at the top and the latest at the bottom.

An example to show which is bigger, wagers or settlements..:\
The initial amount of a member's deposit and bonus settings are as follows:\
Deposit amount = 15,000\
Bonus amount = 10,000

1. **Bet #1**:

![image-20240316-205839.png](https://sunny-genie-c9179b.netlify.app/1311867112/image-20240316-205839.png)

![image-20240316-205847.png](https://sunny-genie-c9179b.netlify.app/1311867112/image-20240316-205847.png)

In the example above, the player wagered 10,000 and the money used for that wager came from the bonus amount.

![image-20240316-205859.png](https://sunny-genie-c9179b.netlify.app/1311867112/image-20240316-205859.png)

The bet won, earning you 22,500 in bonus wins.

2. **Bet #2:**

![image-20240316-205934.png](https://sunny-genie-c9179b.netlify.app/1311867112/image-20240316-205934.png)

In this bet, the player wagered 10,000, and the money for this bet came from his deposit.

The bet was lost as a miss.

3. **Bet #3**:

![image-20240316-210019.png](https://sunny-genie-c9179b.netlify.app/1311867112/image-20240316-210019.png)

In this bet, the player wagered 10,000 and the money used for the bet came from the bonus win amount(bet#1)

The bet won, earning you 22,500 in bonus wins.

4. **Bet #4**:

![image-20240316-210038.png](https://sunny-genie-c9179b.netlify.app/1311867112/image-20240316-210038.png)

In this bet, the player wagered 10,000, and the money used for that bet came from the bonus win amount.( from bet#1).

The bet was lost.

After the fourth bet, the wagering requirements were met and the bonus was finalized. In the sample above, the bonus has been converted to 30,000 won (consisting of 0 bonus amount + 25,000 bonus winnings + 5,000 deposit amount) and tagged as settled.

This popup shows the transactions associated with the bonus and the wagering amount prioritized for use. To learn more about how bonuses are calculated, read the following:

[Bonus Rules: How it is computed and paid out](https://updates-proxy.gpappmanager.com/en-bonus.md#p1311867174)

\*In all reports, such as Player History > Casino Bets/Sports Bets or Betting Reports > Casino/Sports, you can filter bonuses using Manual, Deposit, or Cashback as search filters.

\*\*To filter for amounts not included in the bonus, use the None or Real filters, which will show all bets without a bonus. Both filters are used automatically.

## How players see Bonus

The bonus system is one of the major features that we offer and as such it is also important for Backoffice users to know how the players/members can see their bonus from their point of view.

Whenever a player is logged-in to our Player Portal, they will always see these two wallets:

![image-20240316-210813.png](https://sunny-genie-c9179b.netlify.app/1311768836/image-20240316-210813.png)

We refer to these two as:

**Real Money Balance (Wallet Icon)**

**Bonus Balance (Gift Icon)**

*\*Whenever a player acquires a bonus, he/she will see that amount under the Gift Icon.*

**How does a player acquire a bonus?**

Players will get bonuses via the three main bonus types that we have: Deposit, Manual, and Cashback. The way to acquire these bonuses are as follows:

* *Deposit* - Whenever a player makes a deposit then that player will get a corresponding deposit bonus. This is given after a successful deposit.
* *Manual* - Whenever a Backoffice user wants to give a player a bonus for any reason, this is where the bonus will come from. This is given when a Backoffice user manually gives a player this bonus.
* *Cashback* - Whenever a player successfully participates in a Cashback Campaign then that player will get a corresponding cashback bonus. This is given after a campaign ends.

**How will a player see the bonus come in to their wallet?**

Whenever a player receives a bonus, that player will see a pop-up in the player portal that lists the bonus they receive. But there may be cases, wherein the pop-up might be closed by the player because they are playing or they close it by accident. They can always click the wallet Icon and they will be brought to the Bonus Section immediately or they can access it through their player profile. For example:

![image-20240316-211025.png](https://sunny-genie-c9179b.netlify.app/1311768836/image-20240316-211025.png)

Here you can see three main categories above which are:

* **Active Bonuses** - Bonus that can be claimed by a player.
* **Available Bonuses** - Bonus that currently being offered by the operator. They can go here to look for bonuses which they might be interested in getting.
* **Bonus History** - A page where they can look at the bonuses they previously claimed.

**Things to take note regarding bonuses:**

1. They can only select 1 bonus at a time and then they have to complete that bonus (or cancel it); A player may only play 1 bonus at a time. For example, here we picked one bonus and it is shown that the bonus is currently "Running".
   ![image-20240316-211118.png](https://sunny-genie-c9179b.netlify.app/1311768836/image-20240316-211118.png)
2. When a player claims an active bonus all other active bonuses will be removed and thus player will not be able to claim them anymore. This must be communicated to the players properly as they might claim that they have bonuses missing. A player will have to choose carefully which bonus to claim. Note that for Manual and Cashback Bonuses, they will be removed once a player claims a bonus but they will appear again once the current bonus is over.
3. If a player is currently wagering with a claimed bonus, he/she will be able to receive new bonuses but will not be able to claim any of them. Once that player finishes his/her current bonus, he/she may now claim the other active bonuses that came in during that bonus session (Note that the rule in #2 still applies). This is also important because we have bonuses that may come in any time like a cashback bonus or manual bonus.
4. The player can see their bonus balance via the bonus wallet (the one with the gift Icon). Whenever they bet, they will have to use the bonus amount first.
5. Whenever a player wants to bet more than the amount in their bonus wallet, the bonus amount will be used and then the remaining balance will come from their Real Money Wallet (the one with the wallet icon). This is what we refer to as a split bonus bet.
6. Whenever a split bonus bet wins, the corresponding win amount from the bonus will go to the bonus wallet while the win amount from the real money will go to the real money wallet.
7. A player has to fulfill the wagering requirements listed in the bonus for them to be able to convert their winnings into real money. In the example above, the player has a deposit of 1,000,000 KRW and a bonus of 100,000 KRW. The wagering requirement is set to x1 deposit and x1 bonus which means that the player has to bet a total of: 1,000,000 x 1 + 100,000 x 1 = 1,100,000 to satisfy the bonus requirements.
8. ![image-20240316-211241.png](https://sunny-genie-c9179b.netlify.app/1311768836/image-20240316-211241.png)

   This setting affects where the balances will be distributed to after claiming the bonus.

For the example in the image above:

Unchecked - The deposit of 1,000,000 KRW and bonus of 100,000 KRW will all go to bonus wallet (gift icon)

Checked - The deposit of 1,000,000 KRW will go to the real money wallet (wallet icon) and bonus of 100,000 KRW will go to bonus wallet (gift icon)

9. ![image-20240316-211313.png](https://sunny-genie-c9179b.netlify.app/1311768836/image-20240316-211313.png)

   When checked, the player will not be able to withdraw any money until that player finishes the bonus requirements. Whenever a player claims that he/she is unable to withdraw, please check the bonuses section also and see if a player might have an ongoing bonus and this setting is checked.

If you want to see how bonuses are made you can go to this Article: [Guide to Bonuses](https://updates-proxy.gpappmanager.com/en-bonus.md#p1311768711)

If you want to see how bonuses are computed and paid out to players you can go to this Article: [Bonus Rules: How it is computed and paid out](https://updates-proxy.gpappmanager.com/en-bonus.md#p1311867174)

## Bonus Rules: How it is computed and paid out

As bonus is one of the most important features that an operator may provide to their client, it is essential that bonus rules are properly communicated. In this section, bonus and how it is calculated will be explained.

I. Under our current Bonus Rules, we should first look at what items are necessary to determine how the bonus system works. These items are:

1. Bonus amount - This is the actual bonus amount given to the player to use.
2. Bonus win - This is the amount that will result from winning bets during a player's bonus session.
3. Deposit amount - This will come in from a player's deposit/real money balance. This will only be added to the bonus when "Keep deposit on real balance" is left unchecked.

![image-20240316-212008.png](https://sunny-genie-c9179b.netlify.app/1311867174/image-20240316-212008.png)

*\*Keep deposit on real balance -* is a bonus setting that you encounter when creating a bonus.

![image-20240316-212021.png](https://sunny-genie-c9179b.netlify.app/1311867174/image-20240316-212021.png)

*\*Prioritize Bonus amount -* is a bonus setting that you encounter when creating a bonus

These items are important in determining what happens to a player's real money, bonus money, and their balance during betting and disbursement after winning.

**II.** During betting on a bonus session, the following hierarchy will be followed by the system when it determines what amount it will use for betting.

***If prioritize bonus amount is unchecked:***

***Bonus win > Deposit amount (if keep deposit on real balance is unchecked) > Bonus amount > Real Money Wallet (if the three items before is insufficient)***

***If Prioritize bonus amount is checked:***

***Bonus amount > Bonus win >  Deposit amount (if keep deposit on real balance is unchecked) >  Real Money Wallet (if the three items before is insufficient)***

Whenever a player bets, the system will try to fulfill the bet amount by taking from Bonus win and then if it is not enough it will take from the deposit amount and then if it is still not enough it will take from the bonus amount.

Once a player still has not enough balance to cover the bet it will take from the real money wallet as a last resort. The amount taken from the real money wallet will be paid directly to the player if the bet wins and will not be used in any bonus calculations.

\*Note that: There is a possibility when a bonus includes deposit amount, a player may finish his/her bonus session without ever using his/her bonus amount because the system will first get the bet from bonus win and/or deposit amount. This is where the prioritize bonus amount setting is important because it will determine if bonus amount is going to be used first or not when betting.

**III.** When a player finishes his/her bonus session, the player may end up winning and thus subject to receive their winnings.

When a player ends up winning from his bonus session, his/her winnings will be based from his/her total converted amount which gets transferred to his/her real money wallet and this is what we call when a bonus is "completed" or "settled". For example:

![image-20240316-212117.png](https://sunny-genie-c9179b.netlify.app/1311867174/image-20240316-212117.png)

Once a bonus is completed or settled, the system will also determine how much money the player will receive:

A. For Casino:

Upon betting on a casino, the system receives the result of the bet instantly and so once the bet that completes the wagering requirement is settled, the state of his/her bonus session will go straight to "Settled". The winnings will follow this hierarchy:

**Bonus win + Deposit amount = Total Converted amount**

*\*The converted amount will be given to the player as a transfer in*

B. For Sports:

1. Upon placing a sports bet, the system still has to wait for the result of that bet, so if that bet successfully completes the wagering requirement: it will convert whatever deposit amount and bonus win that the player have at that moment and then give that converted amount to the player. It will also change the state of the bonus to "Completed".

**Bonus win + Deposit amount = 1st Converted amount**

*\*The converted amount will be given to the player as a transfer in*

2. When the bet above settles, the system will give out to the player the winnings and it will change the state of the bonus from "Completed" to "Settled".

**Bonus Win  = 2nd Converted amount**

*\*The converted amount will be given to the player as a transfer in*

*Example of transfer ins due to conversion:*

![image-20240316-212232.png](https://sunny-genie-c9179b.netlify.app/1311867174/image-20240316-212232.png)

\*Note that there is a maximum payout amount which is also important when calculating payment of bonus winnings. This is a setting included when creating a bonus:

![image-20240316-212244.png](https://sunny-genie-c9179b.netlify.app/1311867174/image-20240316-212244.png)

The system will try to fulfill the total converted amount by first taking from the bonus win and then second from the deposit amount. After calculating the total converted amount, the system will then look at the maximum payout and pay the appropriate amount to the player.

Total converted amount will never exceed the maximum payout and in that case the system will only pay the player up to the maximum payout amount.

\*Note that bonus amount is not included anymore when paying out to the player.

If you want to see how bonuses are made you can go to this Article: [Guide to Bonuses](https://updates-proxy.gpappmanager.com/en-bonus.md#p1311768711)

If you want to see how a player will see their bonus you can go to this Article: [How players see Bonus](https://updates-proxy.gpappmanager.com/en-bonus.md#p1311768836)

## Bonus and Cashback Reports

#### Bonus

To view the Player Bonus Report per Bonus ID, you can go to **CHARM > Bonuses >**  ![image-20240316-221216.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20240316-221216.png) **Bonus Report**.

In the image below, you can see four options in every Bonus. The Backoffice user can **(1) Edit Bonus Details, (2) View Bonus Details, (3) Duplicate Bonus** and view **(4) Bonus Report**.

![image-20240316-221226.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20240316-221226.png)

*\*Note that the columns above are sortable and can be rearranged according to the BO user’s preference (except for the first three columns – State, Bonus Availability Start Date, and Bonus Availability End date).*

In Bonus Report, you can see the **Bonus Name, Bonus Type** and **Product Type** in the header. All columns are sortable (except for **Player ID, Bonus ID,** and **Modified By**) and can be freely rearranged.

![image-20250125-054234.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20250125-054234.png)

The backoffice user can see the players who claimed the bonus. You will see that the Bonus ID is highlighted which means it is clickable.Player ID is also clickable and will redirect you to Player Management.

CSV button will allow the backoffice user to download the bonus report.

The backoffice user will be able to choose which columns to appear in the bonus reports. ![image-20250125-054437.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20250125-054437.png)

*\*The backoffice user can cancel the bonus by clicking the yellow button.*![image-20250125-061103.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20250125-061103.png)

Bonus details will show once eye icon ![image-20250125-061208.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20250125-061208.png) is clicked.

![image-20250125-054710.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20250125-054710.png)

You can also use the **Filter** section for specified viewing.

![image-20250125-054945.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20250125-054945.png)

By default ‘All’ will appear in State which will display all status of bonus.

When the Bonus ID of the player is clicked, the **Bonus Transaction Info** will pop up. You can see the bets made by the player by clicking the Reference ID.

![image-20250125-055310.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20250125-055310.png)

This is what you will see when reference ID is clicked.

![image-20250125-055352.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20250125-055352.png)

The process applies to both **Sportsbook** and **Casino**, and can be done manually, through deposit, or cashback.

#### Cashback

Let me show how it looks like in Cashback.

**Navigation: CHARM > Cashback > Cashback Report**

![image-20240316-221447.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20240316-221447.png)

The Backoffice user will see all the players who claimed the bonus. In the header, you can see the Cashback ID, Cashback Name, Availability Start Date and Availability End Date. You can click the ![image-20240316-221508.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20240316-221508.png)   icon in Cashback Name to view cashback details and the eye icon in Cashback Attachment to view the details.

The **Total Player Count** and **Total Cashback Amount** in header will show you the summary.

![image-20240316-221530.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20240316-221530.png)

\*Players in the Player ID is highlighted when clicked and will redirect you to Player Management. The cancel button will also appear inside the Cashback Report where the backoffice user has the access to cancel.

When **Bonus Assigned** is clicked, Bonus information attached to this Cashback will appear.

![image-20240316-221547.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20240316-221547.png)

You can see the bet details once you click the Reference ID.

![image-20240316-221603.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20240316-221603.png)

You can also use the Filter section to check on the specific player.

![image-20240316-221614.png](https://sunny-genie-c9179b.netlify.app/1311703473/image-20240316-221614.png)

\*Note that in Cashback, only reports of Ended status can be clicked. You will notice that Reports button is not clickable in Active, Inactive, and Scheduled.

Korean version: [보너스 및 캐시백 보고서](https://updates-proxy.gpappmanager.com/ko-bonus.md#p1356660965)

To get started with Bonus, you can view this article: [Guide to Bonuses](https://updates-proxy.gpappmanager.com/en-bonus.md#p1311768711)

To check player's bonus, see here: [How to view a player's bonus](https://updates-proxy.gpappmanager.com/en-bonus.md#p1311867112)

For Bonus computations and payout: [Bonus Rules: How it is computed and paid out](https://updates-proxy.gpappmanager.com/en-bonus.md#p1311867174)

## Bonus: Minimum Odds for Sports

This feature enhances the user experience by providing clear guidelines on how bonuses can be earned through Combo and System bets. By allowing operators to select between **Per Selection** and **Total Odds** options, the sportsbook can tailor its Bonus to encourage diverse betting strategies while maintaining compliance with bonus eligibility criteria.

***

### Sportsbook Game Settings

##### Minimum Odds

###### Per Selection

* **Select Minimum Odds -** Each selection should meet the minimum odds configured
* **Minimum Total Odds -** The default value is set to 0; otherwise, the total odds must meet the minimum total odds configured.

###### Total Odds

* **Select Minimum Odds -** The total odds should meet the minimum odds configured

![image-20241024-171318.png](https://sunny-genie-c9179b.netlify.app/1477410926/image-20241024-171318.png)

Upon hovering the info icon, you will see a short description of the selections.

![image-20241016-060528.png](https://sunny-genie-c9179b.netlify.app/1477410926/image-20241016-060528.png)

By default the value of Minimum Odds when “**Per selection”** is checked is 0. The operator have it’s own discretion to change the default value.

![image-20241021-055126.png](https://sunny-genie-c9179b.netlify.app/1477410926/image-20241021-055126.png)

***

> [!NOTE]
>
> Affected:
>
> * Cashback
> * Manual
> * Deposit

For Korean version: [보너스: 스포츠 최소 배당률](https://updates-proxy.gpappmanager.com/ko-bonus.md#p1480228879)

## Bonus: Auto-end Unfulfilled Bonus

**This new feature automatically ends bonuses and marks them as “Unfulfilled” when:**

* The bonus balance is zero,
* All bonus bets have been settled,
* The wagering requirements are not met, and
* The bonus has not yet expired.

**Important Note:** \
Once the bonus balance reaches zero and all bets are settled, there will be a 5-minute waiting period before the bonus is tagged as “Unfulfilled.”

Back Office Navigation: **CHARM > Bonuses > Create/Edit > General/Bonus Settings**

![Bonus\_Creation\_(updated) (1)-20250919-091351.png](https://sunny-genie-c9179b.netlify.app/1894776844/Bonus_Creation_-updated-1--20250919-091351.png)

Bonus Setting: Auto-End on Zero Balance

***

#####  **Bonus Report & Player Bonus History Update**

As part of the latest update, the following enhancements have been made to support the new **"Unfulfilled"** bonus status:

**Bonus Report:**

* A new filter option **"Unfulfilled"** has been added to allow back office users to easily view bonuses with this status.
* An additional column **"Last Modified"** has been introduced to display the date and time when a bonus status was last updated to **Unfulfilled**.

![image-20250919-092955.png](https://sunny-genie-c9179b.netlify.app/1894776844/image-20250919-092955.png)

Unfulfilled Filter

![image-20250915-083139.png](https://sunny-genie-c9179b.netlify.app/1894776844/image-20250915-083139.png)

Last Date Modified Column

**Bonus Info Panel:**

* When a bonus is in the **Unfulfilled** state, it will now be clearly shown as **"Unfulfilled"** in the Bonus Info section.

![image-20250919-020225.png](https://sunny-genie-c9179b.netlify.app/1894776844/image-20250919-020225.png)

Bonus Info: Unfulfilled

**Metrics Section:**

* A new field has been added to display the **total count of bonuses marked as Unfulfilled**, providing better visibility into unfulfilled bonus activity.

![image-20250917-004654.png](https://sunny-genie-c9179b.netlify.app/1894776844/image-20250917-004654.png)

Metrics - Unfulfilled Bonus Count

**Player’s Bonus History Page:**

* The **"State"** column now includes the new **Unfulfilled** status, offering a clearer overview of the player’s bonus progression.

![image-20250921-004403.png](https://sunny-genie-c9179b.netlify.app/1894776844/image-20250921-004403.png)

Player’s Bonus History

***

Kor Version: [보너스: 자동 종료 미이행 보너스](https://updates-proxy.gpappmanager.com/ko-bonus.md#p1949040670)

## Bonuses: Timers (Assignment vs Activation)

This feature lets operator control bonus availability with two timers:

The **Assignment Expiration** timer begins when a bonus is assigned and governs the time a player has to claim it. Once claimed, the **Usage Expiration** timer takes over, dictating the time a player has to use the bonus.

**Assignment Expiration**

Allows operators to set a specific time limit (in hours) for a bonus to be claimed after it's been assigned to a player. If a player doesn't claim the bonus within this period, it becomes unavailable.

**Usage Expiration**

Enables operators to set a specific time limit (in hours) for a bonus to be used after the player has claimed it. This timer begins only after the bonus is active.

##### Bonuses

Navigation: **CHARM > Bonuses > Create New Bonus**

![image-20250926-121627.png](https://sunny-genie-c9179b.netlify.app/1930461194/image-20250926-121627.png)

Default View

![image-20250926-121754.png](https://sunny-genie-c9179b.netlify.app/1930461194/image-20250926-121754.png)

Selected: Number of Hours After Assignment

![image-20250926-121958.png](https://sunny-genie-c9179b.netlify.app/1930461194/image-20250926-121958.png)

Selected: No Expiry

**Assignment Expiration (General Settings)**

This setting controls the **overall availability** of the bonus offer.

* It defines the time limit for a player to claim or be assigned the bonus.
* **Timeframe:** This determines **how long the bonus will be displayed** as available to the player on Active Bonuses
* **Assignment Expiration Type**: A dropdown or selector.
  * If **"Number of Hours After Assignment** is selected, the **"Hours to Expiration"** input field **will display**, defining **how long the bonus will display** in the player's active bonuses list.
  * If **"No Expiry"** is selected, the **"Hours to Expiration"** input field **will not display**.
* **Result:** If the player does not claim the bonus within this period, it is tagged as **"Expired."**

###### Bonus Settings

![image-20250926-122752.png](https://sunny-genie-c9179b.netlify.app/1930461194/image-20250926-122752.png)

Bonus Settings: Configuration

**Usage Expiration (Bonus Settings)**

This setting controls the **utilization period** for a bonus that has already been claimed.

* It defines the time limit for a player to use the bonus funds and complete all wagering requirements.
* The timer for this period begins **immediately after the bonus is claimed** and activated in the player's account.
* If the player fails to meet the requirements within this period, the bonus and any associated winnings are tagged as **"Voided”.**

***

##### Bonus Report

Navigation: **CHARM > Bonuses > Bonus Report**

![image-20250926-041101.png](https://sunny-genie-c9179b.netlify.app/1930461194/image-20250926-041101.png)

Bonus Report Filtering

* An additional option for filtering on Bonus Report is the **“Voided”** status.
* The player **claimed the bonus**, and the time countdown started, but they **did not use it** before the time ran out.

###### Bonus Report Columns

![image-20250926-125540.png](https://sunny-genie-c9179b.netlify.app/1930461194/image-20250926-125540.png)

Bonus Report

* **Bonus Assignment Expiration:** An additional **column** displays the date and time by which a player must claim a bonus after it has been assigned.
* **Bonus Usage Expiration**: Changing the column name from Expires by column to Bonus Use Expiration. It specifies the date and time a player must use the bonus after successfully claiming it.
* **Modified By**: This column indicates who or what last made a change to the bonus (Unfulfilled). In this scenario, it is **"System"** which means the system automatically initiated any updates to the bonus, such as its expiration.
* **Last Modified**: An additional column that shows the exact **date and time** when there was any "movement" or change to the bonus. This could be a player claiming it, the bonus expiring, or any other system-driven modification.

***

##### Player Management Wallets - Bonuses

Navigation: **Players > Player Management > Wallets > Bonuses**

![image-20250926-082305.png](https://sunny-genie-c9179b.netlify.app/1930461194/image-20250926-082305.png)

Player Management - Bonuses

* Allows viewing of the player’s bonuses and their respective statuses.
* Additional filter for **“Voided”** bonus status.
* Same display with Bonus Report.

###### Player Management - Assign Bonus

![image-20250930-023525.png](https://sunny-genie-c9179b.netlify.app/1930461194/image-20250930-023525.png)

Bonus: Manual Assignment

* **Hours to Expiration**: This field sets the bonus duration, which begins the exact moment the bonus is **manually assigned** to a player.
* **Hours to Use**: This field sets the bonus duration, which begins the exact moment a user **claims** the bonus.

***

##### Active Bonuses

Navigation: **Main Page > Bonuses > Active Bonuses**

Once a bonus is assigned to a player, a timer starts indicating when the player can claim it.

![image-20251002-090744.png](https://sunny-genie-c9179b.netlify.app/1930461194/image-20251002-090744.png)

Bonus - Pre-claim

* **Pre-Claim:** When a bonus is assigned but not yet claimed, the bonus card or listing should prominently display a countdown timer indicating the time remaining until the **Assignment Expiration**. The displayed time should be in a user-friendly format (e.g., "72h:15m:22s")
* If the **Assignment Expiration Type** is set to "No Expiry," then the "Number of hours" field will not be displayed on the player portal once a player has claimed their bonus.
* If the timer runs out before a claim, the bonus should be removed from the **Active Bonuses,** and it can be viewed on the Bonus History with a “Voided” status.

  ![image-20251002-090819.png](https://sunny-genie-c9179b.netlify.app/1930461194/image-20251002-090819.png)

  Bonus History
* **Post-Claim:** After a player successfully claims the bonus, the display should immediately switch to a countdown timer for the **Usage Expiration**. This timer will show the remaining time until the bonus funds or free spins expire.

  ![image-20251002-090910.png](https://sunny-genie-c9179b.netlify.app/1930461194/image-20251002-090910.png)

  Bonus - Post Claim
* **Usage Expiration:** If the timer runs out post-claim, any unused bonus funds should be voided, and the bonus should be marked as **"Voided"** in the player's history.

![image-20250924-011243.png](https://sunny-genie-c9179b.netlify.app/1930461194/image-20250924-011243.png)

Bonus - No Expiry

If the bonus isn't claimed on the player portal, the claim button will be disabled, and the time remaining will be 00:00:00.

![image-20251002-091018.png](https://sunny-genie-c9179b.netlify.app/1930461194/image-20251002-091018.png)

Bonus not claimed

***

##### Sample Scenarios

* **Scenario 1: Bonus expires before being claimed.**
  1. A bonus is assigned to Player A on Sept 13, 2025, at 10:00 UTC.
  2. **Assignment Expiration** is set to 24 hours.
  3. Player A does not claim the bonus by Sept 14, 2025, at 10:00 UTC.
  4. **Result:** The bonus is automatically removed from Player A's account and becomes unavailable.
* **Scenario 2: Bonus claimed and used.**
  1. A bonus is assigned to Player B on Sept 13, 2025, at 10:00 UTC.
  2. **Assignment Expiration** is set to 72 hours.
  3. **Usage Expiration** is set to 48 hours.
  4. Player B claims the bonus on Sept 14, 2025, at 10:00 UTC. The Assignment timer stops. The Usage timer starts, set to expire on Sept 16, 2025, at 10:00 UTC.
  5. Player B uses the bonus on Sept 15, 2025.
  6. **Result:** The bonus is successfully used.
* **Scenario 3: Bonus claimed but not used.**
  1. Same as Scenario 2, but Player B does not use the bonus by Sept 16, 2025, at 10:00 UTC.
  2. **Result:** The bonus is automatically voided from Player B's account and becomes unavailable for use.

##### Cashback Bonus

![image-20251001-033335.png](https://sunny-genie-c9179b.netlify.app/1930461194/image-20251001-033335.png)

Cashback Bonus Creation

* **Cashback is outside the scope of the standard bonus settings, which handle expiration and usage.**

  This design leads to two major exclusions in the Cashback configuration:

  1. **'Voided' Status Removed:**
     * **Cashback does not use the 'Voided' status** when it expires. Unlike other bonuses, Cashback **expires**.
     * Therefore, the logic that checks for and updates to the 'Voided' status upon expiration is not included from Cashback Bonuses.
  2. **'Hours To Use':**
     * Cashback's lifecycle is simplified (it only expires and is never voided), and the **'Hours To Use'** configuration is also **removed** from the bonus settings.

       ![image-20251001-045541.png](https://sunny-genie-c9179b.netlify.app/1930461194/image-20251001-045541.png)

       Cashback Bonus Info

***

Kor Translation: [보너스: 타이머 (할당 vs 활성화)](https://updates-proxy.gpappmanager.com/ko-bonus.md#p1951662081)

## “Modified By” Enhancement in Bonus System

This update introduces enhancements and fixes to improve the accuracy, enforcement, and reporting of bonus-related processes across the platform. The changes focus on clearer system audit information, stricter bonus validity enforcement, and more consistent bonus settlement reporting in the Back Office.

![imageedit\_2\_7764922826.png](https://sunny-genie-c9179b.netlify.app/2222489602/imageedit_2_7764922826.png)

##### Bonus Validity Enforcement Update

A new condition has been implemented to ensure that **expired bonuses can no longer be used for betting**. This enforcement applies consistently across all affected modules and providers.

##### Bonus Settlement Amount Display Correction

The calculation and display of the **settled bonus amount** on the Back Office bonuses page have been corrected. Bonus settlement values are now accurately reflected and consistent across all back-office bonus reporting pages.

##### **Core behavior rules** for “Modified By”

###### 1. Assigned

**Rule:**

* Manual assignment in BO → **Modified By = Admin username**
* Automatic assignment by the system → **Modified By = System**

**Examples:**

1. Admin gives a manual bonus:
   * Action: CS agent John manually assigns a “Compensation Bonus”.
   * Result: Status becomes `Assigned`
   * **Modified By:** `john.smith`
2. Auto-assigned deposit bonus:
   * Action: Player deposits; system auto-assigns a deposit bonus.
   * Result: Status becomes `Assigned`
   * **Modified By:** `System`

***

###### 2. Cancelled

**Rule:**

* Player cancels in Player Portal → **Modified By = Player username**
* Admin cancels in BO → **Modified By = Admin username**

**Examples:**

1. Player cancels their own bonus:
   * Action: Player `maria88` clicks “Cancel bonus” in portal.
   * Result: Status becomes `Cancelled`
   * **Modified By:** `maria88`
2. Admin cancels a bonus:
   * Action: CS agent `cs_admin01` cancels a problematic bonus in BO.
   * Result: Status becomes `Cancelled`
   * **Modified By:** `cs_admin01`

***

###### 3. Direct terminal statuses (system-driven)

Statuses: **Completed, Invalidated, Settled, Unfulfilled, Expired, Voided**

**Rule:**

* When these statuses are applied automatically (timers, wagering checks, bonus engine, cron, etc.) → **Modified By = System**

**Examples:**

1. Bonus expires by time:
   * Action: Player never uses a claimed bonus; its validity period ends.
   * Result: Status becomes `Expired` (via timer)
   * **Modified By:** `System`
2. Bonus becomes Unfulfilled:
   * Action: Player loses bonus balance; system auto-ends it as unfulfilled.
   * Result: Status becomes `Unfulfilled`
   * **Modified By:** `System`
3. Bonus gets Settled:
   * Action: All bets related to bonus are settled; engine finalizes it.
   * Result: Status becomes `Settled`
   * **Modified By:** `System`
4. Bonus is Voided by timer:
   * Action: Claim timer runs out before player claims.
   * Result: Status becomes `Voided`
   * **Modified By:** `System`

***

###### 4. Claimed

**Rule:**

* Player claims a bonus in Player Portal → **Modified By = Player username**

**Example:**

* Action: Player `leo777` clicks “Claim” for a bonus.
* Result: Status becomes `Claimed`
* **Modified By:** `leo777`

***

###### 5. One-line summary rule

Every status change will show one of:

* **System** → timers, cron, auto-assign, engine logic
* **Admin username** → manual action in Back Office
* **Player username** → action done by the player in Player Portal

Kor Translation: [보너스 시스템의 “수정자” 기능 강화](https://updates-proxy.gpappmanager.com/ko-bonus.md#p2222293003)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.