Action 72：Create Free Spin Reward Event

Function Description

• Free Spin Reward Event cannot be modified after creation, including the type, times, bonusChips, and chipsMultiplier
• 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 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 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 bet amount in Game A will be locked at 20.
    • The bet amount in Game B will be locked at 25.
  • Therefore, bet must be greater than the minimum bet amount for all specified games.
• 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 is NORMAL or FEATURE

when type is BONUS

Example

{
  "action": 72,
  "ts": 1711555200000,
  "parent": "testag",
  "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",
  "players": [
      "player1",
      "player2"
  ]
}

{
  "action": 72,
  "ts": 1711555200000,
  "parent": "testag",
  "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",
  "players": [
      "player1",
      "player2"
  ]
}

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": 12345,
        "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"
}