Balance

Our API will send this callback request when a player launches or enters games or every minute during gameplay to update the user's balance. You are required to verify whether the player's session is still active and authenticated before processing the request.

URL	{operatorCallbackURL}
Method	POST
Headers	X-Request-Signature Content-Type Accept
Request Body	{ command: "balance", playerId: "1101", currency: "EUR", timestamp: 1586335186372 }
Response Body	{ balance: 1501.52, statusCode: "OK" }

Request

Parameter	Values	Mandatory	Description
command	string	Y	Indicates the request type.
playerId	string	Y	Unique identifier of the player from the operator's system.
currency	string	Y	Player currency, according to ISO-4217 (EUR, USD ...)
timestamp	number	Y	Timestamp of the request.

Response

Parameter	Values	Mandatory	Description
balance	number	N	Player balance.
statusCode	string	Y	Status code of the execution.

Possible Status Codes

Status codes	Reason
OK	Request successful
ERR_INVALID_ACCOUNT	In case the player currency does not match the provided currency code in the request.
ERR_NOT_AUTHENTICATED	Player is not authenticated
ERR_INVALID_PLAYER_ID	Invalid player ID
ERR_INTEGRITY_CHECK_FAILED	Message integrity check failed.
ERR_UNKNOWN	Internal server error

In case statusCode is different than "OK", the request will be treated as unsuccessful. Request retry schedule will not be created for any type of error. Current process flow will be terminated with an error message presented to the player.

Example

Request

{
    "command": "balance",
    "playerId": "1101",
    "currency": "EUR",
    "timestamp": 1586335186372
}

OK Response

{
    "balance": 19839891,
    "statusCode": "OK"
}

Error Response

{
    "statusCode": "ERR_INVALID_ACCOUNT"
}