Veri Saklama ve Hukuki Askı

Bu uçları kim çağırır?Merchant panel

Taban yol: /api/panel/v1/wallet
Kimlik: Panel oturumu (JWT) — Authorization: Bearer <panel access token>. Token panel girişinden gelir; s2s imza anahtarı bu uçları AÇMAZ.
Yetki: RBAC izin kodu: wallet:legal-hold:manage · wallet:legal-hold:approve
Çapraz yüzey: Bu sayfadaki uçların s2s API'de karşılığı YOKTUR; kendi panelinizden çağıramazsınız. Bu yetenekler yalnız merchant panelde, panel oturumuyla kullanılabilir.

Cüzdan kayıtları, kayıt sınıfına göre belirli bir süre saklanır. Süre dolduğunda kayıt periyodik imha işiyle silinir ya da anonimleştirilir. Hukuki askı altındaki kayıtlar süre dolsa da imha edilmez.

Saklama süreleri

Kayıt sınıfı	Süre	Süre sonunda
Para işlemleri, son kullanıcı ve alıcı kayıtları	8 yıl	Kişisel alanlar anonimleştirilir; yardımcı kayıtlar silinir
Doğrulama kodu (OTP) kayıtları	90 gün	Silinir
Webhook ve bildirim teslim kayıtları	1 yıl	Silinir
Kişisel veri içermeyen yapılandırma (program, ücret, limit, kampanya tanımları vb.)	—	İmha edilmez

Güncel süreleri ve tablo bazında kararı panelde Cüzdan → Veri Saklama ve Hukuki Askı ekranında görebilirsiniz.

Sürenin başlangıcı

Kayıt	Süre şu andan itibaren işler
Para işlemi	İşlemin son durumuna (tamamlandı, başarısız, geri alındı, süresi doldu) geçtiği an
Son kullanıcı	Hesabın kapatılması ile son işlemin (gönderen ya da alıcı olarak) tarihinden geç olanı
OTP kaydı	Kodun son kullanım ya da son geçerlilik anı
Webhook / bildirim	Teslim anı; teslim edilemeyen kalıcı hatalarda son deneme anı

Son durumuna ulaşmamış işlem, açık hesabı olan son kullanıcı ve henüz teslim edilmemiş bildirim imha edilmez.

Anonimleştirmede ne kalır

Para işlemi ve son kullanıcı kayıtları muhasebe tutarlılığı için silinmez; yalnız kişisel alanlar geri döndürülemez biçimde ezilir.

Kalır	Ezilir
Tutar, ücret, para birimi, durum, tarih	Alıcı adı ve hesap referansı (IBAN, cüzdan numarası maskesi)
İşlem, cüzdan ve hesap kimlikleri	Gönderen adı ve maskesi
Sipariş / ödeme referansınız	Telefon numarası hash'i ve maskesi, görünen ad
İşlem geçmişi (durum geçişleri)	`externalCustomerId`, kimlik bağı, kart jetonu ve son dört hanesi

Anonimleştirilmiş bir işlemi API ile sorguladığınızda tutar ve durum alanları değişmeden döner; alıcı ve gönderen alanları boş gelir. Son kullanıcının kayıtlı kişileri ve hedef kitle üyelikleri silinir.

Hukuki askı

Hukuki askı, kapsadığı kayıtların imhasını askı kaldırılana kadar durdurur. Askı üç kapsamda eklenebilir:

Kapsam	Kapsadığı kayıtlar
`TENANT`	Kuruluşunuzun bütün cüzdan kayıtları
`END_USER`	Bir son kullanıcının kayıtları (ve işlemlerinde taraf olduğu kayıtlar)
`OPERATION`	Tek bir işlem, ona bağlı kayıtlar ve taraflarının kimlik bilgileri

Ekleme anında etkilidir ve wallet:legal-hold:manage izni gerektirir. Ekleyen kişi, gerekçe ve resmî yazı numarası kayda geçer.
Kaldırma dört-gözdür: bir yetkili talep oluşturur (wallet:legal-hold:manage), farklı bir yetkili onaylar (wallet:legal-hold:approve). Kendi talebinizi onaylayamazsınız.
Askı kayıtları silinmez; kaldırılan askı, kimin talep ettiği ve kimin onayladığıyla birlikte listede kalır.

GET  retention/status                        # süreler, tablo bazında karar, iş durumu
GET  legal-holds?activeOnly=true             # askıları listele
POST legal-holds                             # askı ekle (anında etkili)
POST legal-holds/:id/release-requests        # kaldırma talebi (dört-göz)
POST intervention-requests/:id/approve       # talebi onayla (farklı yetkili)
POST intervention-requests/:id/reject        # talebi reddet

POST legal-holds gövdesi:

{
  "scope": "END_USER",
  "targetId": "8c1f0f7e-3b9a-4c62-9d1e-2b6a0a6f4c11",
  "reason": "Resmî yazı gereği kayıtların korunması",
  "reference": "2026/1234"
}

TENANT kapsamında targetId gönderilmez. Aynı hedefte aktif bir askı varken ikinci askı 409 WALLET_LEGAL_HOLD_CONFLICT döner.

İmha işi

İmha işi her gün çalışır. Panelde işin durumunu görebilirsiniz:

Durum	Anlamı
Kapalı	İş çalışmıyor; hiçbir kayıt silinmez ya da anonimleştirilmez
Sayım kipi	İş süresi dolan kayıtları yalnız sayar; hiçbir kayıt değiştirilmez
Etkin	Süresi dolan ve askıda olmayan kayıtlar silinir ya da anonimleştirilir

Hata Yönetimi Test Etme