The full iframe

The full iframe is the complete player experience in a single embed: the box page, the open animation, and the player’s winnings. Launch it by minting a session with a boxId to land on a box, or with no box (target: {}) to land in the lobby.

┌─────────────────────────────────────────────┐
│  brand header · balance · language/currency  │
├─────────────────────────────────────────────┤
│  Box page                                     │
│    ┌─────────┐                                │
│    │  box    │   Dragon Box        €5.00      │
│    │  art    │   odds · prize table           │
│    └─────────┘   [ Open · €5.00 ]             │
├─────────────────────────────────────────────┤
│  My items · Orders                            │
└─────────────────────────────────────────────┘

Box page

The heart of the surface. It shows the box art, price (in the session currency), odds, and prize table, with a single call-to-action to open it. Opening debits the player’s wallet for the price and reveals the result with the open animation.

A player reaches a box page by:

• launching directly at it — target: { "boxId": 42 };
• picking it from the lobby; or
• tapping a recommended widget card, after which your page navigates to it.

Pre-bought boxes auto-open

If the box was already paid for — a pre-pay purchase or a launch with target.autoOpen — it starts opening on its own as the page loads (after a short beat for the reveal), with no extra click. Otherwise the player opens it from the single CTA.

Free box? A launch with funding: "operator" and no autoOpen shows the player an “Open your free box” CTA instead of charging them — see Free box in the iframe.

Lobby

Launch with target: {} to land in a browsable catalog of the boxes enabled for your operator, with prices in the session currency. Picking a box goes to its box page. The same data is available via the box catalog API if you’d rather build the browsing experience yourself (Model B) — most operators drive discovery from their own pages plus the recommended widget, and embed the iframe per box.

Winnings

Won prizes land in the player’s inventory (“My items”), where they can be cashed back or shipped (“Orders”). See Inventory & fulfillment.