Generate Launch URL

Generate a launch URL for a player's game session.

⚠️ This endpoint is available only for whitelisted IP addresses.

---

POST /generate-launch-url

POST{provider endpoint}/generate-launch-url

Generate a game launch URL for a specific player session. Use the returned URL to embed the game in an iframe or redirect the player directly.

Request

Headers: X-Server-Authorization: hmac_sha256_hash

{
  "mode": "real",
  "walletId": "777casino-platform",
  "operatorId": "777casino-uk",
  "game": "firefruit-sevens-classic",
  "key": "launch_key",
  "country": "uk",
  "language": "en",
  "urls": {
    "lobby": "https://operator.com/lobby",
    "refresh": "https://operator.com/refresh",
    "deposit": "https://operator.com/deposit"
  }
}

Request Parameters

Field	Type		Description
mode	string	required	Game mode. Allowed values: real, fun
game	string	required	Game identifier
language	string	required	BCP 47 language code for the game UI (e.g. en, de, fr)
walletId	string	required if mode=real	Platform wallet identifier, provided by NeverEnding
operatorId	string	required if mode=real	Operator identifier
key	string	required if mode=real	Launch key. Passed back in /authenticate for session verification
country	string	required if mode=real	ISO 3166-1 alpha-2 country code of the player's jurisdiction (e.g. uk, de)
urls	object	optional	Object containing redirect URLs used within the game client
urls.lobby	string	optional	Full URL to redirect the player when they click the lobby/exit button
urls.refresh	string	optional	URL called to refresh the player session token
urls.deposit	string	optional	Full URL to redirect the player to the deposit page

Response

✓ 200 OK

{
  "url": "https://game.com/launch?key=launch_key&language=en..."
}

Response Parameters

Field	Type	Description
url	string	Fully constructed game launch URL. Use as the src of an iframe or redirect the player directly to this address

Embedding the Game

Use the returned url to embed the game in an iframe:

<iframe src="https://game.com/launch?key=launch_key&language=en..."></iframe>