LiveG24 - огляд та інтеграція

Короткий огляд

LiveG24 - провайдер Live-казино, орієнтований на класичні дисципліни (рулетка, блекджек, баккара) та їх прискорені/варіативні режими. Ключовий фокус - стабільний стрімінг з низькою затримкою, гнучка локалізація (мови/валюти) і передбачувана сервер-к-серверу інтеграція з гаманцем оператора. Техстек поєднує WebRTC (для real-time) з fallback на HLS/DASH, а також веб-сокети для ставок і результатів.

Кому підходить: середнім і великим операторам/агрегаторам, яким важливі швидке підключення Live-вертикалі, прозорі коллбеки гаманця, гнучкі ліміти і телеметрія.

Портфель та досвід користувача

Ігри та варіації

Рулетка: європейська/авто-рулетка, прискорені режими, статистика hot/cold, швидкі повтори ставок.
Блекджек: класичний, Speed-столи, Bet Behind, сайд-ставки і страховка за правилами столу.
Баккара: класика, No Commission/Speed, «дорожні карти» (Roadmaps), додаткові пули ставок.

UX/UI

HTML5-клієнт з адаптивною версткою, пресети чіпів, швидкі повторні ставки.
Історія роздач/спінів, чат з модерацією, підказки по лімітах і відповідальності.
Мультимовність, мультивалютність, локальні формати чисел/дат.

Відповідальна гра

Ліміти за ставками/часу, приховування столів за гео/віком, повідомлення RG відповідно до юрисдикції.

Потоки, протоколи та продуктивність

Відео: WebRTC для низької затримки (~ 0. 5–2. 5 с при стабільній мережі), fallback на HLS/DASH при деградації.
Доставка: CDN/edge-PoP, sticky-роутинг до найближчого вузла, health-checks нод, швидкий failover.
ABR: адаптивний бітрейт, безшовні перемикання; на мобайлі - апаратне декодування.
Мережева гігієна: latency до edge <150-200 мс, HTTP/2 +, TLS 1. 2 +, пріоритет мультимедійного трафіку.

Математика, ліміти та розрахунки

RTP/House Edge: відповідають правилам і сайд-ставкам конкретного столу (розкриваються в правилах).
Ліміти: глобальні (по столу) і персональні (по гравцеві); VIP-рівні; окремі стелі для сайд-ставок.
Валюти: розрахунок в minor-юнітах; конвертація/відображення - на стороні оператора; коректні округлення за правом юрисдикції.
Комерція: RevShare/Flat/Hybrid визначається договором і не впливає на клієнтську математику.

Модель інтеграції

Високорівнева схема

1. Гравець → Frontend оператора → SSO/JWT

2. Operator/Aggregator API ↔ LiveG24 API - створення та валідація сесії

3. Клієнт ↔ WebRTC/HLS - відеопотік

4. Клієнт ↔ WebSocket - ставки/події (низька затримка)

5. LiveG24 → Webhook/Callback - авторизації списань/виплат

6. Гаманець оператора (Auth Debit/Credit) ↔ Ledger/KYC/AML

7. BI/Anti-Fraud/Monitoring - аудит, ретраї, reconciliation

Вимоги до оточення

Безпека: JWT/OAuth2 для сесій, allowlist IP/Mutual-TLS для S2S, короткі TTL токенів, ротація ключів.
Продуктивність: авто-масштабування WS-шардів, балансування з sticky-сесіями.
Сумісність: актуальні Chrome/Edge/Safari/Firefox, iOS/Android WebView.

Сесії, запуск та автентифікація

SSO-патерн

Оператор формує короткоживучий токен з'player _ id', валютою, локаллю, VIP/лімітами і'return _ url'. Провайдер повертає'launch _ url'.

POST /api/v1/sessions
Authorization: Bearer <operator-key>
{
"player_id": "u_284710",
"currency": "EUR",
"locale": "ru-RU",
"limits": { "table_min": 1.00, "table_max": 10000.00, "side_bet_max": 200.00 },
"meta": { "vip_level": 2, "return_url": "https://op.example.com/return" }
}

{
"session_id": "sess_9d3f...",
"launch_url": "https://liveg24.example/launch?sess=sess_9d3f...",
"expires_in": 3600
}

Запуск клієнта

Через'launch _ url'в iFrame/новому вікні (CSP/' X-Frame-Options'узгоджуються). Heartbeat/refresh продовжує сесію.

Ставки та події (WebSocket)

Типи подій

Ігрові: `ROUND_OPEN`, `BETS_OPEN`, `BETS_CLOSED`, `ROUND_RESULT`

Транзакційні: `BET_PLACED`, `BET_ACCEPTED/REJECTED`, `PAYOUT`

Службові: `PING/PONG`, `RECONNECT_HINT`, `ERROR`

{
"type": "ROUND_RESULT",
"table_id": "roulette_eu_05",
"round_id": "r_2025_11_02_15_42_17",
"result": { "number": 8, "color": "black" },
"payouts": [
{ "bet_id": "b_9182", "amount_minor": 360000 },
{ "bet_id": "b_9183", "amount_minor": 0 }
],
"server_ts": "2025-11-02T13:42:19Z"
}

Надійність каналу

Авто-reconnect, відновлення підписок і стану поточного раунду.
Back-pressure: обмеження частоти клієнтських повідомлень.
Дедуплікація по'bet _ id '/' round _ id'на сторонах провайдера і оператора.

Грошові операції та колбеки гаманця

Потоки

Auth-дебет (ставка): запит на списання/заморозку, відповідь оператора'APPROVED/DECLINED'.
Кредит (виплата): ініціюється провайдером, оператор підтверджує і повертає баланс.
Reconciliation: періодичні звіти по раундах/транзакціях для звірки з леджером.

Гарантії доставки

Ідемпотентність через'X-Idempotency-Key'( TTL ≥ 24 год), нумерація повідомлень per player.
Ретраї з експоненціальною паузою, контроль черговості обробки.

POST /wallet/payouts
Idempotency-Key: 7c1a-...
{
"player_id": "u_284710",
"round_id": "r_2025_11_02_15_42_17",
"bet_id": "b_9182",
"amount_minor": 360000,
"currency": "EUR"
}

Налаштування лобі та промо

Каталог столів: групування за типом дисципліни, мовою дилера, лімітами, VIP-рівнями.
Промо-віджети: банери, турніри, місії/квести, «гарячі числа», топ-виграші.
Гео-фільтри: whitelist/blacklist юрисдикцій, локальні вимоги Responsible Gaming.
UI-параметри: авто-вхід в конкретний стіл, приховування чату, пресети ставок, кастомні номінали.

Масштабування та відмовостійкість

Мульти-регіон: вибір найближчого РоР/студії, ASN/гео-роутинг.
Балансування: sticky по гравцеві/столу; при збоях - прозорий re-join.
Квоти/Rate limits: обмеження WS-підписок/змін ставок, захист від штормів подій.
Деградація: fallback на HLS, «lite-UI» для слабких пристроїв або поганої мережі.

Безпека та комплаєнс

Шифрування: TLS 1. 2+, HSTS; SRTP для WebRTC.
Доступ: JWT з коротким TTL, IP allowlist/Mutual-TLS для коллбеків, підпис запитів.
PII-мінімізація: маскування ідентифікаторів; логи без відкритих PII.
Анти-фрод: поведінкові сигнали (частота ставок, множинні сесії, VPN/ASN-патерни), ризик-прапори і тротлінг.
RG/Регуляторика: самовиключення/тайм-аути/ліміти, локальні банери та cookie-згоди.

Моніторинг, звітність та SLA

Метрики

Aptime: медіа/WS, p50/p95 затримки,% frame-drops, помилки коллбеків (частки/коди).
Продукт: конверсія'Launch → First Bet', середній чек, утримання з дисциплін/мов, ROI промо.
Операції: ретраї та їх причини, частка відхилених гаманцем авторизацій.

SLO/SLA (орієнтири)

Медіа ≥ 99. 9%, API ≥ 99. 95% аптайм.
Коллбеки: p95 <500 мс всередині регіону.
Reconnect WS: p95 <3-5 с, відновлення підписок - автоматично.

Дашборди/алерти

Кореляція'round _ id/bet _ id/callback _ id', трасування інцидентів, статус-панель з регламентами комунікацій.

Тестування та приймання

1. Sandbox: окремі ключі, фіктивні результати раундів/лімітів.
2. E2E: успішні/відхилені ставки, обриви WS, подвійні виплати (перевірка ідемпотентності), конфлікт лімітів.
3. Навантаження: піки прайм-тайму/турнірів, ABR-перемикання, деградація до HLS.
4. Безпека: негативні кейси JWT, підпис коллбеків, rate-limits, CORS/CSRF-політики.
5. Reconciliation: звірка звітів провайдера з леджером (суми, статуси, округлення).

Кращі практики інтеграції

Робіть гаманець оператора джерелом істини; всі S2S - ідемпотентні.
Розділяйте коллбеки по чергах ('bets','payouts','recon') з пріоритетами/ретраями.
Кешуйте ліміти/конфіги столів на edge (TTL + ручна інвалідація).
Використовуйте feature-flags для поетапного відкриття столів/мов/VIP-лімітів.
Плануйте fail-over: fallback протоколів, «технічна пауза», компенсаційні промо.
Логуйте хеші PII і кореляційні ключі замість прямих ідентифікаторів.

Чек-листи

Для розробки

• Генерація/валідація JWT/SSO
• Клієнт WebRTC + fallback HLS
• WS-клієнт з авто-reconnect і back-pressure
• Ідемпотентні S2S-ендпоінти, ретраї, дедуплікація
• Маскування PII, ротація ключів/секретів

Для запуску

• Мови/валюти/формати (L10n)
• Гео-фільтри та обмеження юрисдикцій
• Моніторинг SLO (API/Stream/WS) + алерти
• Нічні звіти та reconciliation
• План інцидентів і статус-сторінки

FAQ (коротко)

Чи можна запускати в iFrame? Так, через'launch _ url'при узгоджених CSP/' X-Frame-Options'.
Чи є Speed/Bet Behind? Доступно на ряді столів по конфігурації.
Як обробляти обриви зв'язку? Авто-reconnect, відновлення підписок/ставок, ідемпотентні коллбеки.
Є промо-інструменти? Банери, турніри, місії/квести, події для аналітики.
Як влаштований reconciliation? Провайдер публікує звіти; оператор звіряє з леджером по'round _ id/bet _ id'.

Підсумок

LiveG24 - практичний Live-провайдер з сучасним стримінгом і передбачуваною інтеграційною моделлю. Дотримання описаних патернів (SSO, WebRTC + WS, гаманець з ідемпотентними колбеками, моніторинг SLO, RG/комплаєнс) забезпечує стійку роботу в пікові години, коректну економіку Live-вертикалі і мінімізацію операційних ризиків.