Skip to main content

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
FieldTypeDescription
modestringrequiredGame mode. Allowed values: real, fun
gamestringrequiredGame identifier
languagestringrequiredBCP 47 language code for the game UI (e.g. en, de, fr)
walletIdstringrequired if mode=realPlatform wallet identifier, provided by NeverEnding
operatorIdstringrequired if mode=realOperator identifier
keystringrequired if mode=realLaunch key. Passed back in /authenticate for session verification
countrystringrequired if mode=realISO 3166-1 alpha-2 country code of the player's jurisdiction (e.g. uk, de)
urlsobjectoptionalObject containing redirect URLs used within the game client
urls.lobbystringoptionalFull URL to redirect the player when they click the lobby/exit button
urls.refreshstringoptionalURL called to refresh the player session token
urls.depositstringoptionalFull URL to redirect the player to the deposit page

Response​

✓ 200 OK
{
"url": "https://game.com/launch?key=launch_key&language=en..."
}
Response Parameters
FieldTypeDescription
urlstringFully 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>