KRS Tester

KRS Service API

1

Login

Login with your kiosk admin or entity account

Request headers goes here

Request body goes here

cURL sample goes here

Response headers goes here

Response body goes here

2

API Request

Enter your API Request

Request headers goes here

Request body goes here

cURL sample goes here

Response headers goes here

Response body goes here

GamesLinkWallet API

1

Setup Agent Endpoint

Enter Mock ID and Default Tracking ID
https://endpoint2.pcmcsi.net/

2

Setup API Responses

Configure responses for GamesLinkWallet API endpoints.

An authenticate request is needed for validating the external token passed to Playtech during the game launch flow. For extra security, the Operator has an option to return a permanent external token in the response to be used for wallet communication and treat the external token passed during the game launch as a temporary one. The authenticate request response must return also some player specific parameters, like currency and country, for Playtech to be able to create the player record on their side on the fly, in case it doesn't exist already. Under normal circumstances the Authenticate request is made only once per one game launch.

AuthenticateResponse

Player Data
Bet Limits
Error

Used for retrieving player's balance snapshot from the Operator's wallet.

GetBalanceResponse

Balance *
One-time use only. If a value is set, it'll be used in the response for /getbalance request for a single time and will reset to default (using Player's balance) thereafter. Player's balance will reset to this amount after responding to /getbalance request.
Error

This request is used for placing a bet during the gameplay. It has a mandatory parameter to identify the game round, by which the Operator's wallet must decide whether to start a new game session or use an existing one. In case of bonus rounds, it has got reference to the parent game round. Bet amount defines the amount of money to be requested from the Operator's wallet. In case of free spins, it is 0. If free spins are used, Playtech's wallet bonus fund changes are described in the internal fund changes list.

BetResponse

Balance *
One-time use only. If a value is set, it'll be used in the response for /bet request for a single time and will reset to default (using Player's balance) thereafter. Player's balance will reset to this amount after responding to /bet request.
Player Dialog
Error
Custom Data

This request is used for reporting game round result(s). It may or may not close the game round. Multiple GameRoundResults can be sent during one game round. A game round can result in lose, win or refund. In case of player losing, no transactional data is sent. Otherwise the pay amount is defined.

GameRoundResultResponse

Balance *
One-time use only. If a value is set, it'll be used in the response for /gameroundresult request for a single time and will reset to default (using Player's balance) thereafter. Player's balance will reset to this amount after responding to /gameroundresult request.
Error
Custom Data

This request is primarily used for submitting the player's choice regarding the reality check timer. The dialog ID that was received in Bet response will be passed along with the request.

SubmitDialogResponse

Error

Used for retrieving player's balance snapshot by context from the Operator's wallet.

GetBalanceByContextResponse

Balance *
One-time use only. If a value is set, it'll be used in the response for /getbalancebycontext request for a single time and will reset to default (using Player's balance) thereafter. Player's balance will reset to this amount after responding to /getbalancebycontext request.
Error

Sent to keep player login session alive during low activity game play.

KeepAliveResponse

Error

Sent when the session expires on the Playtech side. The Operator can invalidate the session related to the given external token and not accept requests with it any more (except retries).

LogoutResponse

Error

This request is to transfer funds to the Operator's wallet outside of a regular game round. This is mostly relevant in case of free spins with wagering requirements, where bonus winnings are released after the wagering has been completed.

TransferFundsResponse

Balance *
One-time use only. If a value is set, it'll be used in the response for /transferfunds request for a single time and will reset to default (using Player's balance) thereafter. Player's balance will reset to this amount after responding to /transferfunds request.
Error

This request is to notify the Operator about an event with bonus instance. Currently supports ACCEPTED and REMOVED status. The request is not sent by default and needs to be explicitly enabled for the integration.

NotifyBonusEventResponse

Error

This request is used to ask for funds from the operator's wallet when a player tips a dealer in a Live game.

LiveTipResponse

Balance
One-time use only. If a value is set, it'll be used in the response for /livetip request for a single time and will reset to default (using Player's balance) thereafter. Player's balance will reset to this amount after responding to /livetip request.
Error

Used in Italian regulation where Playtech games provide bring money dialog and Operator handles regulator communication. Sent when a player has chosen an amount to bring to the table and table session is started.

ItalyBringMoneyToTableSessionResponse

Error

Used in Italian regulation where Playtech games provide bring money dialog and Operator handles regulator communication. Sent when table session is closed.

ItalyEndTableSessionResponse

Error

Used for synchronizing reality check status between Playtech and Operator.

RealityCheckSyncResponse

Player Dialog
Error

3

Launch Game

Setup game parameters

Get permissions

Get all available permissions

Check password

Verify admin password

Create kiosk admin

To create a new kiosk admin under the specific business entity

Create new limits

Create new admin limits

Get kiosk admin info

To get the information of the specific kiosk admin

Get admin limits

To get the list of admin limits

Get kiosk admin list

To get the complete list of kiosk admins created under the specific bussiness entity

Admin login

Authentificate admin by username and password

Move admin

Move admin to another entity

Admin active permissions

Get permissions Admin permissions (inherited from role or set custom)

Remove limits

Remove admin limits

Reset failed logins

Reset failed login attempts for Admin

Set permissions

Set Admin custom permissions (role have to be set to custom first)

Set limits action

To save limits to admin

Update kiosk admin

To update the information of specific kiosk admin

Change password

Change password for admin

Check if kiosk admin online or offline

Check if kiosk admin online or offline

Logout admin if admin is online

Logout admin if admin is online

Add specific permissions for all active admins in specific entity

Add specific permissions for all active admin in specific entity

Remove specific permissions from all active admins from specific entity

Remove specific permissions from all active admin from specific entity

Set specific permissions for all active admins in specific entity

Set specific permissions for all active admin in specific entity

Delete ip whitelisting from admin

Delete ip whitelisting from admin

Get ip whitelist from an admin

Get ip whitelist from an admin

Set ip whitelist to admin

Set ip whitelist to admin

IP Check

templatedetails

Get all custom reports

To get the list of all available custom reports

Get custom report

To get the data of the specific custom report

Get decorators

Decorators and post process JS

Get report form

To get the required input parameters description of the specific custom report

Get report weight

Get custom report weight data

Get last aggregated date

Get last aggregated date (in timezone TLE)

Get entity balances

To get the list of entity balances

List broken games

To get the list of broken games for all players

Drop entity cache

Drop Entity run time config caches

Create new balance

Create new entity balance

Deposit action

To add credits to child entity

Deposit bonus action

To add bonus to child entity

Freeze entity

To freeze entity and all it's admins, kiosks and subentities

Generate Key

To generate a new key for the specific business entity

Get entity list

To get the complete list of business entities created under the structure

List blocked IPs

To get the list of blocked IP address(es)

Move entity

Move entity to another entity

Get entity peak players online info

To get the information of amount of min, max, per minute map of player online during selected period

Allow/disallow to create players in the entity

Allow/disallow to create players in the entity

Players Allowed

Remove balance

Remove entity balance

Set bonus owner

Set bonus owner for entity balance

Bonus Owner

Set deposit owner

Set deposit owner for entity balance

Deposit Owner

Get structure

To get the list of business structure

Unblock IPs

To unblock kiosk admin's locked IP addresses using the Top admin account

Unfreeze entity

To unfreeze entity and all it's admins, kiosks and subentities

Entity withdraw action

To withdraw money from child entity

Withdraw bonus action

To withdraw bonus money from child entity

Check if entity online or offline

Check if entity online or offline

Get all online admins

Get all online admins

Get all online entities

Get all online entities

Logout all admins

Logout all admins in entity if they are online

Logout entity if entity is online

Logout entity if entity is online

setviplevel

setviplevel

Clear 2FA login token

Remove 2FA entity auth token so its became impossible to login with this entity

Generate 2FA access Key

To generate a new key for the specific business entity.

Get 2FA state

Get is Entity 2FA auth enabled or not

Entity login

Authentificate entity by name, key and 2fa - result secret token can be send as 'X-Entity-Secret' Header to authorise API calls

Reset failed logins

Reset failed login attempts for Entity

Get ip whitelist propagated from an entity

To get ip whitelist configuration propagated from an entity

Get ip whitelist from an entity

Get ip whitelist from an entity

Set ip whitelist to entity

Set ip whitelist to entity

Enabled

Get free spins list of bonuses 'name | bonusid' available for TLE

To get free spins list of bonuses 'name | bonusid' available for TLE

Free spin deposit entity action

To add free spin point to a entity free spin balance

Free spin withdraw entity action

To remove free spin point from entity free spin balance

Game flow

To get nearly real time games flow (up to 30 sec update delay), by default last fully processed minute games in response (It is not recommended to use a range more than 48 hours in the past)

Game stream

To get nearly real time games flow , by start from 6 sec delay, manually start point can be set up to 48 hours in the past

givefreespins

Used for giving players free spins. It is possible to define the free spin count and the list of games in which it is usable together with the win wagering multiplier (if the correct bonus template is used). This request also creates a player record on-demand, meaning that the Operator must pass a couple of player related parameters. If the Operator is sure of having created the player record already, it can leave the player-specific fields empty.

Player Data

givegoldenchips

Used for giving player golden chips based on a bonus template configured on Playtech side. It is possible to define the golden chips count, chip value and list of games in which it is usable. This request also creates a player record on the Playtech side on-demand, meaning that the Operator must pass a couple of player related parameters. If the Operator is sure of having created the player record already on the Playtech side (e.g. has successfully issued player a bonus at least one time), it can leave the player-specific fields empty.

Player Data

removebonus

Used for removing a bonus instance that has been given to the player. Requires the bonus instance code on the Playtech side to be passed.

removefreespinbonus

Used for removing a Free Spin bonus instance that has been given to the player. Requires the bonus instance code on the Playtech side to be passed.

removegoldenchipbonus

Used for removing a Goldenchip bonus instance that has been given to the player. Requires the bonus instance code on the Playtech side to be passed.

getplayeractivebonuses

Returns a list of player's active bonuses. It includes the bonus name, the remaining amount or count depending on the bonus type, the remaining wagering requirements and bonus balance.

endloginsession

Used for logging out player login sessions on the Playtech side. If the player has a game window opened, they are notified about the logout.

getplayerbonushistory

Returns a list of player's non-active bonuses that have been issued in the last year. Maximum number of bonuses returned is 500, ordered by removal date (descending).

sendplayermessage

Used for showing messages to the player inside Playtech gaming clients. It is advised to use this call only when Operator is unable to show messages on top of Playtech gaming clients from their Portal (e.g. on mobile devices in redirect-mode). It should be used for messages that are not possible to return in External Wallet request responses (e.g. time based notifications). The message is displayed in all open Playtech gaming clients. Successful response means that Playtech has received the message, but actually player might not have seen it yet.

notifyresponsiblegamingevent

Used to notify Playtech about a responsible gaming limit that player has reached. This is relevant for download/native clients, where the operator is unable to handle regulatory requirements in the wrapping web page.

getsupportedfreespinbetvalues

Used for retrieving the list of supported Free Spin bet values for a game or set of games. If multiple games are provided, then a list of common bet values across specified games is returned. Returned bet values are used to issue a Free Spin bonus to the player - at least one or more values must be provided.

notifybalancechange

Used for notifying Playtech system that the balance on external wallet side has changed and fresh balance should be requested.

getgamehistoryurl

This request returns the URL to the detailed game history view of a specific game round.

Get golden chips list of bonuses 'name | bonusid' available for TLE

To get golden chips list of bonuses 'name | bonusid' available for TLE

Log admin login/logout

Log admin login/logout

Log create admin

Log create admin

Log create entity

Log create entity

Log entity login

Log entity login

Execution log

Execution log (entity exec logs)

Log player

Log player (except create)

Log structure

Log structure (entity kioskadmin logs)

Seamless log

Seamless log (seamless exec logs)

Get bonus templates

Used for removing a bonus instance that has been given to the player. Requires the bonus instance code on the Playtech side to be passed.

Get Player broken games

To get the broken games of a player.

Change password for player

Updates or generates password for player.

Freeze player

To freeze player

Get Player session games

To get player games of a session

Get player info

To get the information of the specific player username

Get players

To get the list of all players created.

Logout player

To logout the specific player from the game

Mass freeze players

Used for removing a bonus instance that has been given to the player. Requires the bonus instance code on the Playtech side to be passed.

Is Freeze
Params

Mass logout players

To logout mass volume of players from the game.

Params

Is player online

To check if the player is currently online.

Reset failed login attempts

To remove temporary lock of the specific player account upon entering 3 incorrect username or password.

Revert broken game

To revert the broken game of the specific player

Get player serials

To get specific player serials.

Get Player sessions

To get the sessions of a player

Player tags

Get player tags

Unfreeze player

To unfreeze player.

Update player

To update the information of a specific player account

Playername validation

Verify if provided playername is fits name requirements and available to use

Get roles

Get list of roles per TLE

Permisisons per role

Get permissions set per role

Get entity info

To get the information of the specific business entity

Create entity

To create a new business entity

Update entity

To update the information of the specific business entity

Clear 2FA for an admin

Clear 2FA for an admin

Generate 2FA for an admin

Generate 2FA for an admin

Get status of 2FA configuration for an admin

Get status of 2FA configuration for an admin

Used for removing a bonus instance that has been given to the player. Requires the bonus instance code on the Playtech side to be passed.