Get Games

Retrieves a list of games available for a specific Merchant. The game list should be cached on the merchant side and refreshed periodically.

POST /api/v1/merchant-games/gameList

---

Request

Parameter	Type	Description	Required
merchantId	UUID	Merchant identifier	Yes
timestamp	Long	UNIX timestamp in milliseconds	Yes
hash	String	HMAC SHA256 signature used to verify the request	Yes

Hash Fields

The following fields are included in the hash calculation, in the exact order:

• merchantId
• timestamp

For details on how the hash is generated, see the Hash Algorithm.

Example Request

{
  "merchantId": "1387a6cc-3651-4473-ae52-e415caea3395",
  "timestamp": 1709289932725,
  "hash": "9ed3d547f9a672ecd4884304e859af84263410d613ff2a2bb7d70a8221d7e544"
}

---

Response

Parameter	Type	Description
id	Integer	Unique game identifier
name	String	Internal game name
title	String	Display name of the game
description	String	Game description (HTML format)
status	String	Game status (ACTIVE, INACTIVE)
image	String	URL of the game image
type	String	Game type
subType	String	Game subtype
stakeType	String	Defines how the game stake is configured (e.g. chips, predefined stake steps)

Hash Fields

The following fields are included in the hash calculation, in the exact order:

• timestamp

The games field is not included in the hash calculation.

For details on how the hash is generated, see the Hash Algorithm.

Example Response

{
  "timestamp": 1709289932725,
  "hash": "9ed3d547f9a672ecd4884304e859af84263410d613ff2a2bb7d70a8221d7e544",
  "games": [
    {
      "id": 1,
      "name": "Sky Adventure",
      "title": "Sky Adventure",
      "description": "<div>Embark on an exciting journey through the skies. Test your timing and strategy as you progress and collect rewards along the way.</div>",
      "status": "ACTIVE",
      "image": "https://cdn.example.com/images/game_1.jpg",
      "type": "ARCADE",
      "subType": "ARCADE",
      "stakeType": "CHIPS"
    }
  ]
}