Bakiyenin sahibiyle başlayın
WGC'nin kullandığı callback cüzdan modelinde oyuncu cüzdanını casino platformu tutar. WGC, bir bakiye ya da bir oyun işleminin sonucu için platformunuzu çağırır. WGC oyuncu cüzdanlarını saklamaz; tek istisna, WGC personeli tarafından oluşturulan ve test cüzdanı kullanan bir demo müşteridir.
Oyuncu referansı, bir oyuncuyu casino'nun kendi sisteminde tanımlar ve 1 ile 64 arasında yazdırılabilir ASCII karakterden oluşan bir dizedir. WGC'ye erişmek için kullanılan ticari hesap değildir. Bu sınırı en başta netleştirin; böylece bir istek başarısız olduğunda ya da bir tutar tartışıldığında hangi sistemin esas alınacağını iki ekip de bilir. Böyle bir anlaşma yoksa her uyuşmazlık, iki ekibin kayıtlarını baştan karşılaştırmak anlamına gelir.
Bir işlemi sistemler boyunca izleyin
Tipik bir entegrasyon, bir bakiye sorgusuna ve bir bahsi ile sonucunu kaydetmenin bir yoluna ihtiyaç duyar. WGC callback sözleşmesi üç komut adlandırır: bakiyeyi okumak için getBalance, bir bahsi kazancıyla birlikte tek istekte kaydetmek için writeBet ve bir bahsi iptal etmek için rollback. Bir stüdyo bahsi ve sonucu ayrı gönderdiğinde, WGC bunları bir tur numarasıyla tek bir turda birleştirir ve iki çağrı da bu turun içinde ilerler.
Oyuncu, para birimi, oyun, tur ve işlem referanslarını kayıtlarınızda bir arada tutun. Bir başlatma bağlantısı, bir oyuna yalnızca giriş noktasıdır; bir bakiye sorgusunun ya da bir hesaplaşmanın tamamlandığını doğrulamaz. Bu yüzden destek taleplerinde yalnızca başlatma bağlantısına değil, işlem ve tur numaralarına dayanın.
Yeniden denemeyi aynı işlem olarak ele alın
Bir ağ zaman aşımı, bir işlem kabul edildikten sonra, ancak yanıt çağıranın eline geçmeden önce olabilir. Bu işlemi körlemesine tekrarlamak, oyuncuyu iki kez borçlandırabilir. Idempotent bir işleyici aynı işlem numarasını tanır ve tutarları yeniden uygulamak yerine kaydedilmiş sonucu döndürür. WGC'de bu, entegrasyonun bir koşuludur: writeBet işlem numarası başına bir kez kaydedilir ve tekrarlanan bir çağrı aynı bakiyeyi döndürür.
Zaman aşımlarının da kuralları vardır. WGC yanıtınız için üç saniye bekler ve bir yanıt yalnızca 2xx durumuyla sayılır. Yanıt zamanında gelmezse bahis stüdyoya reddedilir, işlem belirsiz hale gelir ve bir rollback izler. Rollback, 30 güne kadar bir takvimle tekrarlanır; bu yüzden işlem kayıtlarınızı en az o kadar saklayın.
Kabul testlerinize eşzamanlı tekrarları, geciken yanıtları ve bir zaman aşımından sonraki yeniden denemeyi ekleyin. Bir oturum açma isteğinin yeniden denenmesi ayrı bir sözleşmedir; cüzdanın aynı şekilde çalıştığını varsaymayın. İki sözleşmeyi testlerinizde ayrı senaryolar olarak ele almak, hataların kaynağını bulmayı kolaylaştırır.
Para birimini ve tutarları açık yazın
Bir oyuncu cüzdanı, operatörün ticari hesabından farklı bir para birimi kullanabilir. Her işlemin para birimini belirtmesi ve kararlaştırılan hassasiyet kurallarına uyması gerekir. Bir tutar bir sayıdır ya da nokta kullanan bir dizedir ve tek bir işlem, turun kuruyla en fazla bir milyon USD olabilir.
WGC ile ticari bakiye USD cinsinden tutulur ve oyuncunun harcayabileceği bakiye değildir. Birini diğerinden türetmeyin. Bir back office'te görünen bir para biriminin her oyun tarafından desteklendiğini de varsaymayın: bir para biriminde açılmayan oyun katalogda işaretlenir. Test etmeden önce amaçlanan kombinasyonları teyit edin; böylece testte görünen bir ret, bir cüzdan hatasından çok bir kombinasyon sınırı olabilir.
Başarılı oyunun yanı sıra hataları da test edin
En önemli durumlar için kontroller hazırlayın:
- Yetersiz bakiye. Bir ret gövdede yazılır; örneğin yetersiz bakiye hatası ve 200 durumuyla.
- Bilinmeyen bir oyuncu ya da desteklenmeyen bir para birimi.
- Geçersiz bir imza. Her çağrı HMAC-SHA256 ile imzalanır; imzayı ham gövde üzerinde kontrol edin, sabit sürede karşılaştırın ve beş dakikadan eski çağrıları reddedin.
- Geciken bir yanıt ve tekrarlanan bir teslimat.
İşlem referansını ve bir destek istek numarasını kendi kayıtlarınızda tutun ve yalnızca son bakiyeleri değil, kabul edilen işlemleri iki tarafta da karşılaştırın.
Bir kuru çalıştırma bir mesajın biçimini doğrulayabilir; ancak gerçek bir stüdyo ile cüzdanınızın birlikte doğru hesaplaştığını kanıtlayamaz. Prova için bir test anahtarı, para olmadan Callback URL'nize gerçek çağrılar yapan bir test oyunu açar ve yanıtı kaybetme seçeneği rollback'inizi sınar. Back office'te entegrasyon kontrolü her çağrının canlı bir kaydını gösterir ve entegrasyon testi cüzdanınızın 14 kontrolünü çalıştırır.
Her bağlantının hazır oluşunu teyit edin
WGC, bu işe hazırlanmak için bir callback sözleşmesi ve bir test aracı sunar ve cüzdan Callback'i çalışır. Node.js, PHP ve Python için işleyici örnekleri ve 14 maddelik bir canlıya geçiş kontrol listesi herkese açıktır. Her bağlantının hazır oluşu yine de proje bazında teyit edilir: desteklenen akışı, hata politikasını ve kabul ölçütlerini entegrasyon ekibiyle görüşün. Erişim ayrıntılarını yöneticiniz doğrudan verir; bu bilgiler herkese açık sayfalarda yer almaz.
Sözleşmenin tamamı için seamless wallet sayfasını, çevresindeki adımlar için entegrasyon sayfasını, demo ve test modunu ve Casino API genel bakışını okuyun.