Game Launch
The game is launched via an HTTP GET request (URL redirect).
The Merchant must redirect the Player to the HPGames game launcher URL with the required query parameters.
The sequence diagram below illustrates the communication flow between the Player, HPGames and the Merchant for each game launch request.
Launch Parameters
The following table details the parameters that the Merchant must supply to the HPGames platform to launch a game.
| Parameter | Type | Description | Required |
|---|---|---|---|
| merchantId | UUID | Merchant identifier | Yes |
| authToken | String | Authentication token representing the Player session | Yes |
| gameId | Integer | Identifier of the game to be launched (provided by HPGames via API or static list) | Yes |
| demo | Boolean | Indicates whether the game should be launched in demo mode without real money transactions. Defaults to false | No |
| language | String | ISO 639-3 language code (e.g. ENG, SRP, DEU). Defaults to ENG | No |
Example Launch URL
{BASE_URL}/game/launcher?gameId=1&merchantId=1387a6cc-3651-4473-ae52-e415caea3395&demo=false&authToken=6dc6c60a-d581-46a0-9ece-2a1765009128&language=ENG
note
The BASE_URL will be provided by HPGames for each environment (e.g. staging, production).