Bir kumarhane canlı sağlayıcıları köprü üzerinden nasıl bağlar?

Canlı bir casino bağlamında köprü nedir

Bridge, operatörün platformu ile canlı sağlayıcılar (Evolution, Pragmatic Live, Ezugi, TVBet, vb.) arasında API'leri, olayları, günlüğü ve finansal hesaplamaları normalleştiren bir katmandır. Basitçe söylemek gerekirse, briç bir düzine farklı entegrasyonu "görünüşte" aynı yapar: tek bir bahis sözleşmesi, tek bir tur durum şeması, monoton web kitapları ve raporlama.

Neden gerekli

Düzinelerce sağlayıcı için tek bir sözleşme (daha az platform değişikliği).

Idempotence ve takes karşı koruma (ağ retrays, yeniden bağlamak oyuncu).

Katalog normalleştirme (tablolar, limitler, yan bahisler, yerel ayarlar).

Tek kasa ve risk kuralları (limitler, AML/KYT, RG).

QoS akışını ve SLA'yı sağlayıcıya göre izleme.

Bileşenler zinciri

1. Casino Platformu (ana bilgisayar): hesaplar, KYC/RG, bonuslar, cüzdan, ön.

2. Bridge: sağlayıcı adaptörleri, olay veriyolu, tablo/limit haritalama, finansal muhasebe, günlük kaydı, webhooks.

3. Canlı Sağlayıcı: akış (genellikle WebRTC/HLS), oyun motoru, sonuç hesaplama, bayiler.

4. Cüzdan: Kesintisiz (operatör tarafından saklanan bakiye) veya Transfer (oyun bankasına sağlayıcıdan para yatırma).

5. Gözlemlenebilirlik: akış metrikleri (FPS, RTT, arabellek), iş metrikleri (Bet, GGR, Hold).

Ağ protokolleri ve oturumları

Video:

WebRTC - düşük gecikme süresi (100-500 ms), ICE/STUN/TURN gereklidir.
HLS/LL-HLS - daha yüksek gecikme, ancak daha basit CDN.
Bahisler ve etkinlikler: WebSocket/HTTP-SSE/REST.
Belirteçler: kısa ömürlü JWT/opak (TTL 3-10 dakika), sağlayıcının isteği üzerine rotasyon.

Cüzdan modelleri

1) Kesintisiz cüzdan (önerilir)

Bahis/ödeme köprüden operatörün cüzdanına gider.

Artıları: birleşik denge, anlık sınır kontrolü, basitleştirilmiş RG.

Eksileri: Sıkı cüzdan karşılanabilirliği (SLA) gereksinimleri.

2) Transfer cüzdanı

Oyuncu, parayı sağlayıcıdaki "masa bankasına" aktarır.

Artıları: Pikler sırasında operatörün cüzdanında daha az yük.

Eksileri: daha sert dönüşler, uzlaştırma ve AML kontrolü, UX'te sürtünme.

Oturum yaşam döngüsü (kesintisiz)

1 ./createSession> bridge 'sessionId' oluşturur, 'streamUrl', 'betSocketUrl' döndürür.

2. Ön taraf oynatıcıyı (WebRTC/HLS) ve olay bağlantısını açar.

3. Oyuncu bridge'de "placeBet" ("idempotencyKey", "roundId", "seçim", "bahis") bahisleri yapar.

4. Bridge, cüzdandaki miktarı (bekletme) önceden onaylar - sağlayıcıya onaylar.

5. Sağlayıcı 'bahis' Kapalı '- spin/deal -' roundResult 'beyan eder.

6. Bridge, ödemeyi hesaplar, bekletmeyi yazar/döndürür, 'transactionId' oluşturur.

7. Bridge, platforma bir webhook gönderir ('roundId', 'result', 'payout', 'balance' after '), deftere yazar.

8. Sonlandırma/yeniden bağlanma - 'sessionId' (idempotent) ile.

Olay sözleşmesi (örnek)

Köprü hızı (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 ", "para birimi":" EUR"}, "limitlerProfil":" VIP _ A"
}

Köprü yanıtı:

Json
{
"status":'kabul edildi "," balanceHold ":" -5. 00", "betId ": "bet _ 9f2"..., "effectiveLimits ": {" maxBet":" 5000. 00"}
}

Platform turunun sonucu (webhook):

Json
{
"event ":" round. settle", "roundId":" R-2025-10-17-18: 45: 03-Tablo 23", "bahisler": [
{"betId ": "bet _ 9f2"...," stake":" 5. 00 ", "ödeme":" 180. 00, ""sonuç":" KAZAN"}
], "işlemler": [
{'id ":" trn _ bet _ 9f2... "," type ":" DEBIT "," amount ":" 5. 00 "}, {'id": "trn _ pay _ 9f2...", "type": "CREDIT", "amount": "180. 00"}
], "balanceAfter":" 1320. 40"
}

Temel kurallar:

'IdempotencyKey'ile tüm istekler.
Sonuçların açık bir şekilde yazılması: 'KAZAN/KAYBET/PUSH/VOID/RETRY'.
Kararlı tanımlayıcılar: 'RoundId' küresel olarak benzersizdir (tablo + zaman + parça).

Katalog ve limitler

Keşif:'/providers/: id/tables '- masa listesi, limitler, yan bahisler, diller, program.

Havuzları sınırla: 'DEFAULT', 'VIP _ A', 'VIP _ B', 'Ultra'.

Ülke/para birimi/KYC durum haritalama kuralları - izin verilen tablolar ve sınır profilleri.

Sıcak limit değişikliği: 'Limitler' olayları. 'tabloyu yeniden başlatmadan güncelle.

Akış gözlemlenebilirliği ve kalitesi (QoS)

Oyuncuya göre metrikler:

Bahis sinyallerinin RTT'si (hedef <150 ms WebRTC).
Düşen çerçeveler/arabellek olayları.
Bitrate/Çözünürlük uyarlaması.
Bahis penceresi gecikmesi ('bettingOpen'ile bahsin gerçek kabulü arasındaki süre).

Sağlayıcıya/tabloya göre metrikler:

Masanın çalışma süresi, iptal edilen turlar, geç yerleşimler, frekans 'VOID'.
Fiyatlar kapandıktan sonra ortalama yerleşme süresi.
QoS uyarıları: FPS bozulması, 'yeniden deneme' sivri uçları.

Uyumluluk ve güvenlik

KYT/AML: para yatırma kaynaklarının analizi, "yüksek riskli" bayrak - canlı bahislerin yasaklanması.

RG (sorumlu oyun): zaman aşımları, limitler, kendini dışlama - 'placeBet'ten önce uygulanır.

Veri ikameti: Mantık ve PII operatör tarafından saklanır; Bridge yalnızca bu günlükleri ve agregaları saklar.

Taşıma güvenliği: Sağlayıcılara mTLS/IP-beyaz listesi, HMAC istek imzası, kısa TTL belirteçleri.

Denetim: değişmez defter (WORM/append-only), 'roundId'/' sessionId'ile dışa aktarma.

Uzlaşma, uzlaşma ve geri dönüşler

On-the-fly settle: Her sonuç için anında borç/kredi.

Toplu uzlaşma: sağlayıcı raporlarının (saatlik/günlük) köprü defteri (P&L, komisyon) ile uzlaştırılması.

VOID/İADE senaryoları: akış hatası, bayi hatası, anlaşmazlık - açık neden kodlarıyla kısmi/tam iade.

Anlaşmazlık merkezi: Bir video (zaman kodu) kaydeden bir grup 'roundId' ↔, böylece destek hızlı bir şekilde biletleri çözer.

Performans ve hata toleransı

Ölçekleme: durum bilgisi olmayan sağlayıcı bağdaştırıcıları + Kafka/NATS bir olay yolu olarak.

Depolama: Oturumlar/limitler için sıcak (Redis), defterler için sıcak (Postgres), günlükler için soğuk (S3).

Folbacks: cüzdan cevap vermezse - retras ile 'SOFT _ DECLINE'; Sağlayıcı mevcut değilse - tabloları kapatın/lobide gizleyin.

Idempotent retrays: Ağ zaman aşımları üzerinden 'placeBet'/' settle' tekrarlamak güvenlidir.

UX: ön uç desenleri

Saat senkronizasyonu: 'Bahisleri.... aracılığıyla kapat' zamanlayıcıları için köprüden 'serverTime' kullanın

Yerelleştirme: bayi dili ≠ arayüz dili; Altyazıları/terimler sözlüğünü göster.

Stream player: Otomatik geri dönüş WebRTC - Kötü bir ağ ile LL-HLS.

Hata UI: açık kodlar ('LBRG-401 TOKEN_EXPIRED',' LBRG-429 LIMIT_EXCEEDED',' LBRG-503 PROVIDER_DOWN').

Çoklu tablo: Oturumu bozmadan hızlı anahtar tabloları ('sessionId'yi yeniden kullanın).

Anti-desenler

Müşteri üzerinde uzun ömürlü belirteçleri saklayın.

Anlaşma nedeniyle 'Kapalı bahis' yaptıktan sonra teklifi kabul edin - anlaşmazlık garanti edilir.

'EmpotencyKey' yokluğu - retrays içinde kopyalar.

Zaman dilimlerini 'roundId've raporlarda karıştırın.

Profiller ve KYC durumu olmadan "göze göre" sınırlar belirleyin.

QoS akışını yoksay - mobil ağlarda yüksek dalgalanma.

Adım adım uygulama planı (kontrol listesi)

Mimari ve Sözleşmeler

Tek bir etkinlik sözleşmesini düzeltin: 'bet. place', 'bet. Kabul edildi ',' bahis. Reddedildi ', yuvarlak. Yerleştir ',' sınırları. Update ',' oturumu. Kapat ',' sağlayıcı. Hata '.
Idempotency ve 'roundId', 'betId', 'transactionId' biçimlerini tanımlayın.
Cüzdan modelini seçin (Kesintisiz öncelik).

Güvenlik

Sağlayıcılara mTLS, HMAC imzalı web kitapları, TTL belirteci ≤ 10 dakika.
Oranlara kabul edilmeden önce Politika RG/AML/KYT, denetim günlüğü.

Katalog ve limitler

İthalat tabloları ve sınır profilleri, ülke/para birimi/ACC'ye göre haritalama.
Sınırların ve tablo durumlarının sıcak güncellemesi.

Önuç

LL-HLS folback, senkronizasyon saati, istikrarlı bahis zamanlayıcıları ile WebRTC oyuncusu.
Hata kodları ve insan tarafından okunabilir mesajlar.

Test planı

Yüksek gecikme/paket kaybı komut dosyaları, teklifi kaybetmeden yeniden bağlanma.
Çift tıklama teklifi - bir borç (idempotency).
VOID/İADE, tartışmalı turlar, raporlardaki tutarsızlıklar.

Gözlemlenebilirlik

Дашборд QoS: RTT, düşen çerçeveler, iptal edilen turlar, yerleşme zamanı.
SLA sağlayıcısı tarafından yapılan uyarılar, raporları uzlaştırın.

Bridge, canlı entegrasyon hayvanat bahçesini yönetilen bir sisteme dönüştürür: tekdüze oranlar, tekdüze hesaplamalar, öngörülebilir UX ve şeffaf akış kalitesi kontrolü. Uygun şekilde tasarlanmış bir köprü ile operatör, yeni canlı sağlayıcıları daha hızlı bağlar, teknolojik riskleri azaltır ve P&L'yi idempotency, katı sınırlar ve net gözlemlenebilirlik ile korur.