Steps to Integrate

Data Flow:

  1. Operator โ†’ RGS: Generate game token (create game session)

  2. Operator โ†’ RGS: Launch game (using game token)

  3. RGS โ†’ Operator: Get Balance (seamless wallet request)

  4. RGS โ†’ Operator: Bet โ€“ approve, debit & return new balance (seamless wallet request)

  5. RGS โ†’ Operator: Win / Result โ€“ approve, credit & return new balance (seamless wallet request)

*RGS = Remote Gaming Server (where the CasinoWebScripts games source code is deployed).

Getting started:
In order to complete our integration successfully, you will need to complete the following steps:

๐Ÿ”‘1. Request API Credentials

See the Requirements documentation section and make sure you received all the following details:

  • REST API URL (endpoint base)

  • Games Launch API URL

  • API Username

  • API Password

  • API Encryption Key - unique 64 bit key per project

  • Operator ID

๐Ÿ”„ 2. Understand How to Pass Data

Learn how to send JSON payloads to our API endpoints.

See the Passing Data to RGS-CWS API Endpoints documentation section.

๐ŸŽฎ 3. Retrieve List of Available Games

Retrieve the list of games and add the games to your lobby/database
Use the getListGames command (or legacy command: 24) to obtain all available games.

  • Download all game images and host them locally

  • Do not hotlink images from our servers โ€” this will trigger image protection. You must download the game images and host them on your server and do not link directly to the images from our servers.

See the Get List Of Available Games documentation section.

๐ŸŽŸ๏ธ 4. Generate a Game Play Token

Before launching a game, you must generate a unique play_token.

  • Tokens are valid for up to 60 minutes

  • You may reuse them, but always validate the expiry_date to ensure that they did not expire

See the Generate Game Play Token documentation section.

๐Ÿ–ผ๏ธ 5. Launch a Game in iFrame/Tab

Use the generated token to construct a game launch URL.

See the Game Launch documentation section.

๐Ÿ’ต6. Configure Seamless Wallet Endpoints

Set up the Seamless Wallet URL for balance retrieval
Communicate to CWS Support your Seamless Wallet URL for balance retrieval. To that URL you will receive a json string command=getbalance (and other parameters) via HTTP POST.

Set up Seamless Wallet URL for balance adjustments
Communicate to CWS Support your Seamless Wallet URL for balance adjustments. To that URL you will receive a json string commands like bet/win/cancelbet/cancelwin (and other parameters) via HTTP POST.

Find out more about the data passed, inside the Receive Data from our API documentation section.

๐Ÿ”7. Handle Communication Security

Communication security is ensured in both directions:

  • When sending requests to our RGS-CWS server, use your authentication credentials (API Username and API Password) for verification.

  • When receiving data from our RGS-CWS server, verify the hashed_result parameter using your API Encryption Key (HMAC-SHA256) to confirm the authenticity of the request.

Refer to the Security โ€“ Trusting Our Data section for detailed instructions on implementing hash validation and securing your endpoints.

โœ… 8. Run Automated Tests

Once the integration is completed, you can run our automated tests and confirm that you passed them all. After you passed all the tests, please send a screenshot of the tests status (just the part where it says how many tests you passed) to the CWS Support representative.

Automated Test tool can be found here: https://www.cryptoclub.casino/plugins/unit_testing/games_rgs/

โš ๏ธIMPORTANT: Please make sure to open the testing link in incognito mode in your browser or to use a different browser than the one used for playing the games.