Custom integration

API integration is for teams maintaining their own player accounts, balances and game entry. Public APIs connect your server to game services; never give secrets or API tokens to player browsers.

1. Apply for access

Follow Apps and access applications. Create an API app, submit your server outbound IP and full callback URL, and obtain the approved app's endpoint, code and secret.

2. Authenticate from your server

Follow Authentication to sign create_token requests, validate and cache the token. All public API requests are restricted by the server IP allowlist.

3. Query games and launch

Use Game APIs to query the catalog and request launch_url with a returned game_code. Keep required session information on your server. Give the browser only the complete launch URL; do not construct or modify it.

4. Implement unified callbacks

Provide a full HTTP(S) callback URL. Follow Callbacks and settlement to verify signatures, dispatch by event and handle duplicate delivery. Implement callbacks before testing game settlement.

For iframe launches, Browser integration is optional. Closing a window and completing wallet settlement are different states.

5. Verify integration before launch

Use dedicated test players to verify authentication, catalog, launch, callbacks, settlement and exit, including duplicate delivery and retries. Complete verification before opening access to players.