Oyuncu Yönetimi ve Casino Operasyonları

Tekrarlanan Callback ve API İsteklerini Yönetmek

Bir API istemcisi isteği gönderip zaman aşımına uğradığında ilk işlemin kaydedilip kaydedilmediğini bilmeden yeniden deneyebilir. Oyun agregatörü veya olay kuyruğu da aynı callback mesajını tekrar iletebilir. Casino platformu bu teslimleri yeni bahis, kazanç, iptal veya ödül gibi işlerse finansal defterde gerçek tutarsızlıklar ortaya çıkar. Mesajın teslimini ticari işlemden ayırmak ve her parasal etkinin operatör defterine yalnızca bir kez yazılmasını sağlamak gerekir. Sağlayıcıların işlem kimlikleri, yinelenen mesajlara verdiği yanıtlar ve tekrar kuralları farklıdır; evrensel bir callback sözleşmesi yoktur. Bu rehber, kimlik doğrulamalı kabul, atomik kayıt, güvenli yanıt, sırası değişen olaylar, mutabakat ve uçtan uca testlere odaklanır. [1] [2] [4]

Tekrarlanan dijital olay paketleri güvenli bir işlem geçidinden geçerek tek bir onaylı kayıt oluşturuyor
Bir mesaj tekrar iletilebilir; aynı finansal işlem ikinci kez uygulanmamalıdır.
İçindekiler

Aynı callback neden birden çok kez gelir?

Alıcı işlemi tamamlamış olsa bile gönderici HTTP yanıtını kaybedebilir. Böylece istek yeniden denenir ya da onayı kayıt altına alınmayan olay tekrar teslim edilir. At-least-once mesaj tesliminde bu durum beklenir; varsayılan olarak mesaj sırası da garanti edilmez. Yinelenen teslim tek başına saldırı veya ikinci ticari işlem anlamına gelmez. [4] [5]

Casino cüzdanında tek bir borç, alacak veya ters kayıt sadece ikinci bildirim geldi diye tekrar işlenmemelidir. Ticari etki, callback teslimi ve HTTP yanıtı farklı yaşam döngüleridir. St8 ve 7SoftTech tekrarları işlem ID'leriyle tanımlar; ancak yanıt kodları ve uç durumları farklı olabilir. [1] [2]

Idempotency anahtarı hangi kimliklerden oluşur?

Mesaj teslim ID'sini, doğrulanmış sağlayıcıyı, ticari işlem ID'sini, işlem türünü, iptal edilen ana işlemi ve oyun turunu birbirinden ayırın. Çift finansal kaydı önleyen anahtar, sözleşmede belirlenen ticari kimlik olmalıdır. Aynı numara farklı sağlayıcı veya operatörlerde bulunabileceğinden benzersizlik kapsamı doğrulanmalıdır. [1] [2] [3]

KimlikAmaçKontrol kuralı
Sağlayıcı / tenantKimlik alanını belirlerKaynağı doğrula
İşlem IDPara hareketini tanımlarSözleşmeye göre benzersiz
İşlem türüBorç, alacak, iptalAPI modelini izle
Olay / teslim IDTek bildirimi tanımlarHer zaman cüzdan anahtarı değil
Önceki işlem IDİptal bağlantısıReferansı kontrol et
Tur ve oyuncu IDİşlem bağlamıİşlem ID yerine geçmez

Anahtarla birlikte sabit bir istek özeti ve işlenme durumunu koruyun. Aynı ID başka tutar, para birimi veya oyuncuyla gelirse bu yeni bir kayıt izni değil, sözleşmeye göre ele alınacak çelişkidir. AWS, güvenli yeniden denemelerde aynı niyetin korunmasını açıklar. [3] [4]

Tekrar kontrolünden önce hangi doğrulamalar gerekir?

Önce sağlayıcının imza veya kimlik doğrulama mekanizmasını, beklediği ham veriyle doğrulayın. Ardından kaynağın doğru operatör, oyuncu cüzdanı, para birimi, işlem ve oturum için yetkili olduğundan emin olun. Kimliği doğrulanmamış bir mesajdaki tanıdık işlem ID'si tamamlanmış işlemi kanıtlamaz. OWASP önce webhook özgünlüğünü doğrulamayı önerir. [1] [6]

  • İmza, zaman penceresi ve yeniden oynatma kontrolünü ilgili sağlayıcı protokolüne göre doğrulayın.
  • Doğrulanan sağlayıcıyı izinli operatör, oyuncu cüzdanı ve para birimiyle eşleştirin.
  • İşlem ID, tutar hassasiyeti, eylem ve bağlı ana işlem referansını kontrol edin.
  • Tekrar yanıtından önce içerik özetini daha önce saklanan istekle karşılaştırın.

Denetim için güvenli ID, zaman ve hash tutun; sırları veya gereksiz kişisel verileri genel günlüklere koymayın. ID daha önce işlenmiş olsa bile sahte bir isteğe başarı yanıtı vermeyin. [2] [6]

Güvenli callback akışı baştan sona nasıl işler?

Kimlik doğrulamasından sonra operatör, benzersiz ticari anahtarı bulur veya ayırır; veri bütünlüğünü kontrol eder, izinli cüzdan hareketini uygular ve sonucu tek dayanıklı veritabanı işleminde saklar. Aynı doğrulanmış talebin tekrarı cüzdanı yeniden etkilemeden önceki yanıtı alır. Sonucu belirsiz olaylar mutabakata gider. [1] [4] [6]

  1. Callback kaynağını doğrulayın ve iç oyuncu ile sağlayıcı yetkisini bağlayın.
  2. Ticari anahtarı oluşturun; iptal varsa kaynak işlem referansını denetleyin.
  3. İşlemi atomik biçimde bulup ayırın, izinli defter hareketini yapın ve sonucu kaydedin.
  4. Sağlayıcıya uygun yanıt verin; belirsiz durumu ikinci bir etki oluşturmadan mutabakata gönderin.
Üç sütunlu akış: doğrulanmış callback ve işlem ID, tek seferlik atomik cüzdan kaydı, bilinen tekrara yanıt veya mutabakat
Birden fazla teslim denemesi aynı saklanan ticari işlemi gösterebilir.

Veritabanı commit'i ile HTTP yanıtı iki sistem arasında genellikle tek atomik işlem değildir. Kayıt başarılı olup yanıt kaybolabilir; bu durumda gönderici tamamlanmış hareketi yeniden deneyecektir. Tasarım bu senaryoyu doğal olarak karşılamalıdır. [4] [7]

Veritabanı finansal etkiyi nasıl tekilleştirir?

Ticari anahtara gerçek bir UNIQUE kısıtı uygulayın; olayın kaydı, defter hareketi ve sonucun yazılması uygun işlem sınırı içinde gerçekleşsin. Ayrı SELECT ve ardından UPDATE yarış durumunu engellemez: iki worker aynı anda anahtarın bulunmadığını görebilir. Son yetki veritabanı benzersizliği ve kilitlemede olmalıdır. [3] [4]

Görülen durumGüvenli işlemeTest edilecek hata
Yeni geçerli anahtarBir kez kayıt ve sonuçEşzamanlı ilk teslimler
Tamam, aynı içerikSaklanan sonucu okuİkinci kredi yok
İşleniyorBekle veya doğrulaYarışan worker'lar
Aynı ID, farklı içerikÇelişkiyi reddetTutar veya oyuncu değişmiş
Commit öncesi rollbackKontrollü yeniden deneAyırmadan sonra çökme

Gelen olay kuyruğu yararlı olabilir ama kayıt altına alınmış bildirim para hareketinin kesinleştiğini göstermez. İşlem yaşam döngüsünü, defter referansını ve değişmez sonucu tutun. İptalin ayrı işlem mi yoksa bağlı durum değişikliği mi olduğu sağlayıcı sözleşmesinden gelir. [1] [3]

Tekrar ve çelişkili isteğe hangi yanıt verilmeli?

Doğrulanmış, kalıcı olarak tamamlanmış bir işlemin tekrarı için daha önceki sonucu veya sözleşmenin istediği özel tekrar kodunu gönderin. Her casino sağlayıcısı için ortak HTTP 200, 409 veya JSON yanıtı yoktur. St8, 7SoftTech ve GR8 Tech farklı alanlar ve iş hataları tanımlar. [1] [2] [3]

  1. Aynı işlem ID ve aynı anlamdaki istek için kararlı yanıt kuralı oluşturun.
  2. Aynı ID ile farklı tutar, oyuncu, para birimi veya eylemi reddedin.
  3. Commit sonrası kaybolan yanıtta yeni hareket yerine saklanan sonucu kullanın.
  4. Kesin iş reddi ile geçici teknik hatayı ayırarak doğru tekrar davranışını seçin.

Sağlayıcı güncel bakiye istiyorsa eski bakiye görüntüsünü tekrar göndermeyin; sözleşmede olmayan hata kodu icat etmeyin. Tekrarın, iptalin ve başarısız bir iş hareketinin nasıl işlendiğini ortakla doğrulayın. HTTP POST tek başına güvenli tekrarı garanti etmez. [2] [3] [7]

İstemci ne zaman tekrar denemeli veya durmalı?

Karar, işlemin idempotency sözleşmesi ve hata türüne bağlıdır. Zaman aşımı veya geçici sunucu hatası ilk işlemin sonucunu belirsiz bırakabilir. Geçersiz imza, bozuk veri veya kesin iş reddi sonsuza kadar tekrarlanmamalıdır. Sınırlı deneme, artan bekleme süresi ve jitter ile mutabakat yolunu birlikte tasarlayın. [4] [6] [7]

DurumÖnerilen eylemGerekçe
Gönderim sonrası timeoutDurumu sorgula veya aynı IDİlk commit bilinmiyor
Geçici 5xx / hız sınırıSınırlı yeniden deneGeçici kesinti
Geçersiz imzaReddet ve uyarKimlik doğrulanmadı
Kesin iş reddiSözleşmeye göre durTekrar sonucu değiştirmez
Commit sonrası yanıt kayıpSaklanan sonucu iletÇift kayıt engeli

Otomatik tekrar kuyruğunu elle yapılan finansal düzeltmelerden ayırın. Hangi mesajın yeniden işlenebileceği, hangisinin durum sorgusuna, hangisinin incelemeye gideceği açık olmalı. Belirsiz transferi zorlamak için yeni bir ticari işlem ID'si kullanmayın. [3] [4]

Callback olayları yanlış sırayla gelirse ne olur?

Mesaj kuyruğu teslim sırasını değiştirebilir; hatta bir cancel isteği bağlı olduğu bahis borcundan önce gelebilir. Bazı sözleşmeler, daha sonra ulaşan orijinal hareketin işlenmesini önlemek için kalıcı iptal işareti ister. Başka API'ler farklı durum akışları tanımlar; bir sağlayıcının hata kodu tüm entegrasyonlara taşınamaz. [1] [2] [5]

  • Yalnızca geliş saatini değil, önceki işlem referansını ve gerçek işlem durumunu saklayın.
  • Her sağlayıcı için debit, credit, cancel ve düzeltmenin izinli geçişlerini tanımlayın.
  • Sözleşme gerektiriyorsa erken iptali orijinal işlem gelene dek kalıcı olarak işaretleyin.
  • Çözülemeyen bağımlılıkları sahte para hareketi oluşturmadan mutabakata gönderin.

Mesaj geliş sırası finansal işlem sırası değildir. Uzak istemcinin zaman damgasıyla defteri sıralamak yeterli olmaz. İşlem kimliği, bağımlılıklar ve operatör veya sağlayıcının güvenilir durumu esas alınmalıdır. [2] [5]

Kesinti sonrası tekrarlar nasıl izlenir ve uzlaştırılır?

Callback doğrulanıp commit öncesi başarısız olabilir ya da kayıt tamamlanıp gönderene yanıt ulaşmayabilir. Teslim durumunu ve gerçek finansal kaydı ayrı izleyin. Belirsiz anahtarları operatör defteri ve sağlayıcı geçmişiyle karşılaştırın; çelişkiler için açık inceleme süreci kurun. Ekrandaki bakiye yenilemesi bunun yerine geçmez. [1] [3] [4]

  • Sağlayıcı bazında deneme, doğrulanmış tekrar, imza hatası, veri çelişkisi ve bekleyen mutabakat sayılarını ölçün.
  • Sık timeout, takılı işlemler, erken iptal ve defter farklarında alarm üretin.
  • Elle yeniden oynatmayı yetkili kişiler, orijinal ID ve kayıtlı gerekçe ile sınırlayın.
  • Düzeltme kaydından önce sağlayıcı hareketleri ile operatör defterini karşılaştırın.
  • Tekrar engeli kayıtlarını sözleşmedeki tekrar ve uyuşmazlık süreleri boyunca koruyun.

Ham ödeme veya kimlik bilgilerini genel analitik kayıtlarına taşımayın. Güvenli korelasyon ID'leri, hash, zaman, durum değişimi ve operatör eylemleri yeterli izlenebilirlik sağlar. Teslim edilen tekrar sayısını gerçek finansal farklardan ayrı raporlayın. [4] [6]

Hangi kabul testleri güvenli tekrar işleyişini kanıtlar?

Normal bir bahis ve kazanç akışının çalışması, tekrar korumasını kanıtlamaz. Sağlayıcı sözleşmesine göre aynı işlem ID'si, çelişkili veri, eşzamanlı worker, kayıp yanıt, iptal ve gecikmiş mesaj senaryolarını deneyin. 7SoftTech tekrarlanan bet, win ve cancel için cüzdan sertifikasyon senaryoları yayımlar. [2]

  1. Bir borç veya alacak kaydedin; aynı imzalı callback'i tekrarlayıp tek defter hareketi doğrulayın.
  2. Aynı ID ile farklı tutar, oyuncu ve para birimi gönderip kontrollü çelişki test edin.
  3. İki geçerli teslimi yarıştırın, commit yanıtını kaybettirin ve kalıcı sonucu okuyun.
  4. Orijinalinden önce iptal mesajı gönderip sağlayıcıya özgü durum kuralını doğrulayın.
  5. Kesinti ve gecikme sonrası mesajları işleyip defter toplamlarını ve denetim kayıtlarını karşılaştırın.

Üretime geçmeden yanıt matrisi, benzersizlik kapsamı, tekrar penceresi ve iptal kurallarını her ortakla onaylayın. Başarı, sıfır tekrar mesajı değildir; taşıma hataları, kayıp yanıtlar ve bozuk sıralama altında her yetkili ticari işlemin yalnızca doğru etkiyi bir kez oluşturmasıdır. [1] [3] [4]

Kaynaklar ve ek okumalar

Diyagram görüntüleyici