Başlarken/Ortamlar & IP allowlist
Ortamlar & IP allowlist
İki ortam vardır: Test (staging) ve Canlı (production). Ortam, çağırdığınız API adresinden belirlenir. Anahtarlar, callback adresleri, IP izin listesi ve webhook’lar her ortam için ayrıdır.
Ortamlar
| Test (staging) | Canlı (production) | |
|---|---|---|
| API adresi (örnek) | https://staging.example.com | https://api.example.com |
| Anahtar öneki | pk_test_ | pk_live_ |
| Cüzdan | Callback’ler Test cüzdan adresinize gider. Test oyuncuları ve test bakiyeleri kullanın. | Callback’ler Canlı cüzdan adresinize gider; gerçek para hareket eder. |
| IP izin listesi | Boşsa serbest, doluysa uygulanır. | Zorunlu. Boş liste tüm istekleri reddeder. |
| Siteler | Test ve Canlı durumdaki siteler oyun açar. | Yalnız Canlı durumdaki siteler oyun açar; diğerleri 403 SITE_DISABLED. |
| Fatura | Faturaya girmez. | Fatura yalnız Canlı verisinden kesilir. |
- Adresler: tablodaki API adresleri örnektir. Hesabınızın Test ve Canlı API adresleri portalda Entegrasyon & API sayfasının üstünde, seçili ortam için gösterilir; portal adresi hesabınız açılırken size iletilir. Örnek kodlarda BOSS_API_URL bu adresi tutar.
- Portal girişi: önce e-posta adresinize gelen tek kullanımlık kodla erişim doğrulaması, sonra Boss Hub e-posta adresiniz, şifreniz ve (açıksa) iki adımlı doğrulama kodu istenir. Üst çubuktaki Test / Canlı seçici, ekrandaki her ayarın hangi ortama yazılacağını belirler.
- Oyun adresi: launch_url API adresinde açılır ve oyuncuyu oyun istemcisine yönlendirir. EGT oyunları play.denovra.com üzerinden yüklenir. Oyunu iframe içinde açıyorsanız iki adrese de CSP frame-src izni verin.
- Callback’leriniz Boss Hub çıkış IP’lerinden gelir; bu adresler portalda IP izin listesi kartındadır.
Ortama özel ve ortak ayarlar
- Ortama özel: API anahtarı ve secret, cüzdan ayarı (callback adresi, lobi ve para yatırma adresi, zaman aşımı), IP izin listesi, webhook uç noktaları, test verileri. Test olayı Canlı adrese gitmez.
- Ortak: siteler ve site ayarları, bahis limitleri, oyun ve sağlayıcı açma kapama kuralları, lobi kategorileri, oyun özellikleri. Bunları Test anahtarıyla değiştirmek Canlı’yı da değiştirir.
- İmza: callback’ler o ortamın imzalama anahtarıyla imzalanır. Test çağrısı Canlı secret ile imzalanmaz.
- Site bazında: bir site için ayrı cüzdan ayarı veya IP kaydı tanımlayabilirsiniz. Site cüzdan ayarı o site için operatör ayarının yerine geçer.
Cüzdan ayarları
| Ayar | Değerler | Not |
|---|---|---|
| Callback base URL | https://staging-api.meridyen.example/bossgaming | /authenticate, /balance, /bet, /win, /rollback bu adrese eklenir. Test dahil yalnız HTTPS kabul edilir; özel ve iç ağ adresleri engellenir. |
| Lobi URL | https://meridyenbet.example/casino | Launch isteğinde lobby_url gönderilmezse kullanılır. |
| Para yatırma URL | https://meridyenbet.example/deposit | Launch isteğinde deposit_url gönderilmezse kullanılır. |
| Desteklenen para birimleri | USD, EUR, TRY | Ayrıntı: Para birimleri & diller. |
| Zaman aşımı | 3 sn (varsayılan), 5 sn | Her deneme için beklenen süre. |
| Tekrar sayısı | 2 (varsayılan), 3 | Bahiste ilk denemeden sonraki tekrarlar. Tüm denemeler en çok 20 sn’lik bütçeye sığmalıdır. |
IP izin listesi
API’ye yalnızca listedeki IP’ler erişir. Portalda IP izin listesi kartına tek adres (198.51.100.10) veya CIDR aralığı (203.0.113.0/24) ekleyin. Liste dışından gelen istek 403 IP_NOT_ALLOWED alır.
- Operatör geneli kayıt bütün anahtarlarınıza uygulanır.
- Site sayfasındaki IP kaydı yalnız o siteye bağlı anahtarlara uygulanır. Operatör geneli anahtarla çağırıyorsanız adresi operatör geneli listeye ekleyin.
Canlı: IP izin listesi zorunludur. Listede en az bir kayıt olmadan production istenemez ve boş liste tüm istekleri reddeder. Canlı’daki son operatör geneli IP silinemez.
Ters yön için de izin gerekir: callback’leriniz Boss Hub çıkış IP’lerinden gelir. Bu adresler aynı kartta gösterilir; güvenlik duvarınıza ekleyin.
Canlıya geçiş
| Adım | Koşul |
|---|---|
| 1. Test anahtarı | Hesabınız açılınca kendiliğinden oluşur; secret ilk görüntülemede bir kez gösterilir. |
| 2. Test cüzdanı | Test ortamında operatör geneli cüzdan ayarını kaydedin (test paketi site ayarını okumaz), Bağlantıyı test et başarılı olsun. |
| 3. Test paketi | Test verilerini girin ve paketi çalıştırın. En son koşunun 42 senaryosunun tamamı GEÇTİ olmalı. |
| 4. Canlı IP | Canlı ortamda en az bir IP ekleyin (operatör geneli veya site). |
| 5. Production iste | Production iste düğmesi 3. ve 4. adımlar tamamsa açılır. Boss Hub şirket belgelerinizi (KYB) kontrol edip onaylar. |
| 6. Onaydan sonra | Canlı anahtar açın, Canlı cüzdan ayarını kaydedin (operatör geneli veya site), webhook’ları ekleyin. |
| 7. Siteyi canlıya al | Site durumunu Canlı yapın. Koşullar: production onayı, siteye bağlı ve yalnız Test’e özel olmayan bir pazar, Canlı IP ve Canlı cüzdan ayarı. |
Onaydan önce Canlı’da yalnız IP izin listesi, siteler, şirket bilgileri ve test işlemleri yazılabilir; anahtar, cüzdan, webhook ve kampanya gibi Canlı yazmaları 403 PRODUCTION_NOT_APPROVED alır.
Bir sağlayıcıyı canlıya almak ayrı bir adımdır: portalda sağlayıcının Canlıya al düğmesi, en son test koşusu (o sağlayıcıya ait veya operatör geneli) tam geçince açılır. Canlı’da yalnız canlıya alınmış sağlayıcıların oyunları açılır.
Siteler
- Sitelerinizi portalda Siteler sayfasından kendiniz eklersiniz; site sayısı sözleşmenizdeki sınırla sınırlıdır. Yeni site Test durumunda başlar.
- API’de site_id, sitenin kodudur (örn. site_mrd01); portalda site ayrıntısında görünür.
- Birden çok siteniz varsa launch, oyun listesi ve öneri isteklerinde site_id gönderin; tek siteniz varsa çıkarılır. Siteye bağlı anahtar yalnız kendi sitesini görür.
- Her site kendi para birimlerini, pazarını ve isterse kendi cüzdan ayarını taşır. Aynı callback adresini paylaşan siteler, callback gövdesindeki site_id ile ayrılır.