Callbacks
Credit and Debit

Callback Action: debit/credit

Depending on the callback action you should credit/debit your player's balance for the amount given on callback.

If player does not have enough balance on debit action, you should return the insufficient balance response (error: 1) like shown below.

The call_id is a unique id sent with each callback and can be considered the transaction id.

Important note

You should allow credit action and debit action independently of each other.

There are cases where a credit callback can be sent without first sending a debit callback, per example in case of rollback/refund system activated.

In some game providers there may be occurances where new round_id is made on each game action, for example when bonus game won on some providers this might be sent as individual game rounds and will thus only send credit action.

This may also affect gameplay_final in particular cases.

Requests

Requests are sent as GET to your callback url, which is specified on your API key configuration.

Spin Callback

{
  "amount": 100,
  "username": "yourPlayerId9959",
  "currency": "USD",
  "action": "debit",
  "gameplay_final": 0,
  "type": "spin",
  "round_id": "312875958396",
  "game_id": "onlyplay/LigaFortunaMegaways",
  "call_id": "f51fce58-2e0e-461b-8a0c-87ecba0600c2",
  "timestamp": "1696463565",
  "key": "4e54de0b17adf322365c0540bd7db57a"
}

Free Round Spin Callback

This callback is sent when player is playing on gifted free rounds, after using the addFreeRounds method.

You should not deduct a player's balance on debit callbacks when type variable is set to bonus_fs.

{
  "amount": 25,
  "currency": "CAD",
  "action": "debit",
  "gameplay_final": 0,
  "type": "bonus_fs",
  "round_id": "1074911949",
  "game_id": "platipus/luckycat",
  "username": "wmlmhohuhfs",
  "call_id": "6ce7154b-be61-4bab-b5a6-642488064c41",
  "operator_id": 24,
  "timestamp": "1696463565",
  "key": "ed3a34c119wec67fb8e37691b5885f0",
  "freespins": {
      "total": 20,
      "performed": 3
  }
}

Responses

Balance must be returned as integer and in cents, that means if your player's balance is 2.50$ this should be returned as 250.

Succesful Response

  {
    "error": 0,
    "balance": 250
  }

Insufficient Balance

  {
    "error": 1,
    "balance": 250
  }

Processing Error (for example player not found or invalid signature)

  {
    "error": 2,
    "balance": 0
  }
BalanceValidation