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 rare cases where a credit callback can be sent without first sending a debit callback, per example in case of rollback/refund system activated. In this case if you need tie it to a debit action, simply look up the most recent debit transaction in your system for the specific player, game & currency and attach the credit to that round.

In some game providers there may be rare occurances where new round_id is made on each game action. For example when bonus game won subsequent spins within the bonus game on some providers might be sent as individual unique game round_id's and will thus only send credit action.

This may also affect gameplay_final in rare cases.

Rollbacks

Any rollback events, which can both be debit or credit action will be marked under the rb variable on our callbacks.

When this variable is 1 it means the sent action is a rollback. The original round_id should be included and you should proceed to either debit or credit the player's balance like you would on a regular callback.

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",
  "rb": 0,
  "key": "4e54de0b17adf322365c0540bd7db57a"
}

Rollback Spin Callback

{
  "amount": 100,
  "username": "yourPlayerId9959",
  "currency": "USD",
  "action": "credit",
  "gameplay_final": 0,
  "type": "spin",
  "round_id": "312875958396",
  "game_id": "onlyplay/LigaFortunaMegaways",
  "call_id": "87ecba0600c2-2e0e-461b-8a0c-8a0c2ds",
  "timestamp": "1696463565",
  "rb": 1,
  "key": "ed3a34c119wec67fb8e37691b5885f0"
}

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",
  "rb": 0,
  "key": "ed3a34c119wec67fb8e37691b5885f0",
  "freespins": {
      "id": 7,
      "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
  }