Sağlayıcı API/Jackpot havuzları

Jackpot havuzları

API · Operatör → Boss Hub

GET/v1/jackpots

Bağlı olduğunuz jackpot havuzlarını ve seviyelerin güncel tutarlarını döndürür; lobide jackpot sayacı göstermek için kullanın. Düşüş geçmişi GET /v1/jackpots/{pool_id}/wins ile gelir. jackpot modülü, havuzlar için games.read, düşüşler için rounds.read kapsamı gerekir.

Başlıklar

Başlık	Açıklama
X-Operator-Id	Operatör kimliğiniz
X-Timestamp	Unix saniye. ±30 sn dışı reddedilir
X-Signature	hex(HMAC_SHA256(secret, ts + "." + METHOD + "." + path?query + "." + body))
X-Api-Key	İsteğe bağlı. Birden çok anahtarınız varsa doğru secret’ı seçer

Sorgu parametreleri

site_idstring

Site kodu, örn. site_mrd01. Verilirse yalnız bu sitenin katıldığı havuzlar; site anahtarında kendi sitesi.

currencyISO 4217

USD, EUR, TRY. Verilirse tutarlar güncel kurla bu birime çevrilir ve 2 haneye aşağı yuvarlanır; kur yoksa havuzun para biriminde kalır ve yanıttaki currency bunu söyler. Verilmezse havuzun para birimi.

Ortam: Test anahtarı yalnız Test havuzlarını, Canlı anahtar yalnız Canlı havuzları görür. Yalnız etkin havuzlar listelenir. Boss Hub havuzunda tutar bakiye defterinden gelir ve birkaç saniye geriden gelebilir; sağlayıcının yürüttüğü havuzda sağlayıcının anlık tutarıdır.

EGT jackpot kaynağı: EGT oyunlarında her site, Test ve Canlı için ayrı ayrı, ya EGT’nin kendi oyun içi jackpot’larını ya da Boss Hub havuzlarını kullanır; seçim portalda yapılır ve iki ortam birbirini etkilemez. EGT’nin kendi jackpot’ları bu listede yer almaz, /wins ve jackpot.won webhook’unda görünmez; ödendiğinde win çağrısıyla gelir ve jackpot.pool_id EGT’nin bağlantı kodudur. Bugünkü durum için aşağıdaki EGT jackpot durumu bölümüne bakın.

GET /v1/jackpots?site_id=site_mrd01&currency=USD HTTP/1.1
Host: staging.example.com
X-Operator-Id: op_meridyen
X-Timestamp: 1762344000
X-Signature: 9a31c7…e2b4

200Havuzlar

[
  {
    "id": "pool_mrd_bell",
    "type": "private",
    "name": "Meridyen Mega Pool",
    "currency": "USD",
    "levels": [
      { "level": "grand", "amount": 8319.44, "seed": 5846.00, "must_drop_amount": 14615.00 },
      { "level": "major", "amount": 1032.87, "seed": 584.60, "must_drop_amount": null },
      { "level": "minor", "amount": 104.21, "seed": 58.46, "must_drop_amount": null },
      { "level": "mini", "amount": 29.23, "seed": 29.23, "must_drop_amount": null }
    ]
  }
]

EGT jackpot durumu

EGT oyunlarında jackpot ödemesi şu an kapalı: EGT’nin kendi jackpot’unun Grand veya Major seviyesi (ve tek seviyeli ağlar) vurduğunda tutar 0 yatırılır: jackpot alanı dolu bir win gelmez, dönüşün kendi kazancı normal ödenir ve tur normal kapanır. Oyunda bu seviyeler 0 görünür. Portalın tur geçmişinde böyle bir tur “Sağlayıcı jackpotu yatırılmadı — site kuralı” rozetini taşır; /v1/rounds yanıtında bu bilgi yoktur.

EGT’ye bağlı Boss Hub havuzları: EGT oyunlarındaki bahisler havuza katkı yazar, ama bu havuzlar EGT oyunlarında şu an düşmez. Bu havuzlarda amount, başlangıç tutarının (seed) üstüne bugüne kadar toplanan katkıdır; ödenip sıfırlanan bir düşüş sayacı değildir. /wins listesi ve jackpot.won webhook’u bu havuzlar için boş kalır.
Lobi: Bu not kalkana kadar EGT oyunlarının jackpot tutarlarını “kazanılabilir” sayaç olarak göstermeyin.

Havuz alanları

Alan	Tür	Açıklama
id	string	Havuz kimliği.
type	string	private kendi havuzunuz, shared ortak ağ havuzu.
name	string	Havuz adı.
currency	ISO 4217	Tutarların para birimi: currency verildiyse o, yoksa havuzun birimi.
levels	object[]	Seviyeler, sağlayıcı şemasının sırasıyla.

Seviye alanları

Alan	Tür	Açıklama
level	string	Seviye kodu, örn. grand. Kodlar sağlayıcının jackpot şemasından gelir, sabit liste değildir.
amount	decimal(18,2)	Güncel tutar. Sabit tutarlı seviyede sabit tutardır.
seed	decimal(18,2)	Başlangıç: düşüşten sonra seviye bu tutardan yeniden başlar.
must_drop_amount	decimal(18,2) \| null	Kesin düşme tavanı. Tavan yoksa, sabit seviyede veya havuzu sağlayıcı işletiyorsa null.

Kesin düşme tavanı

Tavanı olan seviye, katkıyla must_drop_amount tutarına ulaştığı ilk uygun bahiste düşer; düşüş olasılığı bu tutardan önce de çalışır. Ödeme tavanı aşmaz: aynı anda gelen bahislerle seviye tavanı biraz geçerse aşan kısım yeni döneme kalır. Aynı anda tavanı geçen iki bahiste tek kazanan olur. Tavanı Boss Hub ayarlar; lobide "en geç şu tutarda düşer" bilgisini bu alandan gösterebilirsiniz. Kazanç her düşüşte olduğu gibi win ile, jackpot alanı dolu gelir.

Düşüş geçmişi

GET /v1/jackpots/{pool_id}/wins havuzdaki kendi düşüşlerinizin en yeni 500’ünü yeniden eskiye döndürür; sayfalama yoktur, aralığı from (dahil) ve to (hariç) ile daraltın. Ortak havuzda başka operatörün düşüşü görünmez, iptal edilen düşüş listelenmez; henüz ödenmemiş düşüş de listelenir, status ile ayırın. Sorgu: site_id, from, to. Satır: pool_id, level, amount (ödenen tutar, ödeme biriminde), currency (ödeme birimi), site_id, player_id, round_id, won_at, status, paid.

status	paid	Anlam
pending	false	Düşüş kaydedildi; kazanç win çağrısı cüzdanınıza henüz ulaşmadı (gönderiliyor, tekrar ediliyor ya da onay bekliyor). Kazanan duyurusunu ödeme gelince yapın
paid	true	Cüzdanınız kazancı kabul etti
failed	false	Ödeme kesinleşmedi: cüzdanınız reddetti ya da yanıtı belirsiz kaldı ve tekrarlar bitti (kazanç cüzdanınıza geçmiş olabilir). Elle ödemeyin; tur takılı tur olarak çözülür, çözülünce paid olur ya da düşüş iptal edilip listeden çıkar

GET /v1/jackpots/pool_mrd_bell/wins?from=2026-11-01T00:00:00Z HTTP/1.1
Host: staging.example.com
X-Operator-Id: op_meridyen
X-Timestamp: 1762344100
X-Signature: 47d0b2…91ac

Hata kodları

Kod	HTTP	Anlam
INVALID_SIGNATURE	401	İmza doğrulanamadı
TIMESTAMP_SKEW	401	X-Timestamp ±30 sn dışında
IP_NOT_ALLOWED	403	IP izin listesinde değil
SCOPE_MISSING	403	games.read veya düşüşler için rounds.read kapsamı yok
SCOPE_DENIED	403	site_id sizin değil veya anahtarınızın kapsamı dışında
MODULE_DISABLED	403	jackpot modülü kapalı
NOT_FOUND	404	Düşüşler: havuz yok veya bağlı değilsiniz
VALIDATION_ERROR	422	Geçersiz sorgu parametresi
RATE_LIMITED	429	Hız limiti aşıldı

← ÖncekiFree round kampanyaları Sonraki →GGR raporları