Kim kimi çağırır

İki yön vardır. Sunucunuz, bir oyunu açmak ve bir işlemin başına ne geldiğine bakmak için WGC'yi çağırır. WGC ise oyuncunun bakiyesi ile her bahis ve kazanç için Callback URL'nizi çağırır; çünkü seamless wallet modelinde oyuncunun parası casino'nuzda kalır ve WGC bir oyuncu bakiyesi tutmaz. Cüzdan çağrıları üç komuttan oluşur: getBalance, writeBet ve rollback. Yönü net tutmak, turun büyük kısmını açıklar: ilk adımı başlatmak sizin işinizdir, ikiden dörde kadar olan adımlarda WGC size sorar, son adımda ise siz WGC'ye sorarsınız. Bir tur sırasında bir şey ters giderse, önce hangi yönde hangi çağrının eksik kaldığına bakmak sorunu daraltır.

1. adım: başlatma

Sunucunuz POST /v1/sessions çağrısını bir oyuncu numarası, bir para birimi, bir mod ve tek bir oyun numarasıyla yapar. Yanıt bir başlatma bağlantısı ve bir oturum numarası taşır.

POST /v1/sessions
{"publicId":"sweet-bonanza-1","playerId":"casino-side-player-42","currency":"USD","mode":"demo","language":"en"}
→ 200 { "ok": true, "requestId": "req_…", "data": { "url": "https://play.worldgamingconnect.com/play/Zk3p9xQ2vL8mTn4r", "sessionId": "cmgq3r8v40001l8xyz5k2abcd", "expiresAt": "2026-10-12T10:45:00.000Z" } }

Oyuncu numarası 1 ile 64 arasında yazdırılabilir ASCII karakterdir ve kendi sisteminizdeki bir oyuncuyu adlandırır. Bağlantı oyuncunun tarayıcısında açılır; sunucunuzdan çağrılmaz. Hiçbir tarayıcının açmadığı bir bağlantı 5 dakika çalışır; açıldıktan sonra oyuncu oynadığı sürece yaşar. Bu adımda siz hiçbir şeyi yanıtlamazsınız; çağrıyı yapan sizsiniz ve yanıtı doğrudan alırsınız. Oyuncuyu casino'nuzun lobisinden başlatmak da bu adımın bir parçasıdır.

2. adım: bakiye

Oyun başladığında oyuncunun bakiyesini ister ve WGC, Callback URL'nize getBalance gönderir.

{ "command": "getBalance", "playerId": "casino-side-player-42", "currency": "USD", "requestId": "req_…", "timestamp": "2026-10-12T10:15:00.500Z" }
← { "ok": true, "balance": 123.45, "currency": "USD" }

Her çağrı imzalıdır ve imzayı gövdeyi ayrıştırmadan önce ham gövde üzerinde denetlersiniz. Bir ret gövdede yazılır; örneğin { "ok": false, "error": "insufficient_funds" } ve durum 200 ile. Bakiye yanıtı, oyunun oyuncuya hangi bakiyeyi göstereceğini belirler; bu yüzden değerin kendi sisteminizdeki güncel bakiye olması gerekir.

3. adım: bahis

Oyuncu döndür düğmesine basar ve WGC, sıfırdan büyük bir bahis ile sıfır bir kazançla writeBet gönderir. Çağrı yeni bir transactionId ve bir roundId taşır.

{ "command": "writeBet", "playerId": "casino-side-player-42", "currency": "USD", "bet": 1.00, "win": 0.00, "roundId": "3f1c2a64-8d0b-4e57-9b7a-5c2e1d0f9a41", "gamePublicId": "sweet-bonanza-1", "transactionId": "5f0b1c2e-7a64-4d6e-9a3b-0c1d2e3f4a5b", "kind": "play", "requestId": "req_…", "timestamp": "2026-10-12T10:15:01.000Z" }
← { "ok": true, "balance": 122.45 }

Oyuncuyu o transactionId için bir kez borçlandırır ve yeni bakiyeyle yanıtlarsınız. Reddederseniz hiçbir şey borçlandırılmaz ve tur ilerlemez. Bu adımdaki işlem numarası, sonraki tekrarları ve olası bir rollback'i tanımanın anahtarıdır; bu yüzden kayıtlarınızda saklayın. kind değeri play ya da refund olur; jackpot ise yalnızca yöneticiniz hesabınız için jackpot'ları açtıktan sonra gelir.

4. adım: sonuç

Sonuç, aynı roundId ile başka bir writeBet olarak gelir: yeni bir transactionId, sıfır bir bahis ve ödeme olan bir kazanç.

{ "command": "writeBet", "playerId": "casino-side-player-42", "currency": "USD", "bet": 0.00, "win": 2.50, "roundId": "3f1c2a64-8d0b-4e57-9b7a-5c2e1d0f9a41", "gamePublicId": "sweet-bonanza-1", "transactionId": "9a1d7c33-52b8-4f0e-8c64-2d7e0b5a1f93", "kind": "play", "requestId": "req_…", "timestamp": "2026-10-12T10:15:02.000Z", "roundFinished": true }
← { "ok": true, "balance": 124.95 }

Bazı oyunlar bahsi ve sonucu tek çağrıda gönderir. Diğerleri bunları ayrı gönderir ve WGC onları tek bir turda birleştirir; böylece iki çağrı da tek bir roundId altında ilerler. roundFinished: true turun bittiğini belirtir; bu anahtar gelmezse turu hâlâ açık sayarsınız. Kazancı, her işlem numarası için yalnızca bir kez hesaba yazarsınız ve yeni bakiyeyle yanıtlarsınız.

5. adım: zamanında yanıt yok

WGC yanıtınız için 3 saniye bekler ve bir yanıt yalnızca 2xx durumuyla sayılır. Yanıt zamanında gelmezse ya da okunamazsa bahis oyun sağlayıcısına reddedilir ve işlem unknown olur: WGC onu kaydedip kaydetmediğinizi bilmez. Bu aşamada sizden henüz bir şey istenmez. WGC'nin içinde iki daha kısa süre çalışır: Callback'inizden önce 1,5 saniyeden uzun bekleyen bir bahis size gönderilmez ve oyuncudan hiçbir şey alınmaz; kabul ettiğiniz, ancak yanıtı 4,5 saniye içinde oyun sağlayıcısına ulaşamayan bir bahis ise hemen rollback ile iptal edilir.

6. adım: rollback

Belirsiz bir sonuçtan sonra WGC, aynı adrese aynı transactionId ile rollback gönderir.

{ "command": "rollback", "transactionId": "5f0b1c2e-7a64-4d6e-9a3b-0c1d2e3f4a5b", "playerId": "casino-side-player-42", "currency": "USD", "bet": 1.00, "win": 0.00, "reason": "unknown_outcome", "requestId": "rb:5f0b1c2e-7a64-4d6e-9a3b-0c1d2e3f4a5b:1", "timestamp": "2026-10-12T10:16:01.000Z" }
← 200 { "balance": 123.45 }

O transactionId'yi kaydettiyseniz onu tümüyle geri alırsınız: bahis geri döner ve kazanç geri alınır. Hiç kaydetmediyseniz hiçbir şeyi değiştirmez ve yine de bakiyeyle yanıtlarsınız. Neden, yanıtınız WGC'ye hiç ulaşmadığında unknown_outcome olur; yerleşmiş bir işlemi iptal eden bir oyun sağlayıcısının kendi nedeni vardır. WGC, kabul edilmeyen bir rollback'i tekrarlar: eksik yanıttan yaklaşık bir dakika sonra, ardından 5, 15, 60, 360 ve 1.440 dakika sonra, sonra da bahisten itibaren 30 gün geçene kadar günde bir kez. Bu yüzden işlem kayıtlarınızı en az 30 gün saklayın. Bir casino ayrıca rollback'i uygulamadığını belirtmek için 404, 405 ya da unknown_command ile yanıt verebilir ve bu bir hata sayılmaz. Rollback'in ayrıntıları ve tekrarların güvenle nasıl karşılanacağı için cüzdanda idempotency ve tekrarlar yazısına bakın.

7. adım: mutabakat

Sunucunuz istediği zaman, casino'nuzun gördüğü numaraları kullanarak WGC'ye neyi kaydettiğini sorabilir.

GET /v1/rounds/3f1c2a64-8d0b-4e57-9b7a-5c2e1d0f9a41
→ 200 { "ok": true, "requestId": "req_…", "data": { "roundId": "3f1c2a64-…", "status": "closed", "bet": "1.00", "win": "0.00", "ggr": "1.00", "transactions": [ { "transactionId": "5f0b1c2e-…", "status": "accepted", "balance": "122.45", … } ], "actions": ["bet","no_win"], … } }

Bir işlemin durumu accepted, refused, failed ya da unknown olur; bir tur ayrıca bahis eksi kazanç olan ggr değerini gösterir. actions listesi, olanı WGC'nin kendi sözcükleriyle anlatır; örneğin bet, win, no_win ya da rollback. Tanımadığınız bir kodu bilgi olarak okuyun ve para kararını ona bağlamayın. Sorgular 65 gün geriye gider; daha eski olaylar WGC arşivindedir ve talep üzerine elle aranır. Başka bir hesabın numarası, hiç var olmayan bir numara gibi görünür.

Turu parasız prova edin

Bir test anahtarı, WGC Test Slot adlı bir test oyunu açar; her döndürme, Callback URL'nize "test": true işaretli iki gerçek çağrı yapar: bir bahis ve ardından bir sonuç. Hiçbir para hareket etmez. Yanıtı kaybetme seçeneği rollback'inizi sınar: işlem unknown olur ve yaklaşık bir dakika sonra bir rollback gelir. Back office'te Integration check her çağrıyı canlı gösterir ve entegrasyon testi cüzdanınızın 14 kontrolünü çalıştırır. Demo ve test modu, entegrasyon adımları ve Casino API genel bakışı sayfalarına bakın.