Skip to content
GPAS Docs

Game Launcher Instructions

This section explains the steps necessary to launch and integrate games correctly in an existing game portal/website.

Implementation Steps

  1. Subdomain Configuration: For each game provider, a special subdomain is necessary that must be provided by the Operator Account System.

  2. URL Construction: The operator’s account system must make a request to our URL of the launcher game configured with the necessary parameters.

  3. Parameter Configuration: Include all required parameters as described in the Parameters section.

  4. Integration Testing: Test the integration in the stage environment before moving to production.

URL Construction Example

https://SubDomainProvider.DomainOperator/Launcher/Game/?authToken=(Hash)&walletId=(walletId)&gameid=(gameid)&device=(device)&username=(username)&playerid=(playerid)&language=(language)&currency=(currency)&isDemo=(isDemo)

Replace the placeholder values with actual values for your implementation.

Game Launch Process

Once all the steps are completed and the URL is accessed:

  1. The game will start to download
  2. Communication with the API will begin
  3. The player’s session will be created
  4. The game will be displayed in the player’s browser

Implementation Considerations

Security

  • Ensure that all communication is over HTTPS
  • Validate the authToken on your server before redirecting the player
  • Implement proper error handling for failed launches

User Experience

  • Consider implementing a loading indicator while the game is downloading
  • Provide clear error messages if the game fails to launch
  • Ensure that the game container is properly sized for the device

Technical Requirements

  • The game container should be an iframe or div element
  • The container should have a minimum width and height as specified by the game provider
  • The page should not have any JavaScript errors that could interfere with the game

Troubleshooting

If you encounter issues with the game launch:

  1. Verify that all required parameters are correctly included in the URL
  2. Check that the subdomain is correctly configured
  3. Ensure that the player has sufficient balance (for real money games)
  4. Check the browser console for any JavaScript errors
  5. Verify that the player’s session is valid