Aktif · REST API v1.0

Betx Casino
API Dokümantasyonu

Betx casino gaming platformuna entegre olmak için tam başvuru kılavuzu. Tek bir birleşik API ile yüzlerce oyun sağlayıcısına bağlanın, operator ve oyuncu yönetimini gerçekleştirin, seamless wallet callback'lerini uygulayın.

23

Endpoint

100+

Oyun Sağlayıcı

2

Entegrasyon Modu

Base URL

HTTPShttps://cloneapi.betxsolutions.net

Ne İnşa Edebilirsiniz?

🏢

Operator Yönetimi

Alt operatör oluşturun, hiyerarşi yönetin, bakiye transfer edin.

👤

Oyuncu Yönetimi

Oyuncu kaydedin, hesap bilgilerini sorgulayın, para yatır/çek.

🎰

Oyun Başlatma

Güvenli oyun URL'leri oluşturun, sağlayıcıları listeleyin.

🔄

Seamless Wallet

Gerçek zamanlı bakiye, bahis, kazanç ve iptal callback'leri.

🎁

Bonus Çağrıları

Free spin ve bonus call oturumlarını kaydedin ve yönetin.

📊

İşlem Geçmişi

Raporlama ve denetim için işlem geçmişini sorgulayın.

ℹ️

Betx iki entegrasyon modunu destekler: Seamless Wallet (sunucunuz callback alır) ve Balance Transfer (barındırılan cüzdan). Altyapınıza göre seçin.

Kimlik Doğrulama

Tüm Main API istekleri Authorization header'ında Bearer token gerektirir. API tokenınız operator hesabınız onaylandığında verilir. Erişim için api@betxsolutions.net adresine yazın.

Zorunlu Header'lar

Header	Değer	Zorunlu
Authorization	`Bearer <API_TOKEN>`	EVET
Content-Type	application/json	EVET
Accept	application/json	EVET

Örnek İstek

HTTP

GET https://cloneapi.betxsolutions.net/v1/operator/info
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json
Accept: application/json

Seamless Wallet İmzası

Callback istekleri X-Request-Signature header'ı içerir. Bu imzayı doğrulayarak isteğin Betx'ten geldiğini teyit edin. Algoritma için destek ekibiyle iletişime geçin.

Entegrasyon Rehberi

Casino platformunuzu Betx API ile canlıya almak için bu adımları izleyin.

Hızlı Başlangıç

1

API Kimlik Bilgilerini Alın

Operator hesabı ve Bearer token almak için api@betxsolutions.net adresine yazın.

2

Operatorünüzü Yapılandırın

/v1/operator/update ile callback URL'nizi, RTP'nizi (%50–%95) ve izin verilen IP adreslerini ayarlayın.

3

Oyuncuları Kaydedin

Oyun başlatmadan önce /v1/player/create ile oyuncuyu kaydedin. Yanıtta playerCode döner.

4

Wallet Entegrasyonunu Yapın

Seamless için: sunucunuzda Balance, Bet, Win, Cancel endpoint'leri uygulayın. Transfer için: deposit/withdraw kullanın.

5

Oyunları Başlatın

/v1/game/launch ile oyuncu ID, provider ID, oyun kodu ve para birimini göndererek güvenli URL alın.

⚠️

Zaman Aşımları: Bet callback → 3 saniye. Win ve Cancel callback → 4 saniye. Aşımda tur otomatik iptal edilir.

Hata Kodları

Seamless Wallet callback yanıtlarında statusCode alanı kullanılır.

Seamless Wallet Hata Kodları

Kod	Açıklama	Tetiklendiği Yer
ERR_NOT_AUTHENTICATED	Oyuncu oturumu aktif değil	Balance, Bet, Win, Cancel
ERR_INVALID_PLAYER_ID	Geçersiz oyuncu ID'si	Balance, Bet
ERR_INTEGRITY_CHECK_FAILED	İmza doğrulama başarısız	Balance
ERR_NOT_ENOUGH_MONEY	Yetersiz bakiye	Bet
ERR_TRANSFER_DOES_NOT_EXIST	Orijinal bahis işlemi bulunamadı	Cancel
ERR_UNKNOWN	Dahili sunucu hatası	Tüm callback'ler

⚠️

Bet hatalarında mevcut oyun turu iptal edilir. Reversal isteği otomatik gönderilebilir. Bet için yeniden deneme yapılmaz.

ℹ️

Win ve Cancel zaman aşımı veya hata durumunda 2 kez daha otomatik denenir. Aynı transactionId gelirse yalnızca bir kez işleyin (idempotency).

POST/v1/operator/create

Alt Operator Oluştur

Kimliği doğrulanmış bir operatorün kendi hiyerarşisi altında yeni bir alt operator oluşturmasını sağlar. Yeni operator üst operatordan belirli özellikleri devralır. İlk girişten önce admin onayı gereklidir.

İstek Gövdesi

JSON

{
  "operatorId": "alt_operator_1",
  "password": "##GüçlüŞifre@@",
  "name": "Alt Operator 1",
  "currency": ["USD", "EUR"],
  "ggrRate": 5,
  "level": "operator",
  "parentId": "ust_operator_1",
  "callbackURL": "https://siteniz.com/api/callback",
  "allowedIPs": ["1.2.3.4"]
}

Parametreler

Alan	Tür	Zorunlu	Açıklama
operatorId	string	EVET	Alt operator için benzersiz tanımlayıcı
password	string	EVET	Giriş şifresi (güçlü olmalı)
name	string	EVET	Operatorün görüntülenen adı
currency	string[]	EVET	Desteklenen para birimi kodları (ISO 4217)
ggrRate	number	EVET	Brüt Oyun Geliri yüzdesi (0–100)
level	string	EVET	`operator` veya `agent`
parentId	string	EVET	Üst operator ID'si
callbackURL	string	EVET	Seamless wallet callback endpoint URL'si
allowedIPs	string[]	HAYIR	İzin verilen IP adresleri

Yanıt

JSON

{ "success": true, "message": "OK" }

GET/v1/operator/info

Operator Bilgilerini Getir

Kimliği doğrulanmış operatorün ad, RTP, bakiye ve callback URL dahil ayrıntılı bilgilerini döner. Parametre gerekmez.

Yanıt

JSON

{
  "success": true, "message": "OK",
  "data": {
    "id": "operator_id_1",
    "name": "Benim Casinoum",
    "parentId": "ust_operator_1",
    "balance": [{ "currency": "USD", "amount": 5000 }],
    "rtp": 95,
    "callbackURL": "https://siteniz.com/api/callback",
    "allowedIPs": ["1.2.3.4"],
    "providers": [1, 2],
    "ggrRate": 4,
    "level": "agent",
    "paymentMethod": "deposit"
  }
}

PATCH/v1/operator/update

Operator Güncelle

Kimliği doğrulanmış operatorün kendi yapılandırmasını güncellemesini sağlar. Yalnızca gönderilen alanlar güncellenir.

İstek Gövdesi

JSON

{
  "name": "Benim Casino Markam",
  "rtp": 95,
  "callbackURL": "https://siteniz.com/api/callback",
  "allowedIPs": ["1.2.3.4", "5.6.7.8"]
}

Alan	Tür	Zorunlu	Açıklama
name	string	HAYIR	Operator/marka görüntü adı
rtp	number	HAYIR	Oyuncuya Dönüş yüzdesi (50–95)
callbackURL	string	HAYIR	Seamless wallet callback endpoint'i
allowedIPs	string[]	HAYIR	İzin verilen sunucu IP adresleri

POST/v1/operator/transfer-balance

Bakiye Transfer Et

Kimliği doğrulanmış bir operatörün alt operatörlerine bakiye transfer etmesini sağlar. Yeterli bakiye zorunludur.

İstek Gövdesi

JSON

{
  "targetOperatorId": "alt_operator_11",
  "currency": "USD",
  "amount": 100,
  "remark": "Aylık bütçe transferi"
}

Alan	Tür	Zorunlu	Açıklama
targetOperatorId	string	EVET	Transfer alacak alt operatorün ID'si
currency	string	EVET	Para birimi kodu (örn. USD)
amount	number	EVET	Transfer edilecek tutar
remark	string	HAYIR	İsteğe bağlı not

POST/v1/player/create

Oyuncu Oluştur

Harici oyuncuyu Betx API'sine bağlar. Mevcut değilse yeni profil oluşturulur. Dönen playerCode oyuncunun API'deki benzersiz numarasıdır. Oyun başlatmadan önce çağrılmalıdır.

İstek Gövdesi

JSON

{ "playerExternalId": "sisteminizdeki_oyuncu_id" }

Yanıt

JSON

{
  "success": true, "message": "OK",
  "data": { "playerCode": 100000121 }
}

GET/v1/player/info

Oyuncu Bilgilerini Getir

Harici ID'ye göre oyuncu hakkında ayrıntılı bilgi ve güncel bakiye döner.

Sorgu Parametresi

JSON

{ "playerExternalId": "sisteminizdeki_oyuncu_id" }

Yanıt

JSON

{
  "success": true, "message": "OK",
  "data": {
    "playerCode": 100000121,
    "balance": [{ "currency": "USD", "amount": 5000 }]
  }
}

POST/v1/player/wallet/deposit

Oyuncu Cüzdanına Para Yatır

Belirtilen tutarı oyuncunun cüzdanına yatırır. Yalnızca pozitif tutarlar kabul edilir. Seamless Wallet entegrasyonunda gerekli değildir.

İstek Gövdesi

JSON

{
  "playerExternalId": "sisteminizdeki_oyuncu_id",
  "currency": "USD",
  "amount": 1000.50
}

POST/v1/player/wallet/withdraw

Oyuncu Cüzdanından Para Çek

Belirtilen tutarı oyuncunun cüzdanından çeker. İşlem öncesinde yeterli bakiye doğrulanır. Seamless Wallet entegrasyonunda gerekli değildir.

İstek Gövdesi

JSON

{
  "playerExternalId": "sisteminizdeki_oyuncu_id",
  "currency": "USD",
  "amount": 500.00
}

GET/v1/provider/list

Oyun Sağlayıcılarını Listele

Tüm mevcut oyun sağlayıcılarının listesini döner. Parametre gerekmez.

Yanıt

JSON

{
  "success": true, "message": "OK",
  "data": [{
    "providerId": 1,
    "providerName": "Pragmatic Play",
    "logo": "https://cdn.example.com/logos/pragmaticplay.png",
    "status": 1
  }]
}

GET/v1/provider/settings

Sağlayıcı Ayarlarını Getir

Belirli bir sağlayıcıya uygulanan mevcut ayarları getirir.

Sorgu Parametreleri

Alan	Tür	Zorunlu	Açıklama
providerId	number	EVET	Sağlayıcı ID'si
currency	string	EVET	Para birimi kodu (örn. USD)

Yanıt

JSON

{
  "success": true, "message": "OK",
  "data": { "lobbyshow": true, "promoshow": true, "slotMinBet": 0, "slotmaxBet": 0 }
}

PUT/v1/provider/settings/:providerId/:currency

Sağlayıcı Ayarlarını Güncelle

Belirli bir sağlayıcı için para birimi bazında ayarları günceller. Gövde yapısı sağlayıcıya göre değişir. Aşağıdaki örnek Pragmatic Play içindir.

URL Parametreleri

Alan	Tür	Açıklama
providerId	number	Sağlayıcı ID'si
currency	string	Para birimi kodu (örn. USD)

İstek Gövdesi (Pragmatic Play)

JSON

{ "lobbyshow": true, "promoshow": true, "verify": false }

GET/v1/game/list/:providerId

Oyunları Listele

Sağlayıcı ID'sine göre filtrelenmiş operatöre ait oyunları döner.

URL Parametresi

Alan	Tür	Açıklama
providerId	number	Oyunlarını listelemek istediğiniz sağlayıcının ID'si

Yanıt

JSON

{
  "success": true, "message": "OK",
  "data": [{
    "gameID": "vswaysdogs",
    "gameName": "The Dog House Megaways",
    "gameImage": "https://cdn.example.com/images/120x120/1.png",
    "gameType": 0, // 0: Slot, 1: Canlı, 2: Diğer
    "inMaintenance": false
  }]
}

POST/v1/game/launch

Oyun Başlat

Belirtilen oyuncu ve oyun için güvenli bir oyun başlatma URL'si oluşturur. Bu URL iframe veya yeni sekmede kullanılabilir.

İstek Gövdesi

JSON

{
  "playerExternalId": "sisteminizdeki_oyuncu_id",
  "providerId": 1,
  "gameCode": "vswaysdogs",
  "language": "tr",
  "currency": "USD",
  "returnUrl": "https://siteniz.com",
  "rtp": 0
}

Alan	Tür	Zorunlu	Açıklama
playerExternalId	string	EVET	Sisteminizdeki oyuncu tanımlayıcısı
providerId	number	EVET	Oyun sağlayıcısının ID'si
gameCode	string	EVET	Başlatılacak oyunun kodu
language	string	EVET	Dil kodu (örn. tr, en)
currency	string	EVET	Oyun oturumu para birimi
returnUrl	string	HAYIR	Oyun çıkışında yönlendirilecek URL
rtp	number	HAYIR	Oturum RTP değeri (0 = operator varsayılanı)

Yanıt

JSON

{
  "success": true, "message": "OK",
  "data": { "gameUrl": "https://games.example.com/launch?token=..." }
}

POST/v1/game/kick

Oyuncuyu Oyundan At

Oyuncunun aktif oyun oturumunu zorla kapatır. Hareketsizlik yönetimi, güvenlik ya da manuel müdahale için kullanılır.

İstek Gövdesi

JSON

{ "playerExternalId": "sisteminizdeki_oyuncu_id" }

Yanıt

JSON

{ "success": true, "message": "OK" }

GET/v1/transaction/list

İşlemleri Listele

Bahisler, kazançlar, iadeler ve diğer hareketleri içeren sayfalanmış işlem listesi döner.

Sorgu Parametreleri

Alan	Tür	Zorunlu	Açıklama
startTime	datetime	EVET	Başlangıç (YYYY-MM-DD HH:mm:ss)
endTime	datetime	EVET	Bitiş (YYYY-MM-DD HH:mm:ss)
offset	number	HAYIR	Sayfalama için atlanacak kayıt sayısı
limit	number	HAYIR	Maksimum kayıt sayısı

Yanıt

JSON

{
  "success": true, "message": "OK",
  "data": {
    "total": 100, "offset": 0, "count": 100,
    "list": [{
      "transId": "1011520245", "transType": 1,
      "playerCode": 400000001, "playerExternalId": "demoplayer",
      "roundId": "12345713400010008",
      "providerId": 1, "providerName": "Pragmatic Play",
      "gameCode": "vswaysdogs", "gameName": "The Dog House Megaways",
      "amount": 5000, "balance": 40000,
      "success": true, "createdAt": "2024-12-28 12:00:00"
    }]
  }
}

GET/v1/transaction/round

Tur İşlemlerini Getir

Belirli bir oyun turuna ait tüm işlem detaylarını döner. Denetim ve destek için kullanılır.

Sorgu Parametreleri

Alan	Tür	Zorunlu	Açıklama
playerExternalId	string	EVET	Sisteminizdeki oyuncu ID'si
roundId	string	EVET	Benzersiz oyun turu ID'si
providerId	number	EVET	Oyun sağlayıcısı ID'si
gameCode	string	EVET	Oyunun dahili kodu

POST/v1/bonus-call/register

Bonus Çağrısı Kaydet

Oyuncu için bonus çağrısı oturumu başlatır. Takip için issueId döner. gameCode'u belirli oyun dizisi veya sağlayıcı altındaki tüm oyunlar için "all" olarak ayarlayın. Bir oyunda tamamlanan bonus diğer oyunları tetiklemez.

İstek Gövdesi

JSON

{
  "issueId": "bonus_001",
  "providerId": 1,
  "gameCode": ["vssuef", "fblsoe"], // veya "all"
  "playerExternalId": "sisteminizdeki_oyuncu_id",
  "currency": "USD",
  "bonusType": 2, // 1=normal bonus, 2=free spin
  "callAmount": 100,
  "expireAt": "2027-01-01 23:59:59",
  "metaData": { "spinAmount": 10, "baseBetAmount": 2 }
}

Alan	Tür	Zorunlu	Açıklama
issueId	string	EVET	Bu bonus için benzersiz ID
providerId	number	EVET	Oyun sağlayıcısı ID'si
gameCode	string[] \| "all"	EVET	Bonusu tetikleyecek oyun kodları veya `"all"`
playerExternalId	string	EVET	Sisteminizdeki oyuncu ID'si
currency	string	EVET	Para birimi kodu
bonusType	number	EVET	1 = normal bonus, 2 = free spin (PP ve EGT Digital)
callAmount	number	EVET	bonusType=1: garantili kazanç; bonusType=2: maks kazanç tavanı
expireAt	string	EVET	Son kullanma (YYYY-MM-DD HH:mm:ss)
metaData.spinAmount	number	*	Free spin sayısı (Min:10, Maks:100). bonusType=2 için zorunlu
metaData.baseBetAmount	number	*	Spin başına bahis tutarı. bonusType=2 için zorunlu

Yanıt

JSON

{
  "success": true, "message": "OK",
  "data": { "issueId": "bonus_001" }
}

POST/v1/bonus-call/cancel

Bonus Çağrısını İptal Et

Aktif veya rezerve edilmiş bir bonus çağrısını iptal eder. Hata kurtarma veya dolandırıcılık önleme senaryolarında kullanılır.

İstek Gövdesi

JSON

{ "issueId": "bonus_001" }

Yanıt

JSON

{ "success": true, "message": "OK" }

GET/v1/bonus-call/detail/:issueId

Bonus Çağrısı Detayı

Benzersiz issueId ile bonus çağrısının tüm detaylarını döner.

URL Parametresi

Alan	Tür	Açıklama
issueId	string	API tarafından verilen bonus çağrısı ID'si

Yanıt

JSON

{
  "success": true, "message": "OK",
  "data": {
    "issueId": "i3746", "operatorId": "operator_id",
    "providerId": 1, "gameCode": "vswaysdog",
    "playerExternalId": "sisteminizdeki_oyuncu_id",
    "currency": "USD", "bonusType": 1, "callAmount": 100,
    "metaData": {
      "spinAmount": 100, "playedAmount": 50, "betLevel": 1,
      "expireAt": "2027-01-01T23:59:59.000Z", "maxWinAmount": 5000
    },
    "status": 1, // 1=aktif, 2=tamamlandı
    "totalWinAmount": 250, "createdAt": "2025-09-01 12:00:00"
  }
}

CALLBACKcommand: "balance"

Bakiye Callback'i

Betx, bir oyuncu oyun başlattığında veya aktif oyun sırasında her dakika bakiyeyi yenilemek için bu isteği callbackURL adresinize gönderir. İsteği işlemeden önce oyuncunun oturumunu doğrulayın. Yanıtta X-Request-Signature header'ını kontrol edin.

Gelen İstek (Betx → Sunucunuz)

JSON

{
  "command": "balance",
  "playerId": "1101",
  "currency": "EUR",
  "timestamp": 1586335186372
}

Alan	Tür	Zorunlu	Açıklama
command	string	EVET	Her zaman "balance"
playerId	string	EVET	Sisteminizdeki oyuncunun benzersiz tanımlayıcısı
currency	string	EVET	ISO-4217 para birimi kodu (EUR, USD vb.)
timestamp	number	EVET	Milisaniye cinsinden Unix timestamp

Zorunlu Yanıt (Sunucunuz → Betx)

Başarılı

{ "balance": 1501.52, "statusCode": "OK" }

Hata

{ "statusCode": "ERR_INVALID_ACCOUNT" }

CALLBACKcommand: "bet"

Bahis Callback'i

Oyuncu bahis yaptığında gönderilir. Bahis tutarını bakiyeden düşüp güncel bakiyeyi döndürün. Aynı transactionId birden fazla gelirse yalnızca bir kez işleyin (idempotency).

⚠️

3 saniye içinde yanıt verin. Zaman aşımında mevcut turu geri almak için otomatik cancel gönderilir. Bet için yeniden deneme yapılmaz.

Gelen İstek (Betx → Sunucunuz)

JSON

{
  "command": "bet",
  "transactionId": "SP215202",
  "playerId": "1101",
  "roundId": "65215842315484512",
  "providerId": 2,
  "providerName": "EGT Digital",
  "gameCode": "FSHBLSlot",
  "gameName": "40 Burning Hot Bell Link",
  "currency": "EUR",
  "amount": 10,
  "isRoundFinished": true,
  "isCall": false,
  "timestamp": 1586335186372
}

Alan	Tür	Zorunlu	Açıklama
transactionId	string	EVET	Benzersiz işlem ID'si — idempotency için kullanın
playerId	string	EVET	Sisteminizdeki oyuncu tanımlayıcısı
roundId	string	EVET	Benzersiz oyun turu ID'si
amount	number	EVET	Düşülecek bahis tutarı
isRoundFinished	boolean	EVET	Bu bahis turu bitiriyor mu?
isCall	boolean	EVET	Bonus çağrısı bahsi mi?

Zorunlu Yanıt

Başarılı

{ "balance": 1491.52, "statusCode": "OK" }

Yetersiz Bakiye

{ "statusCode": "ERR_NOT_ENOUGH_MONEY", "balance": 5.00 }

CALLBACKcommand: "win"

Kazanç Callback'i

Oyuncu kazandığında gönderilir. Kazanç tutarını bakiyeye ekleyip güncel bakiyeyi döndürün. İdempotent işlem — her transactionId'yi bir kez işleyin. 4 saniye içinde yanıtlayın; zaman aşımında 2 kez daha denenir.

Gelen İstek

JSON

{
  "command": "win",
  "transactionId": "SP215202",
  "playerId": "1101",
  "roundId": "65215842315484512",
  "providerId": 2, "providerName": "EGT Digital",
  "gameCode": "FSHBLSlot", "gameName": "40 Burning Hot Bell Link",
  "currency": "EUR", "amount": 100,
  "isRoundFinished": true, "isCall": false,
  "timestamp": 1586335186372
}

Zorunlu Yanıt

Başarılı

{ "balance": 1591.52, "statusCode": "OK" }

CALLBACKcommand: "cancel"

İptal Callback'i

Oyuncunun bahis işlemi tamamlanamadığında (ağ hatası, zaman aşımı vb.) tetiklenir. Tam bahis tutarını bakiyeye iade edin. İdempotent işlem. 4 saniye içinde yanıtlayın; hata durumunda 2 kez daha denenir.

Gelen İstek

JSON

{
  "command": "cancel",
  "transactionId": "SP215203",
  "referenceId": "SP215202",
  "playerId": "1101",
  "roundId": "65215842315484512",
  "providerId": 2, "providerName": "EGT Digital",
  "gameCode": "FSHBLSlot", "gameName": "40 Burning Hot Bell Link",
  "currency": "EUR", "amount": 10,
  "timestamp": 1586335186372
}

Alan	Tür	Açıklama
transactionId	string	Bu iptal işleminin benzersiz ID'si
referenceId	string	İptal edilmekte olan orijinal bahis işlemi ID'si
amount	number	Oyuncuya iade edilecek tutar

Zorunlu Yanıt

Başarılı

{ "balance": 1501.52, "statusCode": "OK" }

Hata

{ "statusCode": "ERR_TRANSFER_DOES_NOT_EXIST", "balance": 1501.52 }

Betx CasinoAPI Dokümantasyonu

Operator Yönetimi

Oyuncu Yönetimi

Oyun Başlatma

Seamless Wallet

Bonus Çağrıları

İşlem Geçmişi

API Kimlik Bilgilerini Alın

Operatorünüzü Yapılandırın

Oyuncuları Kaydedin

Wallet Entegrasyonunu Yapın

Oyunları Başlatın

Betx Casino
API Dokümantasyonu