Sessions
session.closed
Tells your server that a session closed, who closed it, and why.
Who calls it
We → you
POST {your server}/v1/session.closedA session can close on our side without you asking: the player pressed exit, was idle, or started a new session. You must know, or your session stays open. We sign the call with our private key. Check it with our public key for the environment. See Signing calls.
Request
| Field | Type | What it is |
|---|---|---|
eventId | string | We send the event again until you accept it. Ignore an eventId you have seen. |
sessionId | string | Which session. |
casinoSessionId | string | Which session on your side. |
playerId | string | Whose session. |
closedBy | string | casino, player or system. |
reason | string | Why it closed. See the table below. |
startedAt | string, UTC time | When the session started. |
openedAt | string, UTC time | When the game link was first opened. Empty for not_opened. |
closedAt | string, UTC time | When it closed. |
openRoundId | string, optional | Only if a Mines round is still open. A bet is still waiting for its result. |
Answer
Answer ok to accept the event. This is the only event. There is no round event: you learn each round’s end from wallet.win or wallet.loss.
Who closes, and why
A session has two states: active and closed. A closed session never opens again.
| Closed by | reason | When |
|---|---|---|
casino | your own text, e.g. logout | You call session.close. |
player | exit | The player pressed exit in the game. |
system | not_opened | The game link was not opened within 2 minutes. |
system | idle | No player action for 30 minutes. This also covers a closed page, which tells us nothing. |
system | replaced | You allow one session per player, and the player started a new one. |
system | environment_deleted | You deleted the Sandbox environment. |
Errors
No error codes are defined for your answer. If you do not accept the event, we send it again with the same eventId.
- We wait 5 seconds for each try.
- We try again until you accept it, for up to 30 days.
- After that we stop. The session shows “Not delivered” in the back office.
Example
Request
{
"eventId": "e-01JC9A…",
"sessionId": "s-01JC8Z…",
"casinoSessionId": "c-5531",
"playerId": "p-82731",
"closedBy": "system",
"reason": "idle",
"startedAt": "2026-10-31T09:02:11Z",
"openedAt": "2026-10-31T09:02:13Z",
"closedAt": "2026-10-31T09:47:30Z",
"openRoundId": "r-01JC90…"
}
Answer
{ "ok": true }