Check Session

Validates the session token for a game and returns the player's identity, current balance and currency. FE calls it once when the game loads.

Auth: Player session — Authorization: Bearer {token}
Rate limit: 300 requests per 60 s per IP (GAME_CHECK_SESSION)
Games: THAI-HILO, LOTTO

Rules

gameCode is case-insensitive; the response echoes it upper-cased.

A token from the operator's game-launch link is bound to one game: calling with another gameCode answers 403 99903. Demo tokens work with any game.

Blocked by both system-wide and this game's own maintenance (503 99915). Check Session and Get Balance are the /c/g calls that check the game's own maintenance; every /g/{game} route checks it too.

balance is a decimal string; a negative balance is returned as "0.00".

For seamless-wallet players every call asks the operator's wallet live (up to 3 retries, 10 s each), so allow a generous timeout (about 40 s worst case).

language is the language the operator passed at game launch ("" for demo); use it for the initial UI language. It does not follow Accept-Language.

Unknown gameCode answers 404 99948 here.

Same response as GET /c/g/{gameCode}/balance.

Flow

Validates the token and checks system and per-game maintenance.

Resolves gameCode (THAI-HILO or LOTTO).

Rejects a game-launch token that was opened for a different game.

Reads the balance for the player's wallet type: demo session balance, transfer wallet, or a live request to the operator's seamless wallet.

Returns a negative balance as "0.00" and adds the currency symbol.

Returns the player, balance and session details.

curl --location 'https://dev-api.ambfairgame.com/gapi/v1/gapi/v1/c/g/LOTTO/check-session' \ --header 'Authorization: Bearer 3f9a1c7e5b2d4f6081a3c5e7f9b1d3f5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b7' \ --header 'Accept-Language: th'

{ "code": "0", "description": "Success.", "traceID": "0f8e2c1a-6b3d-4e5f-9a7b-1c2d3e4f5a6b", "data": { "id": 1024, "playerName": "Player One", "balance": "1520.75", "currency": "THB", "symbolCurrency": "฿", "isDemo": false, "gameCode": "LOTTO", "language": "th" } }

Request

Responses