Skip to content

19flip integration docs

19flip is a B2B game provider. A casino (in these docs: an operator) integrates once with the 19flip API and gets access to every 19flip game. These pages describe that integration completely: how to launch a game, the wallet callbacks you implement, and the rules that keep money correct. They are written for casino developers and for LLM agents.

How it works

The casino calls 19flip to launch a game for a player and gets back a launch_url to open in the browser. 19flip never holds player money. Whenever a game needs to read a balance or move money, 19flip calls the casino's wallet callbacks: five POST endpoints under the casino's callback_url (/balance, /bet/debit, /win/credit, /bet/rollback, /win/rollback). Every callback is signed with the casino's secret key and carries an idempotency_key that the casino must use to deduplicate.

flowchart LR
    Casino[Casino backend] -- "POST /api/operator/v1/launch-game<br/>Api-Key" --> Provider[19flip API]
    Player[Player browser] -- "opens launch_url" --> Game[19flip game]
    Provider -- "POST {callback_url}/balance, /bet/debit, ...<br/>X-Signature" --> Casino

The diagram in words: the casino backend calls the 19flip API to launch a game; the player's browser opens the returned launch_url; for every balance read and money movement 19flip calls the casino's wallet callbacks.

The 19flip API is https://games.19flip.com (since 2026-10-26). The former address https://19flip.site keeps working: it redirects API calls with 308, which keeps the method, the body and the headers, and pages with 301; switch your configuration to the new address all the same. Your API key, secret key and the settings of your account are issued by the 19flip team.

Read in this order

  1. Quickstart – the whole integration on one page.
  2. Authentication – Api-Key, IP allowlist, key rotation, and how to verify X-Signature on callbacks.
  3. Launch game – POST /api/operator/v1/launch-game.
  4. Wallet callbacks – the five endpoints you implement, with exact JSON.
  5. Idempotency & retries – the rules that keep money correct.
  6. Errors – what we return to you and what you should return to us.
  7. Testing – self-test checklist and the connection test.
  8. Game specifics – what differs between games.
  9. Live banners – optional lobby widget with the current draw.

For LLM agents

Machine-readable indexes are published at the site root: /llms.txt (page list with descriptions) and /llms-full.txt (all pages concatenated). Prefer them over crawling HTML.