LootBox Solutions integration
LootBox Solutions is the backend platform that powers mystery-box gameplay — box configuration, the play engine, provable fairness, inventory, and fulfillment. This site is the integration guide for a brand (an operator / casino) embedding LootBox Solutions boxes into your product.
The integration is iframe-first and wallet-authoritative: you embed our player surface in your site, and LootBox Solutions calls your wallet for every money movement. LootBox Solutions holds no balance and no PII — your backend stays the source of truth for both.
Start here
- Overview & architecture — the moving parts and how they fit together.
- Integration models — embed our full iframe, or build your own surfaces on our APIs.
- Quickstart — from zero to a rendered box.
What you’ll build
- Provision your brand — API keys, allowed origins, wallet + webhook URLs, enabled games, branding. See Setup & provisioning.
- Implement your wallet RPC — the
debit/credit/balanceendpoint LootBox Solutions calls. This is your largest piece of work. See Operator configuration and the Player API. - Mint launch tokens and embed the player iframe — or call the Server-to-server API directly to drive purchases from your backend.
Core operations
| You want to… | Where it lives |
|---|---|
| Authenticate a player | Mint a launch token |
| Purchase (open a box) | Purchase |
| Cashout (cash back a won item) | Cashout |
| Cancel (refund an unopened box) | Cancel |
| History (transactions) | History |
Conventions. All money is in minor units (integer cents). All timestamps are ISO 8601 UTC. The operator base URL is
https://{operator}.app.lootboxsolutions.comthroughout — substitute your assigned subdomain.