Skip to main content
POST
https://s-apis.oppigames.com/
/
game
/
bonus-configure
Bonus Configure
curl --request POST \
  --url https://s-apis.oppigames.com/game/bonus-configure \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-signature: <x-signature>' \
  --header 'x-timestamp: <x-timestamp>' \
  --data '
{
  "bonuses": [
    {
      "playerId ": "<string>",
      "bonusType": "<string>",
      "bonusAmount": 123,
      "gameId": "<string>",
      "index": 123,
      "currency": "<string>",
      "totalSpinCount": 123,
      "spinBetAmount": 123
    }
  ]
}
'
{
    "status": "RS_OK",
    "data": [
        {
            "status": "RS_OK",
            "index": 1,
            "bonusId": "4eda52cd-b8a6-43fa-b5d6-327f003032b7"
        },
        {
            "status": "RS_OK",
            "index": 2,
            "bonusId": "8eda00cd-b8a6-43fa-b5d6-327f00303289"
        }
    ]
}

​
Headers

​
x-api-key
string
required
A unique identifier associated with operator calling API.
​
x-signature
string
required
A SHA256 HMAC signature generated using the request body and timestamp. Format: HMAC_SHA256(JSON.stringify(data) + ’|’ + timestamp), signed using the provided secret key.
​
x-timestamp
string
required
An Unix timestamp (milliseconds) Used to verify the request’s freshness. Ensure the same value is used in signature generation.
The signature will remain valid for only 5 minutes from the provided timestamp.
​
Content-Type
string
required
Must be set to application/json.

​
Request Body

​
bonuses
object[]
required
Array of bonus objects

​
Bonus Types

Bonus TypeDescription
Free SpinsA bonus to grants the player any number of free spins, having winning up to the configured reward amount.
Wheel Of FortuneA bonus mini-game featuring a spinning wheel.
Cascading ReelsA bonus game where winning symbols disappear and new symbols fall into place, potentially triggering bonus multiplier for additional wins in a single spin.
Fortune GuessA bonus mini-game game where the player is presented with multiple items and must guess the correct one.
WageringA bonus where player can claim/unlock bonus wallet/winnings
Card ScratchA bonus mini-game where the player is presented with multiple cards and must guess & scratch the correct one.

​
Response

​
status
string
required
Code indicates status of the request weather it is succeed or failed. We have listed error codes here
​
data
array
required
List of bonuses configured in request.
{
    "status": "RS_OK",
    "data": [
        {
            "status": "RS_OK",
            "index": 1,
            "bonusId": "4eda52cd-b8a6-43fa-b5d6-327f003032b7"
        },
        {
            "status": "RS_OK",
            "index": 2,
            "bonusId": "8eda00cd-b8a6-43fa-b5d6-327f00303289"
        }
    ]
}