Maktub Documentation
Welcome to the Maktub integration docs. Maktub is an original games provider — we build provably fair casino games and make them easy to embed in any platform.
How Integration Works
The recommended way to integrate Maktub games is via iframe. Your backend creates a session, and your frontend pastes one placeholder plus our drop-in script — no npm packages, no framework dependencies, no CSS imports, no JavaScript to write. It works with any tech stack.
Your Backend → POST /session → gets a token
Your Frontend → <div data-maktub-game="dice" data-token="…">
<script src="https://play.maktub.bet/embed.js"> → done
Your Backend → webhook endpoint → handles balance/bets/winsThe script builds the iframe and keeps its height glued to the game — the game grows the iframe as the player switches modes, so it never clips or scrolls. Prefer a bare iframe (strict CSP, or your own bundle)? That’s a few lines too — see Getting Started. This is the same model used by every major iGaming aggregator, and takes about 5 minutes to get running.
What You’ll Need
- A
clientIdand webhook secret — provided by Maktub during onboarding; your backend uses both to create sessions - A webhook endpoint — to handle balance checks, bets, and wins
- An iframe — to display the game in your frontend
That’s it. No SDK to install, no React dependency, no CSS to manage.
Available Games
Maktub offers 30+ original games across multiple categories:
- Instant games — Dice, Limbo, Coin Flip, Wheel, Roulette, Keno, Plinko, Diamonds, Baccarat, Double, Drop, Volt, Spark, Safe, Pulse, Launch, Defuse, Wire
- Multi-round games — Mines, Hi-Lo, Tower, Chicken, Blackjack, Video Poker, Balloon, Soccer, Doors, Stairs, Bridge, Phoenix
- Multiplayer — Crash, Slide
- Trading — Crypto Futures — leveraged long/short trading with a live candlestick chart and position management
All games are provably fair, fully themed, and support multiple languages and currencies.
Documentation Overview
- Getting Started — 3-step iframe integration guide
- API Reference — Session, webhooks, postMessage, and props
- Advanced: Direct SDK — For teams that want to embed React or Vanilla JS components directly (not recommended for most use cases)
- Provably Fair — How our RNG and verification system works
- Futures Trading — Crypto futures trading game SDK