İçeriğe Geç

Bahis IBAN Sorgulama

POST /api/v1/betting-ibans/check

Tek çağrıda en çok 100 IBAN'ı Bahis IBAN Listesi'nde sorgular. Her IBAN için listede olup olmadığını, listedeyse kaydını döner.

Bu liste ne söyler, ne söylemez

Bahis IBAN Listesi bir tespit listesidir: bir IBAN'ın yasa dışı bahis ödemesi toplamak için kullanıldığının gözlemlendiğini ve bu tespitin doğrulandığını söyler. Bir risk puanı değildir ve hesap sahibi hakkında bir suçlama değildir: hesap, sahibinin bilgisi dışında kullanılıyor olabilir. Ne yapılacağına kendi kurallarınız ve mevzuat karar verir.

İstek

{
  "ibans": [
    "TR03 9999 9012 3456 7890 1234 56",
    "TR039999901234567890123456",
    "TR00"
  ]
}
  • ibans[] — en az 1, en çok 100 IBAN, metin olarak. Boşluk, tire, nokta ve küçük harf kabul edilir. Başka hiçbir düzeltme yapılmaz: rakam yerine yazılmış benzer bir harf yazım hatasıdır.

IBAN'ları yalnız istek gövdesinde gönderin; adres satırına koymayın. Regvion sorguladığınız IBAN'ları saklamaz ve günlüğe yazmaz; yalnız kaç IBAN sorguladığınız sayılır.

Yanıt

{
  "listSequence": 1842,
  "checkedAt": "2026-11-11T09:30:02Z",
  "listedCount": 2,
  "results": [
    {
      "index": 0,
      "outcome": "listed",
      "iban": "TR039999901234567890123456",
      "record": { "recordId": "3f6c1c0e-...", "iban": "TR039999901234567890123456", "status": "active", "listed": true }
    },
    {
      "index": 1,
      "outcome": "listed",
      "iban": "TR039999901234567890123456",
      "record": { "recordId": "3f6c1c0e-...", "iban": "TR039999901234567890123456", "status": "active", "listed": true }
    },
    { "index": 2, "outcome": "invalid", "iban": null, "record": null }
  ]
}
  • listSequence — sorgunun yapıldığı andaki liste durumu (besleme sıra numarası).
  • checkedAt — sorgunun yapıldığı an (UTC).
  • listedCount — listed sonuç sayısı.
  • results[] — gönderdiğiniz sırayla, her IBAN için bir öğe:
    • index — IBAN'ın ibans içindeki yeri, 0'dan başlar
    • outcome — listed, notListed ya da invalid
    • iban — IBAN'ın normalleştirilmiş hâli; geçerli bir TR IBAN değilse null
    • record — listed ise kaydın tamamı (alanları Bahis IBAN Listesi sayfasındadır; örnekte kısaltılmıştır); aksi hâlde null

Aynı IBAN'ı birden çok kez gönderirseniz her biri kendi satırında yanıtlanır.

Sonuçlar nasıl okunur

  • listed — IBAN sorgu anında listededir (etkin ya da pasif).
  • notListed — IBAN sorgu anında listede değildir. Bu, hesabın temiz olduğu anlamına gelmez: liste yalnız tespit edilen ve doğrulanan IBAN'ları içerir, bir IBAN sonradan eklenebilir. Daha önce listeden çıkarılmış ya da uzun süredir gözlenmediği için listeden düşmüş bir IBAN da notListed döner.
  • invalid — gönderilen değer geçerli bir TR IBAN değildir (26 karakter, TR, denetim haneleri). Sorgulanmamıştır; notListed gibi işlemeyin.

Bir değerdeki hata öteki IBAN'ları etkilemez.

Aylık kota

Bir çağrı, içindeki IBAN sayısı kadar sayılır. 100 IBAN'lı çağrı aylık kotanızdan 100 düşer; geçersiz değerler de sayılır.

Çağrıdaki IBAN sayısı bu ay kalan hakkınızdan fazlaysa yanıt 429 QUOTA_EXCEEDED olur, hiçbir IBAN sorgulanmaz ve hak düşmez. 200 ile bitmeyen çağrının hakkı geri verilir. Dakikalık oran sınırı ise çağrı sayar: bir çağrı 1 düşer.

Hata yanıtları

  • 400 VALIDATION_ERROR — ibans yok, boş, 100'den fazla ya da gövde okunamadı. Hiçbir IBAN sorgulanmadı.
  • 429 QUOTA_EXCEEDED — yukarıda.
  • 503 BETTING_IBAN_UNAVAILABLE — hizmet geçici olarak kapalı. Hiçbir IBAN sorgulanmadı; bu yanıt "listede yok" demek değildir. Retry-After kadar bekleyip yineleyin. Sayılmaz.

Yetki

Api.BettingIban.Check iznini gerektirir. Bu izin katmanlara kendiliğinden verilmez ve Api.BettingIban.Read izninden ayrıdır. Alıcı adının maskesiz hâli için ek olarak Api.BettingIban.FullName gerekir.

Parametreler

İsimKonumTipZorunluAçıklama
ibans Body array Evet Sorgulanacak IBAN'lar, metin olarak. En az 1, en çok 100. Boşluk, tire, nokta ve küçük harf kabul edilir.

Yanıtlar

200 — listSequence, checkedAt, listedCount ve istekle aynı sırada results[]: index, outcome (listed, notListed ya da invalid), iban (normalleştirilmiş; geçersizse null) ve record (listed ise kayıt, aksi hâlde null).

400 — ibans yok, boş, 100'den fazla ya da gövde okunamadı (VALIDATION_ERROR). Hiçbir IBAN sorgulanmadı.

429 — Çağrıdaki IBAN sayısı bu ay kalan hakkınızdan fazla (QUOTA_EXCEEDED). Hiçbir IBAN sorgulanmadı; daha küçük bir çağrı gönderebilirsiniz.

503 — Hizmet geçici olarak kapalı (BETTING_IBAN_UNAVAILABLE). Bu yanıt 'listede yok' anlamına gelmez. Retry-After kadar bekleyip yeniden deneyin. Hiçbir IBAN sorgulanmadı ve hak düşmez.