Casino platformları için seamless wallet entegrasyonu

Seamless wallet modelinde oyuncunun parası casino tarafında kalır. WGC oyuncu cüzdanlarını saklamaz: bir oyunun bakiyeye ihtiyacı olduğunda veya bir bahsi kaydetmesi gerektiğinde WGC platformunuza imzalı bir istek gönderir ve yanıtınızı kullanır. Bu sayfa, sözleşmeyi işleyiciyi yazan ekip için pratik terimlerle anlatır: önce modeli, sonra imza ve zaman aşımı kurallarını, en sonunda da test araçlarını bulacaksınız.

Model nasıl çalışır

Oyuncular ve bakiyeler platformunuzda yaşar. WGC, kaydettiğiniz Callback URL'ye POST istekleri yapar ve üç komut kullanır: bakiyeyi okumak için getBalance, bir bahsi ve kazancını kaydetmek için writeBet, bir bahsi iptal etmek için rollback. Tek istisna, WGC personelinin oluşturduğu ve WGC'nin test cüzdanını kullanan bir demo müşteridir.

writeBet bir bahsi ve kazancını tek çağrıda taşır. Bir stüdyo bahsi ve sonucu ayrı bildirdiğinde WGC bunları bir tur kimliğiyle tek bir turda birleştirir ve iki çağrı da bu turun içinde taşınır. İşlem türü play, refund veya jackpotlar açıksa jackpot olur; tur bitti bayrağı turun sonunu işaretler.

Idempotency sözleşmenin parçasıdır

İşleyiciniz writeBet çağrısını her transactionId için yalnızca bir kez kaydetmelidir. Tekrarlanan bir çağrı oyuncunun hesabından iki kez düşmemeli ve aynı bakiyeyi döndürmelidir. Bu, isteğe bağlı bir ek değil, entegrasyonun koşuludur; çünkü ağ hataları tekrarları olağan hale getirir ve aynı işlemin ikinci kez gelmesi sıradan bir durumdur.

İmzalar

Her çağrı HMAC-SHA256 ile ve hesap sırrınızla imzalanır. İki başlık mevcuttur: gövde üzerinden bir imza ve zaman damgasıyla birleştirilmiş gövde üzerinden ikinci bir imza, zaman damgasının kendisiyle birlikte. Yeni bir entegrasyon ikinciyi doğrulamalıdır. İmzayı JSON'u ayrıştırmadan önce ham gövde üzerinde kontrol edin, karşılaştırmayı sabit sürede yapın ve beş dakikadan eski çağrıları reddedin. Dokümantasyon, test sırrıyla hazırlanmış imza örnekleri içerir; böylece kendi doğrulama kodunuzu bu örneklerle karşılaştırabilirsiniz. Ayrıca güvenlik sayfasına bakın.

Zaman aşımları, tekrarlar ve rollback

WGC yanıtınız için üç saniye bekler. Yanıt yalnızca 2xx durumuyla sayılır. Ret, gövdede ifade edilir; örneğin yetersiz bakiye hatası ve 200 durumuyla. Yönlendirmeler izlenmez. Zamanında yanıt yoksa bahis stüdyoya reddedilir, işlem bilinmeyen olur ve bir rollback gelir.

Rollback, bir bahsin tamamını iptal etmenizi ister: bahsi iade edin ve kazancı geri alın. WGC bunu yaklaşık bir dakika sonra, sonra 5, 15, 60, 360 ve 1.440 dakika sonra, ardından bahisten itibaren en fazla 30 gün boyunca günlük olarak tekrarlar. Platformunuz işlem kayıtlarını en az 30 gün saklar. Rollback komutunu desteklemek sizin için isteğe bağlıdır; bu komuta verilen bulunamadı veya izin verilmedi yanıtı da bir hata sayılmaz.

Bilmeye değer başka sınırlar da vardır. WGC içinde bir buçuk saniyeden uzun beklemiş bir bahis size gönderilmez ve oyuncunun hesabından hiçbir şey düşülmez. Tek bir işlem, tur kurunda en fazla bir milyon USD olabilir.

Callback adresi

Mümkünse herkese açık bir https:// adresi kullanın. Özel ve loopback adresleri kaydederken reddedilir, yalnızca 443 ve 80 portları kullanılır ve yanıtınız 64 KB'ı aşmamalıdır. WGC'nin kendi çağrılarının yapıldığı adresler size önceden bildirilir ve bu adresler değişmeden önce uyarılırsınız.

İşleyicinizi kontrol edin

Örnekler ve kendi kendine kontrol herkese açıktır ve oturum açmayı gerektirmez: Node.js, PHP ve Python için işleyiciler, bir kontrol betiği ve 14 maddelik bir canlıya geçiş kontrol listesi. Back office'te entegrasyon testi cüzdanınızın 14 kontrolünü çalıştırır ve neyi düzeltmeniz gerektiğini söyler; entegrasyon kontrolü ise her çağrının istek ve yanıtıyla canlı bir kaydını gösterir.

Test modunda yanıtı kaybetme seçeneği vardır ve bu, rollback'inizi kontrol eder: işlem bilinmeyen olur ve bir dakika sonra bir rollback gelir. Demo ve test modu ile entegrasyon adımları sayfalarında daha fazlasını okuyun.

Turdan sonra

Turdan sonra da platformunuz bir işlemi, bir turu veya bir oturumu kendi numaralarıyla sorgulayabilir. Bir işlemin durumu kabul edildi, reddedildi, başarısız veya bilinmeyen olabilir. WGC raporlar için durumu, yanıt süresini ve yanıtınızın ilk 1.024 karakterini saklar. Casino API, oyun agregatörü genel bakışı ve seamless wallet yazısına göz atın.

SSS

WGC oyuncu bakiyelerini tutar mı?

Hayır. Bakiyeler platformunuzda kalır; WGC Callback URL'nize çağrı yapar.

Sunucum yavaşsa ne olur?

Üç saniye sonra bahis stüdyoya reddedilir ve daha sonra bir rollback ile iptal edilir.

Rollback komutu zorunlu mu?

Hayır. İşleyiciniz bu komutu desteklemek zorunda değildir; destek isteğe bağlıdır.

İşleyiciyi nasıl test ederim?

Herkese açık örnekleri, kendi kendine kontrol betiğini ve test modunu kullanın; back office'teki entegrasyon testi de neyi düzeltmeniz gerektiğini söyler.

Cüzdanınızı bağlamaya hazır mısınız? Entegrasyonu görüşelim.

Bir sonraki bağlantınız
burada başlar.

Ne kurduğunuzu anlatın. Gerisini biz üstlenelim.

Görüşelim