Game specifics¶

The integration contract is the same for every game, but games use it differently: which modes they support, which callbacks they send and when, and what arrives after the player has left. Read this before enabling a game for your players.

Summary¶

	Block Boost	Mister Twister	Bingo Bongo	Magic Jump	Flip Jet	Ну, подними!	Book of Dawn	Dacha Dogs	Dacha Fishing	Dacha Pickles
`game_id`	`block-boost`	`mister-twister`	`bingo-bongo`	`magic-double`	`flip-jet`	`egg-rush`	`book-of-dawn`	`dacha-dogs`	`dacha-fishing`	`dacha-pickles`
Type	Single player, skill + luck	Single player	Multiplayer bingo with a shared prize pool, jackpot and live host	Single player, instant: one bet = one round, pure chance	Multiplayer crash game: one shared round for all players, up to 2 bets per player per round	Single player crash game: the player starts their own round, optional Boost Start at ×2 / ×5	Single player slot 5×3, 10 lines: one spin = one round, the whole free-spins bonus included; optional ante and bonus buy	Single player slot 5×4, 40 lines: one spin = one round, the whole «Грядки» free-spins bonus included; optional bonus buy	Single player slot 5×3, 10 lines: one spin = one round, the whole «Садок» free-spins bonus included; optional bonus buy	Single player slot 5×4, 40 lines with Hold & Win: one spin = one round, the whole «Закатка» bonus included; per-bet jars kept between sessions; optional bonus buy
`DEMO` mode	Yes	Yes	No – `launch-game` fails with `502 EXTERNAL_SERVICE_ERROR`	Yes	Yes	Yes	Yes	Yes	Yes	Yes
`rtp`	Whole number; currently `97`, `98` or `99`	Whole number; currently `97`	Not used (ignored)	Whole number `95`, `96`, `97` (default) or `98`	Only `97` (default); any other value fails the launch	Only `97` (default); any other value fails the launch	Only `97` (default); any other value fails the launch	Only `97` (default); any other value fails the launch	Only `97` (default); any other value fails the launch	Only `97` (default); any other value fails the launch
Bet amounts	Bet ladder from your limits	Bet ladder from your limits	Card price set per (your account, currency) by 19flip; ladder ignored	Bet ladder from your limits (required)	Any amount between the smallest and largest step of your ladder (required)	Bet ladder from your limits (required)	Bet ladder from your limits (required)	Bet ladder from your limits (required)	Bet ladder from your limits (required)	Bet ladder from your limits (required)
Max win limit	Not applied (the game caps a round at its own maximum multiplier)	Not applied (same)	Not applied	Applied: multipliers with `bet × multiplier > max_win` are refused	Applied: the bet is cashed out automatically when its win reaches `max_win`	Applied: the round is cashed out automatically when its win reaches `max_win`	Applied: a round is cut at `max_win` (and at 5000 × bet)	Applied: a round is cut at `max_win` (and at 5000 × bet)	Applied: a round is cut at `max_win` (and at 5000 × bet)	Applied: a round is cut at `max_win` (and at 10 000 × bet)
`lang`	Used in `launch_url`	Ignored	Used in `launch_url` (≤ 8 characters)	Used in `launch_url`	Used in `launch_url`	Used in `launch_url`	Used in `launch_url`	Used in `launch_url`	Used in `launch_url`	Used in `launch_url`
Launch token	Valid 24 h	Valid 24 h	Single-use, valid 5 minutes	Valid 24 h	Valid 24 h	Valid 24 h	Valid 24 h	Valid 24 h	Valid 24 h	Valid 24 h
Callbacks used	`/balance`, `/bet/debit`, `/win/credit`, `/bet/rollback`, `/win/rollback`	same as Block Boost	`/balance`, `/bet/debit`, `/win/credit`, `/bet/rollback` (never `/win/rollback`)	`/balance`, `/bet/debit`, `/win/credit`, `/bet/rollback` (never `/win/rollback`)	`/balance` (when the game opens, then about every 5 s while the game tab is visible), `/bet/debit`, `/win/credit`, `/bet/rollback` (never `/win/rollback`)	`/balance`, `/bet/debit`, `/win/credit`, `/bet/rollback` (never `/win/rollback`)	`/balance`, `/bet/debit`, `/win/credit`, `/bet/rollback` (never `/win/rollback`)	`/balance`, `/bet/debit`, `/win/credit`, `/bet/rollback` (never `/win/rollback`)	`/balance`, `/bet/debit`, `/win/credit`, `/bet/rollback` (never `/win/rollback`)	`/balance`, `/bet/debit`, `/win/credit`, `/bet/rollback` (never `/win/rollback`)
`game_id` in callbacks	`null`	`null`	`"bingo-bongo"`	`"magic-double"` (rollbacks carry no `game_id`)	`"flip-jet"` (rollbacks carry no `game_id`)	`"egg-rush"` (rollbacks carry no `game_id`)	`"book-of-dawn"` (rollbacks carry no `game_id`)	`"dacha-dogs"` (rollbacks carry no `game_id`)	`"dacha-fishing"` (rollbacks carry no `game_id`)	`"dacha-pickles"` (rollbacks carry no `game_id`)
`idempotency_key` format	64-char lowercase hex	64-char lowercase hex	`bb-<purpose>-<n>-<round>-<n>`	64-char lowercase hex	`flipjet:<n>:DEBIT`, `flipjet:<n>:CREDIT`, `flipjet:<n>:ROLLBACK`	64-char lowercase hex	64-char lowercase hex	64-char lowercase hex	64-char lowercase hex	64-char lowercase hex
Wins after the player left	No	No	Yes, routinely	Only when a credit failed and is retried (see below)	Yes: auto cashouts are paid even if the player closed the game	Yes: auto cashouts are paid even if the player closed the game	Only when a credit failed and is retried	Only when a credit failed and is retried	Only when a credit failed and is retried	Only when a credit failed and is retried

Keys sent by 19flip staff when resolving an operation manually look like manual-rb-<number> in any game.

Block Boost¶

Launch¶

mode LIVE or DEMO. For DEMO, send demo_balance; without it the demo starts at 0 and the player cannot bet. DEMO sessions make no wallet callbacks.
rtp must be a whole number accepted by the game (currently 97, 98 or 99). A value such as 96.5 makes the launch fail with 502.
The launch URL is …?token=<token>&lang=<lang>; the token is valid for 24 hours.

Money flow (LIVE)¶

The player chooses a bet from the ladder and starts a round. No money moves yet.
Every paid action in the round (requesting a new set of shapes) is one /bet/debit of the round's bet amount. The game calls /balance right before each debit to check affordability. One round therefore has one or more debits, all with the same round_id.
The round ends either when the player takes the reward or when the board locks (no shape of the current set fits). In both cases the game calls /balance and then one /win/credit with the round's total winnings, if they are greater than 0; a round with zero winnings ends without a credit.
Rollbacks happen only if the game fails internally right after your successful debit or credit. It then sends /bet/rollback or /win/rollback with your transaction_id as original_transaction_id and a reason such as Rollback due to error after bet_debit: ….

game_id and transaction_id are null in its debits and credits.

Mister Twister¶

Mister Twister uses the same launch and money flow as Block Boost (several debits per round, one credit at the end, rollbacks only after an internal failure, game_id null, 64-character hex keys). Differences:

rtp: currently only 97.
lang is not added to the launch URL (…?token=<token>).

Magic Jump¶

Changed in 2.21.0

Magic Double is renamed to Magic Jump. Only the display name changed: the game_id stays magic-double, nothing changes in your integration.

Changed in 2.17.0

The game is live in production (2026-10-08). It is switched on per casino by 19flip: ask your account manager if it is not in your catalogue yet.

Launch¶

mode LIVE or DEMO. For DEMO, demo_balance sets the starting balance; without it the demo starts at 1000. DEMO sessions make no wallet callbacks.
rtp must be a whole number accepted by the game: 95, 96, 97 or 98 (default 97). The game returns the same RTP for every multiplier, so the player's choice changes only the variance.
A bet ladder for the currency is required: without one the launch fails.
max_win from your limits is applied per round: the player cannot pick a multiplier whose bet × multiplier exceeds it. The largest possible win is 100 × bet.
The launch URL is …?token=<token>&lang=<lang>; the token is valid for 24 hours. The game is translated into ru and en; any other lang shows English.

Money flow (LIVE)¶

The player picks a bet from the ladder and a multiplier (x1 … x100) and plays. The debit is sent when the player presses STOP, not when the frame starts. Each round is exactly one /bet/debit of the bet amount, with its own round_id. A debit you decline (402 or another 4xx) ends the round with no further calls.
After your successful debit the game draws the outcome. On a win it sends one /win/credit of bet × multiplier with the same round_id; a lost round has no credit.
If your debit times out or returns 5xx, the game repeats it once with the same idempotency_key. If the outcome is still unknown, it sends /bet/rollback for that round with the debit's idempotency_key as original_transaction_id (19flip resolves it to your transaction) and reason Debit outcome unknown: …. The rollback is retried with the same key until it gets a definite answer, never sooner than a minute after the previous attempt, so a rollback can arrive a few minutes after the debit. Apply it whenever you have applied the debit, even if the debit reached you late.
If your credit fails, the game does not roll anything back: it repeats /win/credit with the same idempotency_key until it succeeds (at the next player action or in the background, never sooner than a minute after the previous attempt). Credits can therefore arrive after the player has left.

game_id is "magic-double" in debits and credits; transaction_id is null.

Flip Jet¶

Added in 2.26.0

The game is live in production (2026-10-11). It is switched on per casino by 19flip: ask your account manager if it is not in your catalogue yet.

Flip Jet is a crash game. All players play the same round: bets are accepted during an 8-second countdown, then the plane takes off and the multiplier grows from 1.00x until the plane flies away at a random moment. A bet that is cashed out before that pays bet × multiplier. A bet that is not cashed out is lost. The crash point of every round is fixed before bets open and can be verified by the player after the round (provably fair). The RTP is 97 % for any cashout strategy.

Launch¶

mode LIVE or DEMO. For DEMO, demo_balance sets the starting balance; without it the demo starts at 1000. DEMO sessions make no wallet callbacks, and other players do not see demo bets.
rtp must be 97 or omitted. Any other value fails the launch. All casinos play in the same room, so every player of the room shares one RTP.
A bet ladder for the currency is required: without one the launch fails. The player can bet any amount (to 0.01) between the smallest and the largest step of the ladder. The ladder steps are only quick-pick amounts in the game.
max_win from your limits is applied per bet. When bet × multiplier reaches max_win, the game cashes the bet out automatically at that point. A bet whose win would exceed max_win even at 1.01x is refused. Without max_win, the largest win is 10 000 × bet.
The launch URL is …?token=<token>&lang=<lang>; the token is valid for 24 hours. The game is translated into ru and en.

Shared round and what players see¶

One room for everyone. Players of all casinos and all currencies play the same rounds. The "All bets" list shows other players' bets in their own currency, under a masked nickname: the first two and last two characters of your player_id (an***73). Never use e-mails, phone numbers or other personal data as player_id.
Totals and the daily top are counted only in the viewer's currency.
Visual players (optional, off by default). On request 19flip can turn on, for your casino only, a range of simulated players (for example 15–20). They add to the "playing" counter, and 40–80 % of them bet in each round: amounts from your ladder in the player's currency, some cash out before the crash, the rest lose. They never call your wallet, are not in reports or the daily top, and players of other casinos do not see them. A change applies when the player next opens the game.
A player can have up to two bets in one round, each with its own optional auto cashout.

Money flow (LIVE)¶

Every bet is its own round in the callbacks: a separate round_id per bet, so the two bets of one player in the same game round never share a round_id. The shared game round is in game_round_id, which every debit, credit and bet rollback carries (since 2.34.0).

Bet. When the player places a bet during the countdown, the game sends one /bet/debit of the bet amount. If your debit times out or returns 5xx, the game repeats it once with the same idempotency_key. If the outcome is still unknown, the bet is refused and the game sends /bet/rollback with reason EXTERNAL_SERVICE_ERROR.
Cancel. A bet can be cancelled until takeoff: /bet/rollback of the full amount, reason CANCELLED.
Late debit. If your debit is confirmed only after takeoff, the bet does not take part in the round and is refunded: /bet/rollback, reason LATE_DEBIT. Answer debits quickly. A debit that takes more than a few seconds near the end of the countdown misses the round.
Win. On a cashout (manual, auto, max_win or the 10 000x cap) the game sends one /win/credit of bet × multiplier, rounded down to the currency's precision, with the bet's round_id and the cash-out multiplier (e.g. "2.35"). If your credit fails, the game repeats it with the same idempotency_key until it succeeds, about every 30 seconds. A win is never rolled back. Credits can arrive after the player has left: auto cashouts happen on the server.
Loss. No money callback. The round keeps only its debit; the loss is reported in /round/finish (result lost).
Interrupted round. If a round is interrupted by a failure on our side, every bet still in flight is refunded: /bet/rollback, reason ROUND_VOIDED. Bets already cashed out stay won and are paid.
Round end. Right after the crash, one /round/finish per round in which your players had LIVE bets: game_round_id, crash_point, started_at, finished_at and each of your bets with result won / lost / refunded. An interrupted round comes with status interrupted and crash_point null. Missed callbacks can be fetched from the round history.

While a LIVE game is open in a visible tab, Flip Jet re-reads the balance with /balance about every 5 seconds and right after the player returns to the tab, so a deposit made while the game is open shows up without restarting it. Expect this steady /balance traffic per open game.

original_transaction_id in a rollback is the debit's idempotency_key (flipjet:<n>:DEBIT). 19flip resolves it to your transaction. Rollbacks are retried with the same key until they get a definite answer. Apply a rollback whenever you have applied the debit, even if the debit reached you late.

game_id is "flip-jet" in debits and credits; transaction_id is null. Debits, credits and bet rollbacks end with game_round_id; credits also with multiplier.

Crash point and round-based promotions¶

The crash point of a round is never sent before the round ends. After it ends it is in /round/finish and in the round history, and the player sees it in the game. To run a promotion on the crash point (for example a jackpot when a round crashes above 19.19x), take the round from /round/finish and the qualifying bets from its bets, or match your /bet/debit callbacks by game_round_id.

Golden Flight (bonus buy)¶

Added in 2.73.0

The wallet and round-history contract is in place. The feature is not yet live: the in-game art is being finalised and it has not been released to production. It is off for every casino and is switched on only on your request.

Golden Flight lets a player buy a personal flight for 20×, 50× or 100× the bet, on one of three routes. The flight never crashes: its landing multiplier is decided and paid at the moment of purchase. On the way the shuttle catches bonuses and bombs that move the count up and down, starting from the guaranteed minimum; they only show the path to the landing decided at purchase. There is no cash-out button. The RTP is 97 % for every route and price, and the odds table is shown to the player before the purchase.

Route	Character	Guaranteed minimum at 20× / 50× / 100×	Largest landing
Northern Lights	calm: high minimum	9.75x / 24.55x / 49.73x	1 000 × bet
Solar Wind	like a crash round without the crash	2.04x / 5.73x / 12.64x	10 000 × bet
Event Horizon	extreme	1.61x / 4.39x / 9.44x	100 000 × bet

The landing is in multiples of the base bet, and since 2.86.0 the game says so everywhere: the purchase window shows the range in money and the formula «payout = bet × result», and the result card leads with the payout and whether it covered the price. The show lasts 20 s; the money is debited and credited at purchase, before it starts. Most purchases return less than the price: only about 24 % (Northern Lights), 10–13 % (Solar Wind) and 8–9 % (Event Horizon) land at or above it.

Money flow. One purchase is one round in the callbacks, with its own round_id. It never shares a round_id with a bet.

/bet/debit of the price (base bet × 20|50|100), with round_type "golden_flight".
Right away, /win/credit of base bet × landing, with multiplier = landing and round_type "golden_flight". The credit is always sent: a purchase always wins something, at least the minimum. If your credit fails, it is retried with the same idempotency_key until it succeeds.
If the debit outcome is unknown, /bet/rollback, reason EXTERNAL_SERVICE_ERROR, as for bets.
One /round/finish with type "golden_flight", route, price_mult and a single won bet. crash_point is the landing.

game_round_id of a purchase is unique and never equals that of a shared round.

Limits. Your min_bet / max_bet apply to the base bet, not to the price: a purchase at 100× may debit up to 100 × max_bet. max_win is respected: when the largest possible landing would exceed max_win, the game lowers that purchase's cap and raises its guaranteed minimum, so the RTP stays 97 %. A price is not offered when max_win / bet is below 2.5× the price.

Exposure. A single Event Horizon purchase can pay up to 100 000 × the base bet (10× the regular Flip Jet cap), capped by your max_win. Set max_win with this in mind before you ask to switch the feature on.

Regulation. Bonus buy is banned or restricted in a number of jurisdictions, at least the UK (UKGC) and Germany (GlüStV 2021); check yours. The feature is off by default and is switched on per casino under your licence. An optional pause between purchases (in seconds) can be set as well. Every purchase needs an explicit confirmation from the player; there is no auto-buy and no repeat-in-one-tap.

Bonus wagering¶

The smallest auto cashout is 1.01x: such a bet wins about 96 % of the time and loses 3 % of the stake on average, with almost no variance. If your bonus terms count Flip Jet bets toward wagering, consider excluding the game or counting it at a reduced rate.

Manual cashout and network delay¶

A manual cashout counts at the moment the request reaches the game server, not when the player taps. On a slow connection the player can see a multiplier below the crash and still lose. Auto cashout does not depend on the connection. The game's rules tell the player this.

Ну, подними!¶

Added in 2.38.0

«Ну, подними!» (egg-rush) is switched on per casino by 19flip: ask your account manager if it is not in your catalogue yet.

«Ну, подними!» is a single-player crash game styled as a Soviet LCD handheld: the player presses START, the multiplier grows from ×1.00 and the player cashes out before an egg breaks. Every player has their own round, so there is no shared round, countdown or bet feed. The RTP is 97 % for any cash-out strategy.

Launch¶

mode LIVE or DEMO. For DEMO, demo_balance sets the starting balance; without it the demo starts at 1000. DEMO sessions make no wallet callbacks.
rtp must be 97 or omitted. Any other value fails the launch.
A bet ladder for the currency is required: without one the launch fails. The player bets one of the ladder steps.
max_win from your limits is applied per round. When bet × multiplier reaches max_win, the game cashes the round out automatically at that point. A bet that would exceed max_win even at ×1.01 is refused. Without max_win, the largest win is 1000 × bet (the ×1000 cap).
The launch URL is …?token=<token>&lang=<lang>; the token is valid for 24 hours. The game is translated into ru and en; any other lang shows English.

Boost Start¶

The player can pay more to start the round at ×2 or ×5 instead of ×1.00. A boosted round is guaranteed to reach its starting level; after that it behaves like any other round.

Price. bet × level / 0.97, rounded up to the cent: ×2 costs 2.0619 × bet (bet 10 → 20.62), ×5 costs 5.1546 × bet (bet 10 → 51.55). The win is still bet × multiplier: the bet, not the price, is multiplied.
Limited by your ladder. The debit of a boosted round is the price, and 19flip checks every debit against your max_bet. So a boost is offered only while its price does not exceed the largest step of your ladder. With a ladder up to 100, ×2 is offered for bets up to 48.50 and ×5 for bets up to 19.40; for higher ladder steps the boost cards are disabled in the game.
With max_win, a boost is refused when bet × level already reaches max_win.
Boost is not available in auto play.

Money flow (LIVE)¶

Every round has its own round_id. There is no game_round_id and no /round/finish for this game.

Start. When the player presses START (or BOOST START), the game sends one /bet/debit of the bet, or of the boost price for a boosted round. A debit you decline (402 or another 4xx) ends the round with no further calls. If your debit times out or returns 5xx, the game repeats it once with the same idempotency_key. If the outcome is still unknown, it sends /bet/rollback with the debit's idempotency_key as original_transaction_id and reason Debit outcome unknown: …. The rollback is retried with the same key until it gets a definite answer, never sooner than a minute after the previous attempt.
Win. On a cashout (manual, auto, max_win or the ×1000 cap) the game sends one /win/credit of bet × multiplier, rounded down to the cent, with the cash-out multiplier (e.g. "3.47"). If your credit fails, the game repeats it with the same idempotency_key until it succeeds, never sooner than a minute after the previous attempt. A win is never rolled back. Credits can arrive after the player has left: auto cashouts happen on the server.
Loss. No money callback. The round keeps only its debit.
Interrupted round. If the game service restarts while a round is in flight, the round is cancelled and the full debited amount is returned: /bet/rollback, reason server_restart. A round whose auto cashout, cap or max_win would have come before the crash is paid instead.

/balance is called when the game opens, after a declined debit or an interrupted round, and while a payout is being retried; the game does not poll it.

game_id is "egg-rush" in debits and credits; transaction_id is null. Rollbacks carry no game_id.

Bonus wagering¶

A boosted round cashed out right after the start wins in about 99 % of cases and returns about 97 % of the boost price, with almost no variance. The smallest manual or auto cashout of a normal round (×1.01) behaves the same way. If your bonus terms count «Ну, подними!» bets toward wagering, consider excluding the game or counting it at a reduced rate.

Manual cashout and network delay¶

A manual cashout counts at the moment the request reaches the game server, not when the player taps. On a slow connection the player can see a multiplier below the crash and still lose. Auto cashout does not depend on the connection. The game's rules tell the player this.

Book of Dawn¶

Added in 2.50.0

«Book of Dawn» (book-of-dawn) is not in production yet. 19flip will switch it on per casino: ask your account manager.

«Book of Dawn» is a classic "book" slot: 5 reels × 3 rows, 10 fixed lines, the book is both wild and scatter. Three or more books give 10 free spins with an expanding symbol; free spins can be retriggered. The RTP is 97 %, and 96.99 % with the ante.

One spin is one round. The game plays out the whole round, including every free spin, when the player presses spin or buys the bonus. The round therefore has one debit and at most one credit, however long the bonus animation takes on screen. A reload in the middle of free spins moves no money: the win is already credited, and the game only replays the animation.

Launch¶

mode LIVE or DEMO. For DEMO, demo_balance sets the starting balance; without it the demo starts at 1000. DEMO sessions make no wallet callbacks.
rtp must be 97 or omitted. Any other value fails the launch with 400 REQUEST_ERROR «RTP … is not allowed for this game».
A bet ladder for the currency is required: without one the launch fails. The player bets one of the ladder steps.
max_win from your limits is applied per round (see Max win).
The launch URL is …?token=<token>&lang=<lang>; the token is valid for 24 hours. The game is translated into ru and en; Russian is shown for ru and other CIS languages, English otherwise.

Ante and bonus buy¶

Both change only the price of the round, that is, the debit amount. The bet that the paytable multiplies stays the same.

Option	Price	Return	Available when
Ante «Двойная книга» (books land more often)	`1.25 × bet`	96.99 %	`1.25 × bet` is a whole number of minor units and does not exceed `max_bet`
Buy «Книга» (bonus with 1 expanding symbol)	`64 × bet`	about 97.2 %	the price does not exceed `max_bet`
Buy «Золотая страница» (bonus with 2 expanding symbols)	`108 × bet`	about 97.0 %	the price does not exceed `max_bet`

Limited by max_bet. 19flip checks every debit against your max_bet, so the game offers an option only while its price is within it. With max_bet 100, «Книга» is available up to a bet of 1.56 and «Золотая страница» up to 0.92. Unavailable options are disabled in the game.
Ante on uneven bets. With 2 decimals the ante is unavailable on bets not divisible by 0.04, for example 0.10, 0.30 or 0.50. Ladders made of multiples of four minor units avoid this.
A bonus buy returns less than its price about two times out of three: the average comes from rare large bonuses. The rules show this to the player.
Bonus buy can be switched off only for all casinos at once. If bonus buy is not allowed in your market, tell your account manager before enabling the game.

«Карты Босса»¶

After any paid spin (not a bonus buy) there is a 1 in 1320 chance of a «Карты Босса» round: the player opens cards until three of one suit, which gives a fixed prize of 10×, 25×, 100× or 1000× the bet. These are not progressive jackpots: there is no shared pool and nothing is collected from bets. The prize is part of the same round, so it is included in that round's single credit and in the 97 %.

Max win¶

A round wins at most 5000 × bet, and at most max_win if you set one. Reaching the cap ends the round at once, free spins included, and the credit is exactly the cap. Big rounds are rare but carry a real share of the RTP, so a max_win below 5000 × max_bet lowers the RTP on high bets. We recommend max_win ≥ 5000 × max_bet.

Money flow (LIVE)¶

Every round has its own round_id. There is no game_round_id and no /round/finish for this game.

Debit. On spin or bonus buy the game sends one /bet/debit of the round price: the bet, 1.25 × bet with ante, or the buy price. A debit you decline (402 or another 4xx) ends the round with no further calls. If your debit times out or returns 5xx, the game repeats it once with the same idempotency_key. If the outcome is still unknown, it sends /bet/rollback with the debit's idempotency_key as original_transaction_id, and retries the rollback with the same key until it gets a definite answer, never sooner than a minute after the previous attempt.
Win. If the round won anything (base spin, free spins and «Карты Босса» together), the game sends one /win/credit of the whole win with multiplier = win / bet (e.g. "57.30"). If your credit fails, the game repeats it with the same idempotency_key until it succeeds, never sooner than a minute after the previous attempt. A win is never rolled back.
Loss. No money callback. The round keeps only its debit.

The credit is at most 5000 × the debit. Because the price of a bonus buy is 64× or 108× the bet, its credit is at most about 78× or 46× its debit.

/balance is called when the game opens and when the player's balance has to be re-read (after a reconnect or while a payout is being retried); the game does not poll it.

game_id is "book-of-dawn" in debits and credits; transaction_id is null. Rollbacks carry no game_id.

Bonus wagering¶

Bonus buy turns a large stake into one high-variance round with about 97 % return. If your bonus terms count «Book of Dawn» bets toward wagering, consider excluding bonus buys or counting them at a reduced rate.

Dacha Dogs¶

Added in 2.65.0

«Dacha Dogs» (dacha-dogs) is not available to casinos yet. 19flip will switch it on per casino: ask your account manager.

«Dacha Dogs» is a slot with 5 reels × 4 rows and 40 fixed lines. Paw symbols are wilds with a multiplier (×2, ×3, ×5 or ×10). Three dog houses give 10 free spins of the «Грядки» bonus, where paw multipliers add up under their reels until the bonus ends; free spins can be retriggered (+5). The RTP is 97 %.

One spin is one round. The game plays out the whole round, including every free spin, when the player presses spin or buys the bonus. The round therefore has one debit and at most one credit, however long the bonus animation takes on screen. A reload in the middle of free spins moves no money: the win is already credited, and the game only replays the animation.

Launch¶

mode LIVE or DEMO. For DEMO, demo_balance sets the starting balance; without it the demo starts at 1000. DEMO sessions make no wallet callbacks.
rtp must be 97 or omitted. Any other value fails the launch with 400 REQUEST_ERROR «RTP … is not allowed for this game».
A bet ladder for the currency is required: without one the launch fails. The player bets one of the ladder steps; the line bet is the bet / 40.
max_win from your limits is applied per round (see Max win).
The launch URL is …?token=<token>&lang=<lang>; the token is valid for 24 hours. The game is translated into Russian (ru), Ukrainian (uk or ua) and English (any other lang).

Bonus buy¶

The bonus buy costs 100 × bet and starts the «Грядки» bonus at once; its return is 97.01 %. Like any debit, its price is checked against your max_bet, so the game offers the buy only while 100 × bet ≤ max_bet: with max_bet 100, up to a bet of 1.00. Otherwise the buy is disabled in the game. A bonus buy returns less than its price in most cases: the average comes from rare large bonuses, and the rules show this to the player. Bonus buy can be switched off only for all casinos at once; if it is not allowed in your market, tell your account manager before enabling the game.

Small bets¶

Wins are rounded down to the minor unit once per round (the line bet is the bet / 40). On the smallest bets this costs a little RTP: about −0.7 percentage points at 0.10, −0.3 at 0.30, −0.14 at 0.50, at most −0.06 from 1.00. Bets that are multiples of 0.40 lose nothing.

Max win¶

A round wins at most 5000 × bet, and at most max_win if you set one. Reaching the cap ends the round at once, free spins included, and the credit is exactly the cap. We recommend max_win ≥ 5000 × max_bet: a lower limit lowers the RTP on high bets.

Money flow (LIVE)¶

Every round has its own round_id. There is no game_round_id and no /round/finish for this game.

Debit. On spin or bonus buy the game sends one /bet/debit of the round price: the bet or 100 × bet. A debit you decline (402 or another 4xx) ends the round with no further calls. If your debit times out or returns 5xx, the game repeats it once with the same idempotency_key. If the outcome is still unknown, it sends /bet/rollback with the debit's idempotency_key as original_transaction_id, and retries the rollback with the same key until it gets a definite answer, never sooner than a minute after the previous attempt.
Win. If the round won anything (base spin and free spins together), the game sends one /win/credit of the whole win with multiplier = win / bet (e.g. "57.30"). If your credit fails, the game repeats it with the same idempotency_key until it succeeds, never sooner than a minute after the previous attempt. A win is never rolled back.
Loss. No money callback. The round keeps only its debit.

The credit is at most 5000 × the debit; for a bonus buy (price 100 × bet) that is at most 50× its debit.

/balance is called when the game opens and when the player's balance has to be re-read (after a reconnect or while a payout is being retried); the game does not poll it.

game_id is "dacha-dogs" in debits and credits; transaction_id is null. Rollbacks carry no game_id.

Bonus wagering¶

Bonus buy turns a large stake into one high-variance round with about 97 % return. If your bonus terms count «Dacha Dogs» bets toward wagering, consider excluding bonus buys or counting them at a reduced rate.

Dacha Fishing¶

Added in 2.76.0

«Dacha Fishing» (dacha-fishing) is not available to casinos yet. 19flip will switch it on per casino: ask your account manager.

«Dacha Fishing» is a slot with 5 reels × 3 rows and 10 fixed lines. Fish symbols carry a value of 2× to 50× the bet; the fisher is a wild. Three or more floats give 10, 15 or 20 free spins of the «Садок» bonus: every fisher on the screen collects the values of all fish, every 4 fishers add 10 spins and raise the collect multiplier ×1 → ×2 → ×3 → ×10, a cat drops fish when a fisher lands alone, and a golden catfish is worth up to 500×. Free spins can be retriggered (+10). The RTP is 97 %.

One spin is one round. The game plays out the whole round, including every free spin, when the player presses spin or buys the bonus. The round therefore has one debit and at most one credit, however long the bonus animation takes on screen. A reload in the middle of free spins moves no money: the win is already credited, and the game only replays the animation.

Launch¶

mode LIVE or DEMO. For DEMO, demo_balance sets the starting balance; without it the demo starts at 1000. DEMO sessions make no wallet callbacks.
rtp must be 97 or omitted. Any other value fails the launch with 400 REQUEST_ERROR «RTP … is not allowed for this game».
A bet ladder for the currency is required: without one the launch fails. The player bets one of the ladder steps; the line bet is the bet / 10.
max_win from your limits is applied per round (see Max win).
The launch URL is …?token=<token>&lang=<lang>; the token is valid for 24 hours. The game is translated into Russian (ru), Ukrainian (uk or ua) and English (any other lang).

Bonus buy¶

The bonus buy costs 100 × bet and starts 10 free spins of the «Садок» bonus at once; its return is about 97 %. Bought bonuses use their own reels, so their average differs from a bonus won in the base game; the rules tell the player this. Like any debit, the price is checked against your max_bet, so the game offers the buy only while 100 × bet ≤ max_bet: with max_bet 100, up to a bet of 1.00. Otherwise the buy is disabled in the game. A bonus buy returns less than its price in most cases: the average comes from rare large bonuses. Bonus buy can be switched off only for all casinos at once; if it is not allowed in your market, tell your account manager before enabling the game.

Small bets¶

Wins are rounded down to the minor unit once per round (the line bet is the bet / 10). Bets that are multiples of 0.10 lose nothing. Other bets lose a little RTP: about −0.83 percentage points at 0.05, −0.28 at 0.15, −0.17 at 0.25, −0.06 at 0.75.

Max win¶

A round wins at most 5000 × bet, and at most max_win if you set one. Reaching the cap ends the round at once, free spins included, and the credit is exactly the cap. We recommend max_win ≥ 5000 × max_bet: a lower limit lowers the RTP on high bets.

Money flow (LIVE)¶

The same as Dacha Dogs: every round has its own round_id, there is no game_round_id and no /round/finish.

Debit. On spin or bonus buy the game sends one /bet/debit of the round price: the bet or 100 × bet. A debit you decline (402 or another 4xx) ends the round with no further calls. If your debit times out or returns 5xx, the game repeats it once with the same idempotency_key. If the outcome is still unknown, it sends /bet/rollback with the debit's idempotency_key as original_transaction_id, and retries the rollback with the same key until it gets a definite answer, never sooner than a minute after the previous attempt.
Win. If the round won anything (base spin and free spins together), the game sends one /win/credit of the whole win with multiplier = win / bet (e.g. "57.30"). If your credit fails, the game repeats it with the same idempotency_key until it succeeds, never sooner than a minute after the previous attempt. A win is never rolled back.
Loss. No money callback. The round keeps only its debit.

The credit is at most 5000 × the debit; for a bonus buy (price 100 × bet) that is at most 50× its debit.

/balance is called when the game opens and when the player's balance has to be re-read (after a reconnect or while a payout is being retried); the game does not poll it.

game_id is "dacha-fishing" in debits and credits; transaction_id is null. Rollbacks carry no game_id.

Bonus wagering¶

Bonus buy turns a large stake into one high-variance round with about 97 % return. If your bonus terms count «Dacha Fishing» bets toward wagering, consider excluding bonus buys or counting them at a reduced rate.

Dacha Pickles¶

Added in 2.88.0

«Dacha Pickles» (dacha-pickles) is not available to casinos yet. 19flip will switch it on per casino: ask your account manager.

«Dacha Pickles» is a slot with 5 reels × 4 rows and 40 fixed lines and a Hold & Win bonus, «Закатка». Coin lids carry a value of 0.5× to 50× the bet or a MINI 20× / MINOR 50× / MAJOR 250× jackpot; 6 or more coins, 3 scatters or a full jar start the bonus. In the bonus, coins stick, empty cells respin, special lids collect, boost or copy coin values, and filling the whole field pays GRAND 2000×. The RTP is 97 % over prolonged play at one bet (see Jars).

One spin is one round. The game plays out the whole round, including the whole bonus, when the player presses spin or buys the bonus. The round therefore has one debit and at most one credit, however long the bonus animation takes on screen. A reload in the middle of the bonus moves no money: the win is already credited, and the game only replays the animation.

Launch¶

mode LIVE or DEMO. For DEMO, demo_balance sets the starting balance; without it the demo starts at 1000. DEMO sessions make no wallet callbacks.
rtp must be 97 or omitted. Any other value fails the launch with 400 REQUEST_ERROR «RTP … is not allowed for this game».
A bet ladder for the currency is required: without one the launch fails. The player bets one of the ladder steps; the line bet is the bet / 40.
max_win from your limits is applied per round (see Max win).
The launch URL is …?token=<token>&lang=<lang>; the token is valid for 24 hours. The game is translated into Russian (ru), Ukrainian (uk or ua) and English (any other lang).

Jars¶

Three jars above the reels fill with coloured lids; a full jar (10 lids) starts the bonus with its own effect. Jars are the only thing the game keeps between rounds:

they are stored per your casino, player, currency, mode and bet: every bet of the ladder has its own three jars, and LIVE and DEMO never mix;
they do not expire: they survive closing the game, a new session and a new day. A bonus buy plays on temporary jars and does not touch the saved ones;
if you remove a bet from your ladder, its jars stay stored but the player cannot reach them until the bet returns.

Part of the return is paid when a jar fills, so the 97 % is reached over prolonged play at one bet. A player who starts from empty jars and plays a short session gets less: about 91 % for 100–1 000 spins, about 94 % for 3 000 spins; about 6 percentage points of the RTP come from the jars. The rules (i button) show these numbers to the player. Your reports will therefore show an RTP a little below 97 % while players have unfinished jars, more so if they often change bets.

Bonus buy¶

Two buys, both with a return of about 97 %:

Option	Price	What it starts
«Закатка»	80 × bet	the bonus with 6 coins
«Бабушкин погреб»	250 × bet	the bonus with 6 coins, one of them a Grandpa lid, and a random jar effect

Bought bonuses use their own coin tables, so their average differs from a bonus won in the base game; the rules tell the player this. Like any debit, the price is checked against your max_bet, so the game offers an option only while price × bet ≤ max_bet: with max_bet 100, «Закатка» up to a bet of 1.25 and «Бабушкин погреб» up to 0.40. Otherwise that option is disabled in the game (a forced request gets BUY_UNAVAILABLE). A bonus buy returns less than its price in most cases: the average comes from rare large bonuses. Bonus buy can be switched off only for all casinos at once; if it is not allowed in your market, tell your account manager before enabling the game.

Small bets¶

Wins are rounded down to the minor unit once per round (the line bet is the bet / 40). Bets that are multiples of 0.40 lose nothing. Other bets lose a little RTP: about −1.14 percentage points at 0.10, −0.28 at 0.20, −0.49 at 0.25, −0.23 at 0.50, −0.06 at 1.00. The rules state the RTP for bets from 1.00.

Max win¶

A round wins at most 10 000 × bet, and at most max_win if you set one. Reaching the cap ends the round at once, the bonus included, and the credit is exactly the cap. We recommend max_win ≥ 10 000 × max_bet: a lower limit lowers the RTP on high bets; below 2000 × bet it also cuts every GRAND.

Money flow (LIVE)¶

The same as Dacha Fishing: every round has its own round_id, there is no game_round_id and no /round/finish.

Debit. On spin or bonus buy the game sends one /bet/debit of the round price: the bet, 80 × bet or 250 × bet. A debit you decline (402 or another 4xx) ends the round with no further calls, and the jars do not change. If your debit times out or returns 5xx, the game repeats it once with the same idempotency_key. If the outcome is still unknown, it sends /bet/rollback with the debit's idempotency_key as original_transaction_id, and retries the rollback with the same key until it gets a definite answer, never sooner than a minute after the previous attempt.
Win. If the round won anything (base spin and bonus together), the game sends one /win/credit of the whole win with multiplier = win / bet (e.g. "57.30"). If your credit fails, the game repeats it with the same idempotency_key until it succeeds, never sooner than a minute after the previous attempt. A win is never rolled back.
Loss. No money callback. The round keeps only its debit.

The credit is at most 10 000 × the debit; for a bonus buy that is at most 125× («Закатка») or 40× («Бабушкин погреб») its debit.

/balance is called when the game opens and when the player's balance has to be re-read (after a reconnect or while a payout is being retried); the game does not poll it.

game_id is "dacha-pickles" in debits and credits; transaction_id is null. Rollbacks carry no game_id.

Bonus wagering¶

Bonus buy turns a large stake into one high-variance round with about 97 % return. If your bonus terms count «Dacha Pickles» bets toward wagering, consider excluding bonus buys or counting them at a reduced rate.

Bingo Bongo¶

Bingo Bongo is a shared-table game: many players buy cards for the same scheduled round, and the prize pool (bank) is formed from their purchases. This changes several assumptions that hold for single-player games.

Launch¶

No demo. mode DEMO is refused by the game and launch-game returns 502 EXTERNAL_SERVICE_ERROR (detail begins with Game API error:). Launch Bingo Bongo in LIVE only.
One table per currency. Your players are grouped by your account and currency: USD players and EUR players play at different tables, with separate banks and jackpots. The first launch in a new currency creates that table automatically with default card prices and no schedule or host until 19flip configures it. Tell 19flip in advance which currencies you will use.
rtp, demo_balance and the bet ladder are ignored; card prices come from the table's configuration.
player_id must be at most 128 characters. Other players see a nickname; unless the player picks one in the game, it is player_ followed by the first 8 characters of your player_id. Never use e-mails, phone numbers or other personal data as player_id.
lang must be at most 8 characters.
The token in launch_url is single-use and expires after 5 minutes. Open the URL immediately; launch again if the player comes back later.

Bingo Bongo has a live banner for your lobby. Its data comes from the table of your account in the banner's currency, so show players the banner in the currency they will play in:

Before a draw, it announces the next scheduled draw with a countdown (scheduled). Times are shown in the visitor's own time zone.
While tickets are on sale (selling), it shows the draw number, the pot, players, cards and the jackpot.
During the draw (drawing), it shows the last ball and how many of the 90 balls are out. A ball appears on the banner only after it is shown to players in the game.
It hides when the table has no running round and no scheduled draw.

The draw number counts the rounds of your table (all rounds, including cancelled ones), so it differs between currencies.

Money flow¶

What happens in the game	Callback	`idempotency_key`
Lobby opens / balance refresh	`/balance`	–
Card purchase	`/bet/debit`	`bb-tkt-<n>-<round>-<purchase>`
Boost purchase	`/bet/debit`	`bb-tkt-<n>-<round>-<purchase>`
Tip to the host (paid by the player)	`/bet/debit`	`bb-tkt-<n>-<round>-<purchase>`
Bank prize	`/win/credit`	`bb-bank-<n>-<round>-<player>`
Jackpot, minor tier	`/win/credit`	`bb-jpn-<n>-<round>-<player>`
Jackpot, major tier	`/win/credit`	`bb-jpx-<n>-<round>-<player>`
Insurance payout	`/win/credit`	`bb-ins-<n>-<round>-<player>`
Tip received by the host	`/win/credit` to the host's `player_id`	`bb-tip-<n>-<round>-<purchase>`
Round cancelled: refund of each purchase	`/bet/rollback`, `reason` `round cancelled`	`bb-rfnd-<n>-<round>-<purchase>`
–	`/win/rollback`	never sent

The numbers inside the keys are internal ids; treat the keys as opaque strings. The purpose (card, boost, prize, jackpot, insurance, tip) is only visible in the key prefix – the callback type is just "debit" or "credit".

game_id is "bingo-bongo"; transaction_id is null.

Wins arrive asynchronously¶

Prizes, jackpot tiers, insurance and tips are paid by a background process after the draw, typically seconds to minutes later and possibly much later if your wallet was unavailable.
The player may have closed the game long before. The win is still valid and must be credited.
Unconfirmed payouts are retried with growing delays, using the same idempotency_key, until your wallet confirms them or they are escalated to 19flip staff. Deduplicate and answer each repeat with the stored result.
The session_id on a late win may be a different session of the same player than the one in which the cards were bought (the game uses the player's latest session when the original one is not at hand). Always credit by player_id and currency; use session_id only for reporting.
A round can produce several credits for the same player (bank prize, jackpot tier, insurance), each with its own key.

Refunds of cancelled rounds¶

If a round is cancelled, every purchase is refunded with /bet/rollback for the purchase amount. original_transaction_id is your transaction_id from the purchase's debit if 19flip received it; if the purchase debit timed out, it is the purchase's idempotency_key (bb-tkt-…). Look up both. If you never applied the purchase, answer 200 with an unchanged balance (see Wallet callbacks).

Declines¶

Answer 402 when the player cannot afford a purchase: Bingo Bongo then tells the player "not enough funds" (see also how 19flip classifies other answers in Errors). Other refusals are shown as a generic error. A refused win is not retried automatically by 19flip and ends up in manual handling – never refuse a valid win.

Game specifics¶

Summary¶

Block Boost¶

Launch¶

Money flow (LIVE)¶

Mister Twister¶

Magic Jump¶

Launch¶

Money flow (LIVE)¶

Flip Jet¶

Launch¶

Shared round and what players see¶

Money flow (LIVE)¶

Crash point and round-based promotions¶

Golden Flight (bonus buy)¶

Bonus wagering¶

Manual cashout and network delay¶

Ну, подними!¶

Launch¶

Boost Start¶

Money flow (LIVE)¶

Bonus wagering¶

Manual cashout and network delay¶

Book of Dawn¶

Launch¶

Ante and bonus buy¶

«Карты Босса»¶

Max win¶

Money flow (LIVE)¶

Bonus wagering¶

Dacha Dogs¶

Launch¶

Bonus buy¶

Small bets¶

Max win¶

Money flow (LIVE)¶

Bonus wagering¶

Dacha Fishing¶

Launch¶

Bonus buy¶

Small bets¶

Max win¶

Money flow (LIVE)¶

Bonus wagering¶

Dacha Pickles¶

Launch¶

Jars¶

Bonus buy¶

Small bets¶

Max win¶

Money flow (LIVE)¶

Bonus wagering¶

Bingo Bongo¶

Launch¶

Live banner¶

Money flow¶

Wins arrive asynchronously¶

Refunds of cancelled rounds¶

Declines¶