Dokümantasyon / Oyun Akışı

Oyun API akışı

Oyuncu doğrulama ve oyun başlatmadan bahisler, kazançlar, oyun turları, işlem iptalleri ve finansal mutabakata kadar tam süreç.

Oyun API entegrasyonu

Oturum

oyuncu ve oyun başlatma

Bakiye

bahisler ve kazançlar

Turlar

oyun oturumu akışı

İptal

işlem kurtarma

Oyun yaşam döngüsü

Başlatmadan turun kapanışına

TAM DÖNGÜ

Oyun oturumu oluşturun

Oyuncu, oyun, para birimi, dil, ülke, mod ve dönüş URL'si.

Oyunu başlatın

Geçici erişim anahtarı, başlatma URL'si ve oyun erişilebilirlik kontrolü.

Finansal işlemleri gerçekleştirin

Bakiye kontrolü, bahis, kazanç, birleşik işlem ve platform yanıtları.

Turu kapatın ve mutabakat yapın

Nihai sonuç, iptaller, finansal kayıt ve sağlayıcı raporu.

Genel bakış

Oyun API'si oyuncuyu, turu ve fon hareketlerini birbirine bağlar

Oyun başlatma ve fon hareketleri aynı sürecin farklı parçalarıdır. Oturum oyuncuyu ve başlatma koşullarını tanımlar, tur sağlayıcı eylemlerini ilişkilendirir ve platform API'si her borçlandırma, alacaklandırma ve iptali onaylar.

Oyun oturumu verileri

Oyuncu, marka, oyun, para birimi, ülke, dil, mod, yargı alanı ve erişim süresi.

Bakiye kontrolü

Platform kullanılabilir fonları kontrol eder ve her bahis, ödeme veya iptali yalnızca bir kez uygular.

Oyun finansal kaydı

İşlem ve tur kimlikleri, işlem türü, tutar ve işlem öncesi/sonrası bakiyeler kontrol ve mutabakat için saklanır.

Oyun başlatma

Tipik oyun başlatma akışı

Platform önce oyuncuyu ve oyunun erişilebilirliğini doğrular, ardından süreli bir oturum oluşturur ve sağlayıcıdan başlatma URL'si alır.

Oyuncuyu ve oyun erişilebilirliğini doğrulayın

Platform hesap durumunu, para birimini, ülkeyi, kısıtlamaları, limitleri, gerçek para veya demo modunu ve oyunun erişilebilirliğini kontrol eder.

Dahili oturum oluşturun

Oyuncu, oyun, marka, para birimi, dil, IP ve sona erme bilgileriyle bir oturum kimliği oluşturulur.

Oyun başlatma URL'sini alın

Sağlayıcı oturum anahtarını, bildirim ve dönüş URL'lerini, cihaz türünü, yargı alanını ve arayüz parametrelerini alır.

Oyunu tarayıcıda açın

Oyuncu döndürülen URL'yi açar; sonraki finansal işlemler doğrudan sunucular arasında gerçekleştirilir.

Bakiye işlemleri

Temel bakiye işlemleri

Yöntem adları sağlayıcıya göre değişir ancak mantık aynıdır: bakiye kontrolü, bahis tutarının düşülmesi, kazancın eklenmesi ve önceden onaylanmış işlemin iptali.

Bakiye kontrolü

Finansal kaydı değiştirmeden aktif oturum para birimindeki kullanılabilir oyuncu bakiyesini döndürür.

Bahis tutarını düşme

Oyuncuyu, oturumu, para birimini ve kullanılabilir fonları doğrular, ardından onaylanan bahis tutarını yalnızca bir kez bakiyeden düşer.

Kazancı ekleme

Sıfır sonuç dahil olmak üzere benzersiz işlem ve tur kimliklerini kullanarak kazancı bakiyeye ekler.

Bahis ve sonuç tek istekte

Sağlayıcı bu modeli destekliyorsa bahis ve oyun sonucunu birlikte uygular.

İşlem iptali

Orijinal kaydı silmeden, daha önce onaylanmış bahis veya ödeme için ayrı bir düzeltme işlemi oluşturur.

Bonuslar ve free spinler

Gerçek ve bonus fonlarını ayırarak bonus kampanyası ve oyun turu verilerini iletir.

Para birimi ve tutar hassasiyeti

Her işlem para birimini, tutar birimlerini, ondalık basamakları ve yuvarlama kurallarını doğrular.

Platform yanıtı

İşlem durumunu, dahili kimliği, güncel bakiyeyi ve birleşik hata kodunu döndürür.

Tur yaşam döngüsü

Oyun turu yaşam döngüsü

Bir tur birden fazla bahis ve sonuç içerebilir. Durumu yalnızca ağ isteklerinin sırasına değil, oyun kurallarına göre belirlenir.

Tur oluşturuldu

Platform tur kimliğini ilk kez alır ve dahili kayıt oluşturur.

Tur aktif

Tur ek bahisler, oyun eylemleri ve ara kazançlar içerebilir.

Bahis kabul edildi

Borçlandırma platform tarafından onaylanır ve sağlayıcının benzersiz işlem kimliğiyle ilişkilendirilir.

Sonuç alındı

Kazanç veya sıfır sonuç alınmıştır ancak oyun kurallarına göre tur açık kalabilir.

Tur kapatıldı

Sağlayıcı turun sona erdiğini onaylamış ve beklenen tüm finansal işlemler işlenmiştir.

İşlemler iptal edildi

Tam orijinal geçmiş korunarak bir veya daha fazla işlem düzeltilmiştir.

Bir tur birden fazla işlem içerebilir

Tur kimliği tek idempotency anahtarı olmamalıdır. Her bahis, ödeme ve iptalin kendi benzersiz kimliği bulunmalıdır.

Güvenilirlik ve mutabakat

Yinelenen işlemlere karşı koruma ve finansal mutabakat

Oyun API'si yinelenen istekleri, yanıt gecikmelerini, sıra dışı işlemleri ve hata sonrası sağlayıcı kurtarmasını güvenli şekilde yönetmelidir.

Güvenli tekrar işleme

Sağlayıcı işlem kimliği, her finansal işlem türü için benzersizdir.

Tekrarlanan istek, fonları yeniden hareket ettirmeden ilk sonucu ve güncel bakiyeyi döndürür.

Farklı tutar, para birimi veya oyuncuyla yapılan tekrar veri çakışması olarak reddedilir.

İptal belirli bir orijinal işleme referans verir ve kendisi de benzersiz bir kimlik alır.

Tur kaydı ve mutabakat

Oturum, tur, sağlayıcı işlemi ve platform işlemi kimliklerini saklayın.

İşlem türünü, tutarı, para birimini, işlem öncesi/sonrası bakiyeleri ve işlem süresini kaydedin.

Kaydedilmiş girdileri değiştirmeyin; ayrı bir düzeltme işlemi oluşturun.

Sağlayıcı raporlarını, oyun turlarını, bakiye hareketlerini, GGR'yi ve tespit edilen farkları mutabık hale getirin.

Test

Test ortamında neler test edilmeli

Kontroller; oyun başlatma, oyuncu kısıtlamaları, yetersiz bakiye, yinelenen işlemler, yanıt gecikmeleri, iptaller ve kapanmış tur mutabakatını kapsamalıdır.

Başlatma ve oyun oturumu

Gerçek para ve demo modları, geçersiz para birimi, yasak ülke, süresi dolmuş erişim ve kullanılamayan oyun.

Bakiye ve bahis reddi

Yetersiz fon, engellenmiş oyuncu, para birimi uyuşmazlığı ve aşılmış limit.

Gecikme ve bilinmeyen sonuç

Gerçekte bakiye düşülmüş olmasına rağmen sağlayıcı yanıt alamaz ve aynı kimlikle işlemi yeniden gönderir.

Yinelenen bahisler ve kazançlar

Aynı kimlik, işlem tamamlanmadan önce veya sonra, çelişkili parametreler dahil tekrar gelir.

İşlem iptalleri

Bahis iptali, kazanç iptali, yinelenen iptal ve bilinmeyen orijinal işleme referans.

Tur mutabakatı

Bahis, kazanç ve iptal tutarları, nihai durum, bakiye hareketi ve sağlayıcı raporu eşleşmelidir.

Lansman öncesi kontrol listesi

Lansman; oyun oturumları, bakiye işlemleri, yinelenen işlemlere karşı koruma, iptaller ve raporlama doğrulandıktan sonra yapılır.

Test ve canlı ortamlar farklı erişim bilgileri, API endpoint'leri ve başlatma ayarları kullanır.

Oyun oturumu anahtarı süreyle sınırlıdır ve oyuncu, oyun, para birimi ve markayla ilişkilidir.

Her bakiye işlemi benzersiz bir sağlayıcı kimliğiyle korunur.

Yinelenen bahisler, kazançlar ve iptaller bakiyeyi ikinci kez değiştirmez.

Kaydedilmiş girdiler silinmez; ayrı düzeltme işlemleriyle düzeltilir.

Olay günlükleri, uyarılar, sağlayıcı raporları ve tur mutabakat süreci yapılandırılmıştır.

Test bölümünü görüntüle