Platform Documents · 04 / 04
Predictor is a hosted game: your platform opens one launch URL with a session token, and the game drives your wallet through a small, idempotent callback API. Nothing to install, nothing to host.
01 · Architecture
The game runs full-window or inside your shell via redirect — the launch URL's return and deposit parameters bring the player back to you.
02 · Game launch
Your platform id, the game code and the exact host are assigned during onboarding. The launch call is a plain GET redirect:
| Parameter | Meaning |
|---|---|
| gamecode | Predictor's game identifier, fixed per environment and provided at onboarding. |
| token | Your platform's session token for the player. Predictor exchanges it with your platform API to authorize the session — the token itself is never stored client-side. |
| playerid | Your player id; the same id used in wallet calls and free-spin grants. |
| currency | The player's wallet currency; stakes display converted at the live rate. |
| lang | UI and question language: en, am, ru, tr or es. |
| device | Layout hint; the UI is fully responsive either way. |
| playmode | real for money play; fun for demo. |
| returnUrl / depositUrl | Where the game sends the player on exit, and on an insufficient-balance prompt. |
03 · Wallet callbacks
Predictor calls your wallet with signed server-to-server requests. Every call carries a unique transaction id; retries reuse the same id, so processing is safely idempotent on your side.
| Operation | When | Amount |
|---|---|---|
| Bet | Player joins a round | − stake |
| Win settlement | Round settles with the player on the winning side | + payout (net; rake reported alongside) |
| Loss settlement | Round settles against the player | 0 (closes the round; rake reported) |
| Refund void / rollback | Round voids, or an in-doubt bet is rolled back | + stake |
Timeout handling, the in-doubt ledger and reconciliation guarantees are specified in Financial Logic & Settlement, section 05. Native adapters exist per platform wallet dialect; new wallet APIs are integrated as plugins on Predictor's side — no change required in your casino.
04 · Bonus & localization
| Capability | Summary |
|---|---|
| Free spins | One grant endpoint for your bonus engine; rounds consumed automatically on matching joins; wins pay real money. Full spec: Free Spins. |
| Languages | UI and the full question bank in English, Armenian, Russian, Turkish, Spanish — selected by the lang launch parameter. New locales are added through the translation pipeline without a client release. |
| Currency | Multi-currency with live-rate conversion; bets and settlements always reconcile in the player's wallet currency. |
| Demo mode | playmode=fun launches the full game against a demo balance — useful for your QA and for player onboarding. |
05 · Back office
| Area | What you manage |
|---|---|
| Question bank | 1,000+ questions with per-language text; activate or retire questions; per-answer vote statistics. |
| Game configs | Stake tiers, player limits, round timings, tournament schedules. |
| Free spins | Manual grants and grant inspection, alongside the API. |
| Monitoring | Game history and transaction ledger per player and per round, matching your wallet's transaction ids line by line. |
06 · Onboarding
| Step | What happens |
|---|---|
| 1 · Exchange | We exchange signing keys and assign your platform id, game code and API hosts. |
| 2 · Network | IP allowlists are set up in both directions where your policy requires them. |
| 3 · Wallet | You provide wallet endpoint URLs; we map them to the matching adapter. |
| 4 · Sandbox | Launch, play, settle and reconcile on the staging environment with test players — including free-spin and refund cases. |
| 5 · Go-live | Production keys armed, launch URL flipped to production, first real rounds verified together. |