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
}