Casino bridge vasitəsilə canlı provayderləri necə birləşdirir

Canlı casino kontekstində bridge nədir

Bridge - operator platforması ilə canlı provayderlər (Evolution, Pragmatic Live, Ezugi, TVBet və s.) arasında API, hadisələr, loginq və maliyyə hesablamalarını normallaşdıran təbəqədir. Sadəcə olaraq, bridge on fərqli inteqrasiyanı «görünüşdə» eyniləşdirir: vahid tarif müqaviləsi, vahid tur status sxemi, monoton webhooks və hesabat.

Niyə lazımdır

Onlarla provayder üçün vahid müqavilə (platformada daha az dəyişiklik).

İdempotentlik və dubl müdafiəsi (şəbəkə retraisi, player reconnect).

Kataloqun normallaşdırılması (cədvəllər, limitlər, side-bets, lokallar).

Vahid kassa və risk qaydaları (limitlər, AML/KYT, RG).

Provayderlər üzrə QoS axını və SLA monitorinqi.

Komponentlər zənciri

1. Casino Platform (host): hesablar, KYC/RG, bonuslar, cüzdan, ön.

2. Bridge: provayderlərin adapterləri, hadisələrin avtobusu, masaların/limitlərin mappinqi, maliyyə hesablaması, loginq, webhooks.

3. Live-Provider: stream (adətən WebRTC/HLS), oyun mühərriki, nəticələrin hesablanması, dilerlər.

4. Cüzdan: Seamless (balans operator tərəfindən saxlanılır) və ya Transfer (oyun bankına provayderdən depozit).

5. Müşahidə: axın metrikası (FPS, RTT, bufer), biznes metrikası (Bet, GGR, Hold).

Şəbəkə protokolları və sessiyaları

Video:

WebRTC - aşağı gecikmə (100-500 ms), ICE/STUN/TURN tələb olunur.
HLS/LL-HLS - daha yüksək gecikmə, lakin daha asan CDN.
Bahislər və hadisələr: WebSocket/HTTP-SSE/REST.
Tokenlər: qısa ömürlü JWT/opaque (TTL 3-10 dəq), provayderin tələbi ilə rotasiya.

Cüzdan modelləri

1) Seamless wallet (tövsiyə olunur)

Mərc/ödəniş bridge vasitəsilə operatorun cüzdanına gedir.

Üstünlüklər: vahid balans, ani limit nəzarəti, sadələşdirilmiş RG.

Mənfi cəhətləri: ciddi cüzdan mövcudluğu tələbləri (SLA).

2) Transfer wallet

Oyunçu vəsaiti provayderdən «masa bankına» köçürür.

Üstünlüklər: zirvələr zamanı operatorun cüzdanına daha az yük.

Mənfi cəhətləri: UX-də daha çətin geri qaytarma, reconcile və AML-nəzarət, sürtünmə.

Sessiyanın həyat dövrü (seamless)

1 ./createSession → bridge 'sessionId' yaradır, 'streamUrl', 'betSocketUrl' qaytarır.

2. Ön oyunçu (WebRTC/HLS) və hadisə bağlantısı açır.

3. Oyunçu mərc edir → 'placeBet' bridge ('idempotencyKey', 'roundId', 'selection', 'stake').

4. Bridge cüzdanındakı məbləği (hold) əvvəlcədən təsdiqləyir.

5. Provayder 'bettingClosed' → spin/deal → 'roundResult' elan edir.

6. Bridge ödəniş hesablayır, debet/geri qaytarır, 'transactionId' yaradır.

7. Bridge webhook platformasına ('roundId', 'result', 'payout', 'balanceAfter') göndərir.

8. Son/təkrar qoşulma - 'sessionId' (idempotent).

Hadisə müqaviləsi (nümunə)

Mərc → bridge (WS/REST):

json
{
"type": "bet. place",  "idempotencyKey": "c0a4-77f…",  "sessionId": "sess_abc123",  "roundId": "R-2025-10-17-18:45:03-Table23",  "selection": [{"market":"roulette_straight","value":"17"}],  "stake": {"amount":"5. 00","currency":"EUR"},  "limitsProfile":"VIP_A"
}

Cavab bridge:

json
{
"status":"accepted",  "balanceHold":"-5. 00",  "betId":"bet_9f2…",  "effectiveLimits":{"maxBet":"5000. 00"}
}

Tur nəticəsi → platforma (webhook):

json
{
"event":"round. settle",  "roundId":"R-2025-10-17-18:45:03-Table23",  "bets":[
{"betId":"bet_9f2…","stake":"5. 00","payout":"180. 00","outcome":"WIN"}
],  "transactions":[
{"id":"trn_bet_9f2…","type":"DEBIT","amount":"5. 00"},   {"id":"trn_pay_9f2…","type":"CREDIT","amount":"180. 00"}
],  "balanceAfter":"1320. 40"
}

Əsas qaydalar:

İdempotentlik: 'idempotencyKey' ilə bütün sorğular.
Nəticələrin dəqiq tipifikasiyası: 'WIN/LOSE/PUSH/VOID/RETRY'.
Sabit identifikatorlar: 'roundId' qlobal olaraq unikaldır (cədvəl + vaxt + şard).

Kataloq və limitlər

Discovery: '/providers/: id/tables '- masaların siyahısı, limitlər, side-bets, dillər, cədvəl.

Limit hovuzları: 'DEFAULT', 'VIP _ A', 'VIP _ B', 'Ultra'.

Mapping qaydaları: ölkə/valyuta/KYC statusu → icazə verilən masalar və limit profilləri.

Qaynar limit dəyişikliyi: hadisələr 'limits. update 'masa yenidən başlamadan.

Müşahidə və axın keyfiyyəti (QoS)

Oyunçu ölçüləri:

RTT siqnalları bahis (hədəf <150 ms WebRTC).
Dropped frames / buffer events.
Bitrate/Resolution adaptasiya.
Bet window latency ('bettingOpen' və faktiki bahis qəbulu arasında vaxt).

Provayder/masa ölçüləri:

Aptime masa, aborted rounds, late settlements, tezlik 'VOID'.
bahis bağlandıqdan sonra orta vaxt-to-settle.
QoS alertlər: FPS deqradasiyası, 'retry' sıçramaları.

Uyğunluq və təhlükəsizlik

KYT/AML: depozit mənbələrinin təhlili, «yüksək risk» bayrağı → canlı bahis qadağası.

RG (məsuliyyətli oyun): time-auts, limitlər, özünü istisna - 'placeBet' qədər tətbiq olunur.

Data residency: məntiq və PII operatorda saxlanılır; bridge yalnız texniki saxlayır. jurnallar və aqreqatlar.

Nəqliyyat təhlükəsizliyi: mTLS/IP-whitelist provayderlərə, HMAC sorğu imzası, qısa TTL tokenləri.

Audit: ledger dəyişməz (WORM/append-only), ixrac 'roundId '/' sessionId'.

Hesablama, reconcile və qaytarmalar

On-the-fly settle: Hər nəticə üçün ani debet/kredit.

Batch reconcile: provayderin hesabatlarının (hourly/daily) bridge (P&L, komissiya) ledceri ilə müqayisəsi.

VOID/REFUND ssenariləri: axın uğursuzluğu, diler səhvi, mübahisə - dəqiq səbəblər kodları ilə qismən/tam geri dönüş.

Dispute Center: dəstəyin biletləri tez bir zamanda həll etməsi üçün 'roundId' dəstəyinin videofid yazması (time-code).

Performans və uğursuzluq

Scaling: Provayderlərin stateless adapterləri + Kafka/NATS hadisə şini kimi.

Saxlama yerləri: sessiyalar/limitlər üçün isti (Redis), ledger üçün isti (Postgres), loglar üçün soyuq (S3).

Folbeklər: əgər cüzdan cavab vermirsə - retrajlı 'SOFT _ DECLINE'; provayder mövcud deyilsə - masaları söndürmək/lobbidə gizlətmək.

İdempotent retrajlar: 'placeBet '/' settle' təkrar etmək təhlükəsiz.

UX: frontend nümunələri

Saat sinxronizasiyası: «Vasitəsilə bahislərin bağlanması» üçün bridge-dən 'serverTime' istifadə edin....

Lokalizasiya: diler dili ≠ interfeys dili; subtitrlər/terminlərin sözlərini göstərin.

Stream Player: auto-fallback WebRTC → LL-HLS pis şəbəkə ilə.

Error UI: başa düşülən kodlar ('LBRG-401 TOKEN_EXPIRED',' LBRG-429 LIMIT_EXCEEDED', 'LBRG-503 PROVIDER_DOWN').

Multiplayness: Seans pozulmadan masaların sürətli swich (reuse 'sessionId').

Anti-nümunələr

Müştəridə uzun ömürlü tokenləri saxlayın.

'bettingClosed' sonra bahis almaq üçün - mübahisə zəmanət.

Retralarda 'idempotencyKey' → dublların olmaması.

'roundId' və hesabatlarda time-zones qarışdırın.

Profillər və KYC statusu olmadan «göz» limitləri qoyun.

QoS axını göz ardı - mobil şəbəkələrdə yüksək churn.

Addım-addım tətbiq planı (çek siyahısı)

Memarlıq və müqavilələr

Vahid hadisə müqaviləsini düzəlt: 'bet. place`, `bet. accepted`, `bet. rejected`, `round. settle`, `limits. update`, `session. close`, `provider. error`.
idempotency və 'roundId', 'betId', 'transactionId' formatlarını təyin edin.
Cüzdan modelini seçin (Seamless prioritet).

Təhlükəsizlik

Provayderlərə mTLS, HMAC imzası webhooks, TTL token ≤ 10 dəqiqə.
RG/AML/KYT dərəcələri qəbul əvvəl siyasət, audit-log.

Kataloq və limitlər

Ölkə/valyuta/KUS üzrə masa və limit profillərinin idxalı, mappinq.
Masaların limitlərinin və statuslarının isti yenilənməsi.

Frontend

LL-HLS folback ilə WebRTC player, saat sinxronizasiya, sabit vaxt bahis.
Error kodları və oxunan mesajlar.

Test planı

High-latency/packet-loss ssenariləri, bahis itkisi olmadan reconnection.
Cüt click mərc → bir debet (idempotent).
VOID/REFUND, mübahisəli raundlar, hesabat uyğunsuzluqları.

Müşahidə

Дашборд QoS: RTT, dropped frames, aborted rounds, time-to-settle.
SLA provayderi tərəfindən alertlər, reconcile hesabatları.

Bridge canlı inteqrasiyaların «zooparkını» idarə olunan sistemə çevirir: vahid dərəcələr, vahid hesablamalar, proqnozlaşdırıla bilən UX və axının keyfiyyətinə şəffaf nəzarət. Düzgün dizayn edilmiş körpü ilə operator yeni canlı provayderləri daha sürətli birləşdirir, texnoloji riskləri azaldır və P & L-ni idempotentlik, ciddi limitlər və dəqiq müşahidə sayəsində qoruyur.