1. adım: bir test anahtarı oluşturun

Anahtarları back office'te, Settings altında Integration bölümünde kendiniz oluşturursunuz. Bir hesapta en fazla iki test anahtarı ve en fazla beş canlı anahtar olabilir ve bir anahtarın değeri yalnızca bir kez gösterilir; bu yüzden oluşturduğunuzda saklayın. Bir test anahtarı wgc_test_ ile başlar ve demo oyunları açabilir; bir canlı anahtar yalnızca para karşılığı oyunları açar. Kataloğu okumak canlı anahtarla yapılır; çünkü bir test anahtarının kataloğu yalnızca test oyununu gösterir.

2. adım: test oyununu oynayın

Bir test anahtarı tek bir oyun açar, WGC Test Slot: üç bahis boyutu ve bir Spin düğmesi olan bir sayfa. Her döndürme Callback URL'nize iki gerçek çağrı yapar, önce bir bahis ve ardından bir sonuç; çağrılar "test": true ile ve X-WGC-Test: 1 başlığıyla işaretlenir, böylece işleyiciniz bunları gerçek oyundan ayırt edebilir. Hiç para hareket etmez, komisyon alınmaz ve hiçbir defter kaydı yazılmaz. Test satırları raporların Test sekmesinde görünür. Sınırlar geçerlidir: bir oturum için saniyede iki döndürme ve bir hesap için günde 2.000 döndürme.

3. adım: imzaları ve yanıtları denetleyin

Her cüzdan çağrısı HMAC-SHA256 ile imzalanır. İşleyiciniz imzayı JSON'u ayrıştırmadan önce ham gövde üzerinde doğrulamalı, sabit sürede karşılaştırmalı ve zaman damgası beş dakikadan eski olan bir çağrıyı reddetmelidir. Üç saniye içinde 200 ile 299 arasında bir durumla yanıt vermelidir ve bir ret, durum 200 ile { "ok": false, "error": "insufficient_funds" } olur. Yanlış bir imzayı, eksik bir imzayı ve yavaş bir yanıtı test edin ve işleyicinizin her durumda ne yaptığını not edin. Bu notlar, sonraki bir hatada karşılaştırma yapmanızı ve ekibinize neyin kanıtlandığını göstermenizi kolaylaştırır.

4. adım: hata yolunu test edin

Bir cüzdan entegrasyonu, nasıl başarısız olduğuyla tanımlanır. Test sayfasında yanıtı kaybetme seçeneği vardır. İşlem belirsiz hale gelir ve yaklaşık bir dakika sonra Callback URL'nize unknown_outcome nedenli bir rollback ulaşır. Bunu, işleyicinizin bir bahsi bir kez iptal ettiğini, tekrarlanan bir rollback'in zararsız olduğunu ve hiç kaydetmediğiniz bir bahsin rollback'ini güncel bakiyeyle yanıtladığınızı doğrulamak için kullanın. WGC, kabul edilmeyen bir rollback'i 30 güne kadar tekrarlar; bu yüzden işlem kayıtlarınızın en az o kadar saklanması gerekir.

5. adım: entegrasyon kontrolünü çalıştırın

Back office'te Integration check, kendi hesabınızın gerçek bir oyununu kendi cüzdanınız üzerinden çalıştırır. Başlatmanın ve her getBalance, writeBet ve rollback çağrısının, istek ve yanıtla birlikte canlı bir kaydını ve imzalar için bir sekme gösterir. Bunu bir test oyuncusuyla kullanın. Bir çağrı başarısız olursa kayıt, WGC'nin ne gönderdiğini ve cüzdanınızın ne döndürdüğünü gösterir.

6. adım: entegrasyon testini çalıştırın

Entegrasyon testi, cüzdanınızın 14 kontrolünü çalıştırır ve her biri için bir karar verir: geçti, çalışıyor ama düzeltme önerilir ya da düzeltilmeli; ne değiştirmeniz gerektiğine dair bir ipucuyla birlikte. Kontroller şunları kapsar: bakiye okumaları, yanlış ve eksik imzalar, bakiyeyi düşüren bir bahis, iki kez borçlandırılmaması gereken tekrarlanan bir işlem, bir kazanç, bakiyeden büyük bir bahis, bilinmeyen bir tür, aynı anda gelen iki eşit bahis, rollback'ler ve her yanıtın süresi. Çağrılar bir test bayrağı taşır ve test, cüzdanınızın kabul ettiği işlemleri geri döndürür; bu yüzden onu bir test oyuncusu ya da bir test cüzdanıyla kullanın. Çalıştırmadan sonra oyuncunun bakiyesinin başlangıçtaki değere döndüğünü kontrol edin; döndüyse bu iyi bir işarettir; değilse pencere, bakiyeyi elle kontrol etmenizi söyler.

7. adım: herkese açık örnekleri kullanın

Callback için Node.js, PHP ve Python işleyicileri, wallet-check.mjs adlı bir öz kontrol betiği ve bir canlıya geçiş kontrol listesi herkese açıktır ve giriş gerektirmez. Öz kontrol, uç noktanıza WGC'nin yaptığı gibi imzalı istekler gönderir; bir bahsin tekrarı ve aynı anda iki özdeş bahis de buna dahildir ve sonucu madde madde yazdırır. Test oyuncusunun bakiyesini küçük tutarlarla oynatır ve eski haline getirir; bu yüzden onu yalnızca bir test ortamına karşı, bir test oyuncusu ya da bir test cüzdanıyla çalıştırın. Gerçek oyuncu hesaplarında kullanmayın.

8. adım: gerçek oyunların demo oturumlarını açın

Katalogdan demo bayrağı olan oyunları seçin, ardından onları bir test anahtarıyla demo modunda açın:

POST /v1/sessions   X-API-Key: wgc_test_…   Idempotency-Key: open-0001
{"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" } }

Demo para hareket ettirmez ve bakiye yetersizliği nedeniyle reddedilmez. Demoyu desteklemeyen bir oyun invalid_request yanıtı verir. Başlatma ayrıca bir Idempotency-Key kullanır: aynı anahtar ve aynı gövde 24 saat boyunca aynı yanıtı döndürür; bu yüzden tekrarlanan bir açılışı ayrı bir vaka olarak test edin.

9. adım: küçük bir gerçek başlatma

Bir canlı anahtar, bir test oyuncusu ve küçük bir bahisle para karşılığı bir oyun açın. Gerçek bir başlatma, ticari hesabınızda para olmasını gerektirir: bakiye artı kredi limiti sıfırın üzerinde olmalıdır. Raporlarda, ana görünümdeki Rounds sekmesi bahsi kabul edilmiş olarak göstermelidir. Rounds ya da Games sayfasını göremiyorsanız, yöneticinizden onları açmasını isteyin.

Canlıya geçiş kontrol listesi

Herkese açık kontrol listesi 14 maddedir. Kısaca:

  1. API anahtarı yalnızca sunucunuzda tutulur.
  2. Katalog önce tam, sonra değişikliklerle senkronize edilir; tam senkronizasyon en az günde bir kez yapılır.
  3. Bir oyun sunucunuzdan açılır ve bağlantı oyuncunun tarayıcısında açılır.
  4. Callback URL herkese açıktır ve her yanıt üç saniye içinde gelir.
  5. İmza ve zaman damgasının yaşı ham gövde üzerinde doğrulanır.
  6. getBalance ve writeBet sözleşmenin dediği gibi yanıt verir ve bir ret ok: false içeren bir gövdedir.
  7. writeBet, transactionId başına bir kez kaydedilir ve bilinmeyen bir tür reddedilir.
  8. rollback uygulanmış ve idempotent'tir ya da 404 veya 405 ile yanıt verir.
  9. Bilinmeyen alanlar yok sayılır.
  10. Öz kontrol, test uç noktanıza karşı geçer.
  11. Entegrasyon testi başarısız kontrol göstermez.
  12. Bir demo başlatma ve ardından küçük bir gerçek başlatma çalışır.
  13. Uyarı botu bağlıdır.
  14. İki faktörlü koruma her süper kullanıcı için açıktır.

Test ederken yardım

Back office'teki asistan Ask WGC, kaynaklarla birlikte dokümantasyondan yanıt verir. Entegrasyon yetkisi açıkken, entegrasyon modu kendi entegrasyonunuzun son yedi güne ait sınırlı bir anlık görüntüsünü, sırlar ve istek gövdeleri olmadan okur ve çağrılarınızın neden başarısız olduğunu açıklar. Asistan sizin yerinize hiçbir şey çalıştırmaz; yalnızca yanıt verir. Canlı destek de back office'tedir: ona yazarken istek numarasını, işlem numarasını, tur numarasını ve UTC saatini belirtin. Demo ve test modu, entegrasyon adımları, seamless wallet sözleşmesi, back office ve Casino API genel bakışı sayfalarına bakın.