iGaming API Entegrasyonları

Sportsbook API Entegrasyonu: Oranlar, Bahisler ve Sonuçlandırma

Bir bahis sitesinde görünen oran, oyuncunun bahis talebinin kabul edildiği anlamına gelmez. Oran sağlayıcısı etkinlikleri ve pazar fiyatlarını iletir; bahis motoru limitleri ve kabul kararını yönetir; cüzdan ile hesaplaşma sistemleri ise mali sonucu kaydeder. Sağlam bir Sportsbook API entegrasyonu bu ayrı sorumlulukları tutarlı kimlikler, açık durum geçişleri, güvenli yeniden denemeler ve denetlenebilir kayıtlarla bağlar. Bu kılavuz, ekranda görülen orandan kabul edilen kupona ve daha sonra yapılan ödemeye veya düzeltmeye kadar süreci ele alır. Bir sağlayıcının oran akışı sunması, aynı zamanda bahis kabul ettiği, bakiyeleri tuttuğu veya belirli bir pazarda faaliyet yetkisi verdiği anlamına gelmez.

Oran pazarları, onaylanan bahis kuponları ve hesaplaşma kayıtlarını gösteren üç bağlantılı sportsbook katmanı
Oran verisi, bahis kabul kararı ve mali hesaplaşma birbirinden ayrı doğrulanır.
İçindekiler

Sportsbook API entegrasyonunun kapsamı nedir?

Genellikle üç temel alan bulunur: fikstürler ve değişen oranların yer aldığı pazar verisi, kuponu onaylayan bahis ve risk sistemi, son olarak da sonuçları paraya dönüştüren hesaplaşma katmanı. Bu alanları aynı şirket veya farklı iş ortakları sunabilir. Entegrasyon öncesinde her işlemin yetkili sahibi belirlenmelidir. [1]

Bir oran akışındaki pazar durumu kendi bağlamında geçerli olabilir fakat cüzdandan para çekme yetkisi vermez. Oyuncunun butona basması da kabul edilmiş kupon oluşturmaz. Kabul edilen tutar ve fiyat, yetkili servis tarafından doğrulanıp saklandığında bağlayıcı hale gelir.

Etkinlik, pazar ve seçim kimlikleri nasıl eşleştirilir?

Etkinlik, pazar, seçim ve kupon için kalıcı iç kimlikler kullanırken sağlayıcının özgün kodunu ve ad alanını koruyun. Tek maçta birçok pazar, tek pazarda farklı çizgiler ve seçenekler olabilir. '2,5 üst' ifadesi, maç ve pazar parametreleri olmadan benzersiz bir anahtar değildir.

KimlikNe gösterir?Kontrol
Kaynak etkinliğiSağlayıcının maçıKaynağı da saklayın
Pazar kimliğiBahis türü ve çizgiParametreleri koruyun
Seçim kimliğiBelirli olası sonuçSadece ada güvenmeyin
Oran sürümüFiyatın revizyonuEski sürümü reddedin
Kupon kimliğiKabul edilmiş bahisYeniden kullanmayın
Sonuç kimliğiHesaplaşma olayıKuponla bağlayın

Eşleme sürümünü ve ham mesajı kaydedin. Ertelenen maç veya değişen pazar başlığı, eski bir kuponu sessizce farklı seçime bağlamamalıdır. Resmi akış türleri fikstür, oran ve hesaplaşma değişikliklerini ayrı mesajlar olarak tanımlar. [1]

Oran değişikliği ve pazarın durdurulması neyi etkiler?

Kullanıcı oranı gördükten sonra fiyat değişebilir veya pazar askıya alınabilir. Tüketici servis, zaman damgalarını, sürüm sırasını ve sağlayıcının tanımladığı pazar statülerini izlemelidir. Ekranda kalan eski rakam, bahis kabul izni değildir. odds_change belgelerinde bu ayrım açıkça görülür. [2]

  • Her pazar için kaynak zamanı ve son işlenen sürümü koruyun.
  • Aktif, askıda, kapalı ve bilinmeyen durumları sözleşmeye göre ayırın.
  • Oran yaşına üst sınır koyup kabul sırasında sunucuda yeniden doğrulayın.
  • Önbellekteki fiyatı kesin kabul sözü olarak göstermeyin.

Önbellek pazar listesini hızlı gösterir; asıl kabul noktası güncel fiyatı, hesap uygunluğunu, risk limitini ve kullanılabilir bakiyeyi tekrar değerlendirir. Fiyat değiştiyse açık bir ret veya yeni oran için kullanıcı onayı üretmelidir.

Bahis tıklaması ne zaman kabul edilmiş kupona dönüşür?

İstek; müşteri, marka, etkinlik, pazar, seçim, bahis tutarı, istenen oran ve tekil istek anahtarını içermelidir. Yetkili motor pazarın açık olup olmadığını, limitleri, fonları ve kabul koşullarını doğrular. Tek başına odds sağlayıcısında bahis yerleştirme API'si bulunmayabilir.

  1. Seçimi, tutarı, görülen fiyatı ve benzersiz istek anahtarını alın.
  2. Güncel pazarı, riski, müşteri kurallarını ve cüzdanı tekrar kontrol edin.
  3. Yetkili motordan kabul, ret veya bekleme şeklinde kesin durum isteyin.
  4. Kuponu ve para rezervini bir kez kaydedin; tekrar isteklerde saklanan sonucu döndürün.
Canlı oranlardan bahis kuponunun kabulüne ve hesaplaşmasına uzanan üç aşamalı sportsbook API şeması
Oran akışı kabul kararını destekler; mali yükümlülük yalnızca onaylı kuponla başlar.

İstek sonrası zaman aşımı, bahis reddedildi demek değildir: sağlayıcı kuponu kaydetmiş olabilir. İkinci isteği göndermeden önce istek anahtarı veya kupon referansı ile durumu sorgulayın. HTTP, her POST tekrarını kendiliğinden güvenli saymaz. [6]

Akış kesintilerinden sonra olaylar nasıl kurtarılır?

Canlı veri akışı gecikebilir, bazı mesajlar iki kez gelebilir veya bağlantı kopabilir. Üretici kimliği, mesaj sırası, kalıcı işleme noktası ve yeniden oynatma prosedürü gerekir. Önemli olayların alındı onayını, durum güvenilir biçimde kaydedildikten sonra verin. Kurtarma API'leri sonuç ve iptal mesajlarını da kapsayabilir. [5]

DurumİşlemDoğrulama
Çift mesajKaynak anahtarıyla atlaİkinci güncelleme yok
Eksik sıraBahsi güvenle durdurTekrar veya anlık veri
Bağlantı kesildiEski fiyatı engelleKaynak güncel mi?
Geç sonuçAyrı olay işleKupon bağı bulunuyor
Yeniden başlamaKontrol noktasını okuÇift ödeme yok

Güncel oran görüntüsü tüm geçmiş sonuçların işlendiğini kanıtlamaz. Sağlayıcının geri alma kapsamını ve saklama sürelerini inceleyin; açık kuponları ayrıca mutabakata alın.

Sonuç, iptal ve geri alma mesajları nasıl işlenir?

Hesaplaşma, kabul edilmiş bahisleri geçerli kurallara göre sonlandırır. Kazanç, kayıp, iade, kısmi ödeme ve kombine bilet sonuçları uygun veri modeline ihtiyaç duyar. Unified Odds Feed, bet_settlement ile daha önce gönderilen bir sonucu düzelten rollback_bet_settlement mesajlarını ayırır. [3] [4]

  1. Kabul edilen tutarı, oranı, pazar parametrelerini ve kural sürümünü saklayın.
  2. Sadece doğrulanmış kaynaktan ve bilinen kupona ait sonuçları işleyin.
  3. Kazanç veya iade için benzersiz işlem anahtarıyla tek kayıt oluşturun.
  4. Düzeltmede eski işlemi silmek yerine gerekçeli ters kayıt yazın.

Geri alma yeni bir kazanç değildir; pazar iptali her zaman normal bir sonuç iadesi ile aynı anlama gelmez. Olayın özgün türünü koruyun. Büyük Britanya'da ilgili standartlar geçerliyse sonuçların açıklanan bahis kurallarına uygun olması ve etkileyen hataların müşterilere bildirilmesi beklenir. [7]

Cüzdan, bahis ve ödeme kayıtları nasıl mutabık tutulur?

Tutar rezervi, kabul edilen kupon, sonuçlandırma ve düzeltme için ayrı değişmez referanslar gerekir. Callback alınması, ödemenin başarıyla kaydedildiği anlamına gelmez. Her finansal hareketi benzersiz defter anahtarı altında işleyin ve partnerin sonucu ile eşleştirin.

Kupon durumuCüzdan işlemiKanıt
Yalnızca teklifPara düşmeFiyat süresi ve istek
Kabul edildiTutarı bir kez ayırKabul referansı
ReddedildiRezervi serbest bırakRet kaydı
SonuçlandıÖde veya borcu kapatSonuç ve defter ID
DüzeltildiTers kayıt veya iadeÖnceki işlem ve neden

Mutabakat her kuponun para birimini, kesin tutarlarını, bekleyen rezervlerini ve ters işlemlerini karşılaştırır. Farklar araştırılmalı; doğrulanmamış bildirimlerden otomatik telafi ödemesi üretilmemelidir.

Canlı bahiste gecikme ve risk kontrolü neden kritiktir?

Maç sırasında oranlar ve pazar durumu hızla değişir. Hızlı akış faydalıdır ancak askıya alma sinyallerinin, fiyat onay süresinin, risk limitlerinin ve varsa bahis gecikmesinin yerini tutmaz. Belirsiz durumlarda güvenli ret veya bekletme politikasını önceden belirleyin.

  • Kaynak gecikmesini, ekrandaki fiyat yaşını ve kabul yanıt süresini ayrı ölçün.
  • Pazar veya risk servisinin durumu bilinmiyorsa kontrollü biçimde reddedin.
  • Gerçek kabul oranını daha önce gösterilenden ayrı kaydedin.
  • Hızlı değişimleri, maç kesintilerini ve çoklu tıklamayı yük altında test edin.

Kullanıcı talebinin kabul mü ret mi edildiğini net görmelidir. Her lig veya ülke için ortak bir kabul süresi, ödeme garantisi veya limit varsaymak doğru değildir. [2] [7]

Güvenlik, mevzuat ve izleme açısından ne gerekir?

Servis kimlik doğrulaması, müşteri ve marka bazında yetki, şifreli iletişim, güvenli anahtar yönetimi ve denetim izi gereklidir. Oran okuma yetkisine sahip bir servis kupon üretmemeli veya cüzdan bakiyesini değiştirememelidir. Her bahis ID'si nesne düzeyinde doğrulanmalıdır.

  • Eski fiyatları, mesaj boşluklarını ve askıdaki pazara bahis denemelerini izleyin.
  • Bekleyen, kabul edilen ve sonuçlanan kuponları izin verilen partner raporlarıyla karşılaştırın.
  • Çift POST, zaman aşımı, sahte callback ve yanlış sıradaki düzeltmeleri deneyin.
  • Her hedef bölgede lisans, veri saklama ve müşteri itirazı kurallarını belgeleyin.

Veri akışının teknik sağlığı ile ödeme defterinin doğruluğunu ayrı panolarda izleyin. Çok mesaj işlenmiş olması, açık yükümlülükler veya çift ödemeler bulunmadığını göstermez.

Sportsbook API canlıya çıkmadan hangi kontroller yapılmalı?

Test ortamında tüm kupon yaşam döngüsünü canlandırın: oran değişimi, askıya alınma, ret, başarılı kabul, gecikmiş sonuç, iade, rollback, akış kurtarma ve bakiye uyuşmazlığı. Her senaryo kaynak olaydan son finansal kayda kadar izlenmelidir.

  1. Pazar kimliklerini, ticari hakları, oran hassasiyetini ve geçerlilik süresini doğrulayın.
  2. İdempotent kabulü, zaman aşımlarını, reddi ve rezerv açmayı test edin.
  3. Hesaplaşma, iptal, ters kayıt ve cüzdan mutabakatına kanıt oluşturun.
  4. Canlıya geçmeden gerekli operasyonel, güvenlik ve hukuki onayları alın.

Başarılı bir sportsbook entegrasyonu yalnızca oran listesi ve kupon numarası döndürmez. Her kuponun neden kabul edildiğini, nasıl sonuçlandığını ve her mali düzeltmenin hangi kayda dayandığını açıklayabilir.

Kaynaklar ve ek okumalar

Diyagram görüntüleyici