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"
        }
    ]
}