Panel — Son Kullanıcılar

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:enduser:read · wallet:enduser:manage · wallet:enduser:kyc-override · wallet:enduser:kyc-approveDört-göz: isteği yapan ile onaylayan aynı kişi olamaz — rol kapısıyla değil, kimlik karşılaştırmasıyla zorlanır.
Çapraz yüzey: KISMEN var: son kullanıcı ve kurumsal hesap uçlarının 12'si s2s API'de de vardır (GET/POST end-users, GET end-users/:id, /balances, /limits, GET /kyc-level, POST end-users/:id/freeze, corporate-accounts …). Panelde kalan 8 uç s2s'te YOKTUR: end-users/:id/close, /unfreeze, /wallets, /kyc-level/history, /kyc-level/override-requests, /merchant-category, GET corporate-accounts/:id, PATCH corporate-accounts/:id.

Müşteri kayıtlarını görüntülediğiniz ve yaşam döngüsünü yönettiğiniz bölüm.

Arama ve detay

GET end-users                   # programId, accountType, status ile filtre; cursor sayfalama
GET end-users/:id               # müşteri detayı
GET end-users/:id/wallets       # cüzdanları
GET end-users/:id/balances      # bakiyeleri
GET end-users/:id/limits        # limit durumu
GET end-users/:id/deposit-instructions

Listede PII maskelidir. Destek görüşmesinde müşteriyi doğrularken maskeli değeri kullanın; tam numarayı ekranda göstermek gerekmez.

Dondurma, çözme, kapatma

POST end-users/:id/freeze       # { reason }
POST end-users/:id/unfreeze     # { reason }
POST end-users/:id/close        # { reason }

İşlem	Etkisi
Dondur	Kullanıcı işlem yapamaz; bakiye durur, geri alınabilir
Çöz	Dondurmayı kaldırır
Kapat	Hesabı sonlandırır — geri alınamaz

⚠️

Kapatmadan önce bakiyeyi ve açık operasyonları kontrol edin. Bakiyesi olan ya da BANK_PROCESSING / AWAITING_RECON durumunda işlemi bulunan bir hesabı kapatmak, o paranın sahibini belirsizleştirir.

reason alanı denetim kaydına yazılır. "test", "gerek yok" gibi değerler yerine gerçek gerekçeyi yazın — bu kayıt bir denetimde veya müşteri şikâyetinde tek dayanağınızdır.

KYC seviyesi

GET  end-users/:id/kyc-level
GET  end-users/:id/kyc-level/history
POST end-users/:id/kyc-level/override-requests   # { kycLevel, sourceRef, reason, effectiveAt?, expectedCurrentLevel? }

Panelden seviye değişikliği bir dört-göz talebidir: talebi wallet:enduser:kyc-override izniyle açarsınız, değişiklik wallet:enduser:kyc-approve iznine sahip başka bir yetkili talebi onayladığında uygulanır. Talebi açan, oturumunuzdan alınır; kendi talebinizi onaylayamazsınız. Onay akışı: Dört-göz talepleri.

sourceRef (kararın dayanağı) ve gerekçe zorunludur. Yükseltmede kanıt onay anında doğrulanır; expectedCurrentLevel verirseniz, seviye o arada değişmişse onay reddedilir. Geçmiş ucu, seviyenin ne zaman, kim tarafından ve hangi dayanakla değiştiğini gösterir.

⚠️

Seviye yükseltmek için sourceRef alanına bu son kullanıcıya ait, onaylı bir KYC oturumunun kimliğini girmeniz gerekir. Seviye, oturumun teyit ettiği seviyeyi aşamaz; dört-göz onayı bu şartın yerini tutmaz. Seviye düşürmek için karar kaydının referansı yeterlidir.

Ayrıntı: KYC Seviyeleri.

Kripto bakiyeleri

GET crypto/balances?swapAccountId=<id>

İzin: wallet:enduser:read

Bir swap cüzdan hesabının kripto varlık bakiyelerinin yönetici görünümüdür.

Panelde yalnız okuma vardır. Kotasyon, swap yürütme ve transfer panelde yoktur — bunlar müşteri para hareketidir ve portal yüzeyinden yapılır. Yapılan swap işlemleri normal operasyon listesinde zaten görünür.

Kurumsal hesaplar ve çalışan kadrosu

POST  corporate-accounts
GET   corporate-accounts
GET   corporate-accounts/:id
PATCH corporate-accounts/:id
POST  corporate-accounts/:id/employees/import
POST  corporate-accounts/:id/employees/offboard
GET   end-users?corporateAccountId=<id>          # kadro listesi

Kurumsal hesap yönetimi bu bölümün izinleriyle (wallet:enduser:*) yapılır; ayrı bir izin ailesi yoktur.

⚠️

Toplu içe aktarma hepsi-ya-da-hiçbiridir ve çalışan ayırma paraya dokunmaz — çalışanın bakiyesi kendisinde kalır. İkisinin de tam davranışı: Kurumsal Hesaplar & Çalışan Yönetimi.

Harcama kısıtı

PUT end-users/:id/merchant-category

Bir işyerine kategori atar; kategori temelli harcama kuralları bu alana bakar. Kural motorunun tamamı: Harcama Kısıtı.

Destek senaryoları

Senaryo	Nereye bakılır
"Param gelmedi"	Operasyonlar → operasyon durumu; `AWAITING_RECON` ise bekleniyor
"Transferim reddedildi"	Kullanıcının limit durumu ve KYC seviyesi
"Hesabıma giremiyorum"	Kullanıcı durumu (dondurulmuş mu), oturum/cihaz kayıtları
"Bakiyem eksik"	Operasyon listesi + ücret alanları (`feeTotal`, `taxTotal`)
"Şüpheli işlem"	Operasyon detayı → `fraudDecision`; gerekirse dondurma

Dikkat edilecekler

Konu	Neden önemli
Dondurma geri alınabilir, kapatma alınamaz	Şüphede önce dondurun
Bakiyeli hesabı kapatmayın	Paranın sahibi belirsizleşir
`reason` gerçek olsun	Denetim ve şikâyette tek dayanak
Seviye = yetki	Yükseltmek anında etki eder

Programlar Operasyonlar & Müdahale