Getting started
This site is for operators — the sites/apps that embed games from moose-platform's catalog for players. If you haven't read it yet, Introduction & concepts covers the mental model this whole site assumes.
Prerequisites
- An operator tenant ID and HMAC secret, issued by the platform's admin team out-of-band when your tenant is created. Keep the secret server-side only — it signs every call you make to the platform and verifies every call the platform makes back to you, and must never reach the browser.
- A wallet backend implementing the platform's wallet callback API — the platform calls this to debit/credit players and query balances. Without it,
REALmode has no wallet to settle against (DEMOmode doesn't need it — see Launching games). This is normally the largest piece of work in the integration — see Implementing the wallet callback. - A page to embed the game in — typically an iframe pointed at the
launchUrlyou get back from launching a session.
The end-to-end flow
- Your server launches a session. Sign and call
POST /v1/operator/games/launchwith the player, game, and currency. You get back alaunchUrlandsessionToken. - Embed the game. Load
launchUrlinto an iframe on your page. - Run the shell. Attach a
postMessagelistener against the documented bridge protocol to receive the game's lifecycle events (loaded, bet start/end, balance exhausted, exit) — see Shell bridge. - Settle transactions. As the player bets and wins, the platform calls your wallet callback API in real time to debit/credit their balance in your own system — see Implementing the wallet callback.
From here: Launching games walks through step 1 in full, with a worked signing example.