Limitler

Limit motoru, bir kullanıcının ne kadar ve ne sıklıkta işlem yapabileceğini belirler. Her para hareketi, işlem başlamadan önce limit kapısından geçer; kapı geçirmezse operasyon hiç açılmaz.

Cüzdan toplamı ve operasyon tipine özel sayaçlar

Bir işlemi şemanızdaki iki tür satır bağlayabilir. Hangi sayacın kullanılacağını satırın operationType değeri belirler:

Cüzdan toplamı yöne göre iki ayrı sayaçtır:

• Para çıkışı: cüzdandan cüzdana transfer, IBAN transferi, banka çekimi, ödeme, fatura ödemesi, nakit çekim, kart harcaması, toplu ödeme.
• Para girişi: kartla yükleme, havale ile yükleme, temsilci yüklemesi, iade kredisi.

Yükleme yaptığınız tutar harcama sayacından düşmez; aynı tutar iki kez sayılmaz.

Örnek: şemanızda * satırı aylık 500.000 ve W2W_TRANSFER satırı aylık 300.000 taşıyorsa, kullanıcı cüzdandan cüzdana en fazla 300.000 gönderebilir ve tüm para çıkışlarının toplamı 500.000'i geçemez. Cüzdandan cüzdana 300.000 gönderen kullanıcı aynı ay içinde ödeme için en fazla 200.000 kullanabilir.

Limit şeması

Bir limit şeması, KYC seviyesi × operasyon tipi × para birimi kesişiminde tavanları tanımlar. Şemalar programa ve kullanıcıya atanır.

Bir katman (tier) şu alanları taşır:

currency ile amountCurrency aynı şey değildir

Şema yönetimi merchant panelden yapılır: Panel — Limit & Ücret Şemaları.

Kullanıcının limit durumunu okuma

GET /api/v1/wallet/end-users/{endUserId}/limits

Sorguyu operationType ve currency ile daraltabilirsiniz. Yanıttaki her satır bucket alanıyla hangi sayacı gösterdiğini belirtir:

operationType verdiğinizde o tipi bağlayan tüm sayaçlar döner: tipe özel satır ve varsa cüzdan toplamı. İşlemin geçebilmesi için hepsinde yer olmalıdır.

Son kullanıcı tarafında aynı bilgi:

GET /api/portal/v1/wallet/me/limits

Rezervasyon ve işlem ömrü

Limit sayacı işlem başlarken rezerve edilir, işlem tamamlandığında kesinleşir:

quote        → kontrol (rezervasyon yok)
execute      → rezervasyon (sayaç düşer)
complete     → kesinleşme
fail/expire  → rezervasyon çözülür (sayaç geri gelir)

Rezervasyon, işlem sonuçlanana kadar tutulur:

• Rezervasyonun süresi işlemin olağan ömründen türetilir (onay penceresi, banka çekiminin mutabakat süresi, nakit kodunun geçerlilik süresi, kart otorizasyonunun bekleme süresi gibi).
• Bu süre dolduğunda işlem hâlâ açıksa (örneğin fraud incelemesinde bekliyor ya da banka sonucu henüz gelmediyse) rezervasyon çözülmez, süresi uzatılır.
• İşlem başarısız ya da iptal ile sonuçlandığında rezervasyon çözülür ve sayaç geri gelir.

Kesinleşen ve süren harcamalar kalıcı olarak kaydedilir. Sayaç hizmeti yeniden başlasa bile kullanıcının o gün ve o ay kullandığı limit sıfırlanmaz; kesinleşmiş bir harcama sayaçtan düşmez.

Kanal-üstü ortak tavan

Şema satırlarına ek olarak, program bazında seçili çıkış kanallarının paylaştığı bir üst tavan tanımlanabilir. Bu tavan açıkken IBAN transferi, banka çekimi, nakit çekim ve kart otorizasyonu aynı günlük/aylık havuzu tüketir; şema satırlarının sayaçları alt-limit olarak yürürlükte kalır.

Fail-closed davranış

Limit servisi cevap veremezse ne olacağı operasyona göre belirlenmiştir:

Kimliği doğrulanmamış bakiye tavanı

NONE seviyesindeki bir TRY hesabının bakiyesi 5.000 TL'yi aşamaz. Tavan, işlem sayaçlarından ayrı bir kontroldür: kart yüklemesi, temsilci yüklemesi ve gelen cüzdan transferi, hesabın güncel bakiyesi ile işlem tutarının toplamı tavanı aşacaksa para hareketi başlamadan WALLET_KYC_BALANCE_CAP_EXCEEDED ile reddedilir. LOW ve üstü seviyelerde bakiye tavanı yoktur; işlem tavanları limit şemasından gelir.

Bakiye tavanı yalnız açık devre programlarda uygulanır. Kapalı devre programlarda bakiye tavanı yoktur; kimliği doğrulanmamış kullanıcının işlem tavanlarını limit şemasıyla belirlersiniz.

Limit reddini kullanıcıya anlatma

Quote yanıtındaki limitBlocked: true size reddi önceden söyler. Kullanıcıya:

• hangi sayacın dolduğunu (günlük mü aylık mı, tutar mı adet mi),
• ne zaman yenileneceğini,
• daha yüksek KYC seviyesiyle tavanın artıp artmayacağını

gösterin. Bkz. KYC Seviyeleri.

Yaygın hatalar