Action 72：Create Free Spin Reward Event

Function Description

• Please make sure to implement Free Spin Reward (Action 16) in order for the prize distribution to function properly.

• Free Spin Reward Event cannot be modified after creation, including the type, times, bonusChips, chipsMultiplier, startTime and endTime
• The minimum withdrawal must be less than or equal to the maximum withdrawal.
• The end time must be later than the current time.
• If the players field is provided, players will be bound upon creation.
  • To avoid long API execution times, each call is limited to 50,000 player accounts. Use Action 74 to add more.
• If the eventId field is provided, it will be used to create the event with the specified ID following the rule: 1 to 50 characters consisting of letters, digits, or underscores (_). If not provided, the system will generate one automatically.
• If eventId is returned, it indicates successful creation of free spin reward event
• Whether player binding succeeds or not does not affect the creation of the free spin reward event
• About Free Spin Reward Single Bet Amount :
  • Since the bet options of each currency houses, agents, and games are different, the system will automatically select Matched Bet Amount(the closest bet amount that does not exceed the specified value).
    For instance, the bet options for Game A are 1, 5, 15, 20, 30, while the bet options for Game B are 1, 5, 20, 25, 30.
    bet is set as 25, when the player joins one of the games, the bet amount will vary as the following:
    The Matched Bet Amount in Game A will be 20.
    The Matched Bet Amount in Game B will be 25.
    Therefore, bet must be greater than the minimum bet amount for all specified games.
  • When creating a Feature Game, the system will check whether
    Matched Bet Amount × Feature Game Multiplier does not exceed the Maximum Feature Game Bet Limit.
    
    (You can use the query service provided by Action 49: Query Game List to retrieve the Feature Game Multiplier and the Maximum Feature Game Bet Limit.)
    • Example:
      Game A bet options: 1, 5, 15, 20, 30
      Game B bet options: 1, 5, 20, 25, 30
      Game A feature multiplier = 50, Game B feature multiplier = 100
      Maximum Feature Game Bet limit for both Game A and Game B = 2000
      When Feature Game bet is set to 25 to create a Feature Game:
      Game A Matched Bet Amount is 20.
      Game B Matched Bet Amount is 25.
      Game A Matched Bet Amount × Feature Multiplier = 20 × 50 = 1000
      Game B Matched Bet Amount × Feature Multiplier = 25 × 100 = 2500
      Since Game B’s Matched Bet Amount × Feature Multiplier exceeds the Maximum Feature Game Bet Limit (2500 > 2000),
      neither Game A nor Game B can be created.
• About the Bonus Chips Free Spin Reward Game
  • Both bonusChips and chipsMultiplier parameters are required. The system will calculate the Required Turnover by multiplying bonusChips and chipsMultiplier.
  • Players can use bonusChips to place bets, and each bet will accumulate turnover. If the player's accumulated turnover reaches the Required Turnover, they can withdraw the remaining bonusChips.
  • For instance,
    • bonusChips are set to 100, and the chipsMultiplier is set to 2.5, so the Required Turnover is 250. When the player accumulates a turnover of 250 and the remaining bonusChips are 30, the withdrawal amount will be 30.

Parameter

When type = NORMAL

When type = FEATURE

when type is BONUS

Example

{
  "action": 72,
  "ts": 1711555200000,
  "parent": "testag",
  "eventId": "event_001",
  "name": "TEST EVENT NAME",
  "startTime": "2024-07-22T04:05:33.000+01:00",
  "endTime": "2024-07-22T04:05:33.000+01:00",
  "machineTypes": [
      14077,
      14085
  ],
  "bet": "2.000",
  "times": 10,
  "type": "NORMAL",
  "minWithdrawal": "10.000",
  "maxWithdrawal": "100.000",
  "transactionId": "testtransactionId00001",
  "players": [
      "player1",
      "player2"
  ],
  "mysteryType": "NONE"
}

{
  "action": 72,
  "ts": 1711555200000,
  "parent": "testag",
  "eventId": "event_001",
  "name": "TEST BONUS CHIPS EVENT NAME",
  "startTime": "2024-07-22T04:05:33.000+01:00",
  "endTime": "2024-07-22T04:05:33.000+01:00",
  "machineTypes": [
      14041,
      14087
  ],
  "bonusChips": "100.000",
  "chipsMultiplier": "2.50",
  "type": "BONUSCHIPS",
  "minWithdrawal": "10.000",
  "maxWithdrawal": "100.000",
  "transactionId": "testtransactionId00001",
  "players": [
      "player1",
      "player2"
  ],
  "mysteryType": "NONE"
}

Return Results

Data Object

Operation Sample

// Http Request
http://{API_Address}/apiRequest.do?dc=jb1&x=y1wayxScczy6ABfElfaVwb5CdfHxBN_JGtxyBSvpohLQakP8M2QSetJNojJBzvnrVChhq8YWWgBTdGeXFTH4vSNQQ66epf4NqYeQ-6bJ15pvHctQjQevulv7GHqOifuju_gY0H54FfVdQc9D5tKh1AZ-9KDh9dwcGSszZxU7JOOoHdYITlCO5LhvGmHxPBwZ
 
// Http Response (success)
{
    "status": "0000",
    "data": {
        "eventId": "event_001",
        "failedBindingPlayers": [
            "failed1", "failed2"
        ],
        "notExistedPlayers": [
            "not_exist1", "not_exist2",
        ]
    }
}
 
// Http Response (failed)
1. If necessary parameters are not provided or not meet requirement, for example: name, then:
{
    "status": "8000",
    "err_text": "The parameter of input error, please check your parameter is correct or not. parameter:name is required"
}