Callback Action: debit / credit

call_id is the unique transaction id. Keep it as your reference.

Behaviour

• Handle debit and credit independently
• Link a credit to the most recent debit for the same username, game_id, and currency if you need to pair them
• Some providers mint a new round_id per action; that can also change gameplay_final
• Rollbacks include the original round_id and can be debit or credit

Requests

All callbacks are GET to your configured callback URL.

Spin

{
  "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

{
  "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

Sent while playing spins from addFreeRounds. Do not deduct cash on debit when type is 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
  }
}

Try this in Callback Lab as bonus free spin.

Responses

Successful

Debit taken or credit applied. Return the new wallet.

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

On bonus_fs debit: do not deduct cash; still return the current cash balance with error: 0.

Insufficient balance

Player cannot cover a debit. Do not change the wallet.

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

Do not use error: 1 on credit.

Processing error

Unknown player, stale timestamp, or bad key.

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