Player & Session Events

These events track player account lifecycle including registration, login/logout, and account changes.

---

OnUserLoggedIn

Triggered when a user logs into the system.

When it fires:

• Player logs into poker client
• Player logs into casino website
• Player authenticates via any client application

Field	Type	Description
playerId	integer	User ID
externalId	string	External system player ID
externalSystemCode	string	External system code
nick	string	Player nickname
clientVersion	string	Client version (e.g., "HTML5")
skin	string	Skin key
skinId	integer	Skin ID
deviceId	integer	Internal device identifier
deviceUniqueId	string	Unique device identifier
platform	string	Platform identifier
osName	string	Operating system name
osVersion	string	Operating system version
motherboardId	string	Motherboard identifier
cpuId	string	CPU identifier
appVersion	string	Client application version
ip	string	Player's IP address
macAddress	string	Player's MAC address
latitude	decimal	Player's latitude
longitude	decimal	Player's longitude
isFirstLogin	boolean	true if this is the player's first login
externalSessionId	string	External session identifier

Example:

{
  "params": {
    "playerId": 81622,
    "externalId": "83688319",
    "externalSystemCode": "test",
    "nick": "LOCALBOT_5822",
    "clientVersion": "HTML5",
    "skin": "base",
    "skinId": 0,
    "deviceId": 0,
    "deviceUniqueId": "12321321",
    "platform": "html5",
    "osName": "Windows",
    "osVersion": "10",
    "appVersion": "23.1.1.7d9855c",
    "ip": "8.8.8.8",
    "latitude": 23.232,
    "longitude": 23.3432,
    "isFirstLogin": false
  }
}

---

OnUserLoggedOut

Triggered when a user logs out of the system.

When it fires:

• Player logs out of poker client
• Player logs out of casino website
• Session expires or is terminated

Field	Type	Description
playerId	integer	User ID
externalId	string	External system player ID
externalSystemCode	string	External system code
nick	string	Player nickname
clientVersion	string	Client version
skin	string	Skin key
skinId	integer	Skin ID
deviceId	integer	Internal device identifier
deviceUniqueId	string	Unique device identifier
platform	string	Platform identifier
osName	string	Operating system name
osVersion	string	Operating system version
motherboardId	string	Motherboard identifier
cpuId	string	CPU identifier
appVersion	string	Client application version
ip	string	Player's IP address
latitude	decimal	Player's latitude
longitude	decimal	Player's longitude
externalSessionId	string	External session identifier

Example:

{
  "params": {
    "playerId": 6158,
    "externalId": "78963",
    "externalSystemCode": "",
    "nick": "john",
    "clientVersion": "HTML5",
    "skin": "evenbet",
    "skinId": 0,
    "deviceId": 219,
    "deviceUniqueId": "e742b6874741c1266b0539f9e89bb75d",
    "platform": "H",
    "osName": "W",
    "osVersion": "10.0",
    "appVersion": "23.1.1.7d9855c",
    "ip": "192.168.3.56",
    "latitude": 0,
    "longitude": 0
  }
}

---

OnPlayerRegistered

Triggered when a new player account is created.

When it fires:

• New user registers via client application
• New user created via Backoffice
• New user created via API

Field	Type	Description
playerId	integer	New player's ID
activationCode	string	Account activation code
callbackParam	string	Callback parameter
deviceId	integer	Device identifier

Example:

{
  "params": {
    "playerId": 81623,
    "activationCode": "ABC123",
    "callbackParam": "",
    "deviceId": 0
  }
}

---

OnPlayerAccountChanged

Triggered when a player's account information is updated.

When it fires:

• Player updates profile information
• Administrator updates player account in Backoffice
• Account attributes modified via API

Field	Type	Description
playerId	integer	User ID
skinId	integer	User's skin ID
externalId	string	External system player ID
externalSystemCode	string	External system code
accountChangedReasonType	integer	Reason code (see below)
changedFields	array	List of changed field names
changedAttributes	object	Map of changed attributes with new values

Account Change Reason Codes

Code	Reason	Description
0	Unknown	Unknown reason
1	AvatarChangedByPlayer	Player changed their avatar
2	PasswordChangedByPlayer	Player changed their password
3	PasswordChangedByAdmin	Password changed via Backoffice/API
4	EmailChangedByPlayer	Player changed their email
5	AddressChangedByPlayer	Player changed their address
6	NotificationSettingsChanged	Player updated notification preferences
7	AccountChangedByAdmin	Account modified via Backoffice/API (excluding password)
8	RegistrationInfoChanged	Player updated registration info (name, country, DOB, gender)

Example:

{
  "playerId": 6158,
  "skinId": 0,
  "externalId": "EXT123",
  "externalSystemCode": "default",
  "accountChangedReasonType": 7,
  "changedFields": [
    "f_display_name"
  ],
  "changedAttributes": {
    "tagg": "value",
    "GlobalFreeRabbitHuntingActionPerformed": ""
  }
}

Attribute Values

• A non-empty string indicates the new value for the attribute
• An empty string "" indicates the attribute was deleted

---

OnUpdatePlayerBlockStatus

Triggered when a player is blocked or unblocked.

When it fires:

• Player blocked by administrator
• Player blocked automatically (policy violation, too many failed logins, etc.)
• Block lifted

Field	Type	Description
playerId	integer	Internal player ID
externalId	string	External system player ID
externalSystemCode	string	External system code
skinId	integer	User's skin ID
isBlocked	boolean	true = blocked, false = unblocked
blockingLimit	string	Block expiry timestamp
blockingReason	integer	Reason code (see below)
objectId	null	Not used

Block Reason Codes

Code	Reason	Description
0	Unknown	Unknown reason
32	None	No specific reason
71	GeneralViolation	Blocked by administrator
73	ProhibitedIp	IP address blocked
77	MessageRestriction	Anti-DDoS protection (too many messages)
80	PasswordPolicyViolation	Too many incorrect password attempts

Example:

{
  "playerId": 105,
  "externalId": "EXT105",
  "externalSystemCode": "default",
  "skinId": 0,
  "isBlocked": true,
  "blockingLimit": "2023-10-09 10:57:21",
  "blockingReason": 71,
  "objectId": null
}

---

Related Events

• Security Events — For 2FA and external authentication events
• Financial Events — For balance changes when accounts are modified