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
{
"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 |
| walletId | string | required | Platform wallet identifier, provided by NeverEnding |
| operatorId | string | required | Your operator identifier |
| game | string | required | Game slug / identifier |
| key | string | required | Launch key generated by the operator. Passed back in /authenticate for session verification |
| country | string | required | ISO 3166-1 alpha-2 country code of the player's jurisdiction (e.g. uk, de) |
| language | string | required | BCP 47 language code for the game UI (e.g. en, de, fr) |
| urls | object | required | Object containing redirect URLs used within the game client |
| urls.lobby | string | required | Full URL to redirect the player when they click the lobby/exit button |
| urls.refresh | string | required | URL called to refresh the player session token |
| urls.deposit | string | required | 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>