Panel — Genel Bakış & Yetkiler

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: Her uç bir RBAC izin koduna bağlıdır; kodlar aşağıdaki bölümlerde uç uç verilir.Dö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: 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.

Merchant panel, cüzdan programınızı işlettiğiniz yerdir: program ayarları, müşteri yönetimi, operasyon müdahalesi, limit ve ücret şemaları, kampanyalar, toplu ödeme, terminaller ve raporlar.

Panel yüzeyi /api/panel/v1/wallet/* altındadır ve panel oturumuyla (JWT) çalışır. Sunucudan sunucuya entegrasyon için dış API, son kullanıcı uygulaması için portal kullanılır. Panelin 132 ucunun s2s API'de karşılığı yoktur — ayrıntı: yüzey karşılaştırma matrisi.

İzin kodları

Her panel işlemi bir RBAC izin koduna bağlıdır. Ekipteki rollere bu kodları vererek yetki dağıtırsınız. Cüzdan yüzeyinde bugün 30 izin kodu vardır:

Program & politika

İzin kodu	Ne açar
`wallet:program:read`	Program listesi ve detayı, aktif program, cüzdan sağlayıcı kataloğu
`wallet:program:manage`	Program oluşturma ve düzenleme — marka, para birimleri, onboarding modu, durum
`wallet:sponsor-policy:manage`	Sponsor politikası taslağı, banka entegrasyonları, sağlayıcı geçişleri, entegrasyon kataloğu, merchant cüzdan sağlayıcıları
`wallet:sponsor-policy:approve`	Sponsor politikası sürüm onay/ret, sağlayıcı geçişi tamamlama, QR üretici kodu onay/emeklilik — dört-göz
`wallet:config:manage`	Agent (bayi) tanımları

Son kullanıcı & kurumsal hesap

İzin kodu	Ne açar
`wallet:enduser:read`	Müşteri, kurumsal hesap, cüzdan, bakiye, limit, KYC seviyesi, yükleme talimatı ve kripto bakiyesi okuma
`wallet:enduser:manage`	Müşteri oluşturma, dondurma/çözme/kapatma, kurumsal hesap ve çalışan yönetimi, işyeri kategorisi atama
`wallet:enduser:kyc-override`	KYC seviye değişikliği talep etme — değişiklik başka bir yetkili onaylayınca uygulanır
`wallet:enduser:kyc-approve`	KYC seviye değişikliği talebini onaylama — ayrı bir izindir, `enduser:manage` yetmez; dört-göz
`wallet:legal-hold:manage`	Hukuki askı ekleme, askıları ve saklama durumunu görme, askının kaldırılmasını talep etme — bkz. Veri Saklama ve Hukuki Askı
`wallet:legal-hold:approve`	Askı kaldırma talebini onaylama — talep edenden farklı bir yetkili; dört-göz

Operasyon & müdahale

İzin kodu	Ne açar
`wallet:operation:read`	Operasyon listesi/detayı, dekont, askıda fon, fatura ve fatura ödemesi izleme, `ops-health`
`wallet:operation:intervene`	Manuel operasyon müdahalesi, askıda fon eşleştirme/iadesi, yükleme iadesi, takılan çekim, nakit çekim askısı — müdahale talebi açma ve başkasının talebini onaylama; dört-göz

Limit, ücret & komisyon

İzin kodu	Ne açar
`wallet:limit:manage`	Limit şemaları, programa şema atama, ortak tavanlar, OTP politikası, harcama kısıtı kuralları
`wallet:fee:manage`	Ücret ve komisyon şemaları, sürüm submit/approve zinciri (dört-göz), şube ücretleri, ücret raporu

Kampanya & sadakat

İzin kodu	Ne açar
`wallet:campaign:manage`	Kampanya ve segment yönetimi, sürüm submit ve approve — onay ayrı bir izin değildir, dört-göz kimlik karşılaştırmasıyla uygulanır
`wallet:loyalty:read`	Sadakat programı, kazanma kuralları, seviye şeması, rozetler, puan bakiyesi ve geçmişi okuma
`wallet:loyalty:manage`	Sadakat programı, kazanma kuralı, seviye şeması, rozet ve rozet kuralı yazma

Toplu ödeme

İzin kodu	Ne açar
`wallet:bulk:create`	Toplu ödeme oluşturma, listeleme, kalemler, önizleme, ekstre, sayaçlar, `submit`
`wallet:bulk:approve`	Onay, ret, işleme alma, iptal, başarısızları yeniden deneme — create'ten ayrı kişi, dört-göz

QR & terminal

İzin kodu	Ne açar
`wallet:qr:read`	QR listeleme ve detay
`wallet:qr:manage`	QR üretme ve iptal
`wallet:terminal:read`	Terminal listesi, detayı, olay geçmişi ve terminal raporu
`wallet:terminal:manage`	Terminal oluşturma, aktivasyon kodu üretme, kimlik bilgisi üret/döndür/iptal, askıya alma/sürdürme/emekli etme, toplu işlemler

Kart

İzin kodu	Ne açar
`wallet:card:read`	Kart listesi, detayı ve otorizasyon geçmişi
`wallet:card:operate`	Kart basma, dondurma, çözme, iptal
`wallet:card:authorize`	Issuer olay uçları: otorizasyon, clearing, reversal (`/card-events`)

Nakit çekim

Nakit çekim uçları /api/panel/v1/wallet/cash-out altındadır.

İzin kodu	Ne açar
`wallet:cashout:read`	Nakit çekim talebi detayı
`wallet:cashout:operate`	Nakit çekim kodu üretme ve iptal
`wallet:cashout:dispense`	Nakdin teslim edildiğini onaylama

Fatura & rapor

İzin kodu	Ne açar
`wallet:invoice:manage`	Fatura kesme ve iptal
`wallet:report:read`	Genel bakış, operasyon, kampanya ve custody raporları, kampanya raporu, operasyon dışa aktarımı

⚠️

wallet:campaign:approve ve wallet:card:manage diye izin kodları YOKTUR. Bu iki kod bu sayfada daha önce listeleniyordu ama kodda karşılıkları hiç olmadı; role atansalar bile hiçbir ucu açmazlar. Kampanya onayı wallet:campaign:manage ile yapılır (dört-göz yine de zorunludur), kart işlemleri wallet:card:operate ile.

Dört-göz kuralı

⚠️

Para-kritik işlemlerde isteği yapan ile onaylayan aynı kişi olamaz. Bu kural rol kapısıyla değil, servis katmanında kimlik karşılaştırmasıyla zorlanır: OWNER veya ADMIN rolü her iki izne de sahip olsa bile aynı kullanıcı kendi isteğini onaylayamaz.

Dört-göz zorlaması servis katmanında on bir yerde uygulanır:

İşlem	İlgili izin
Manuel operasyon müdahalesi (takılan operasyon, çekim)	`wallet:operation:intervene`
Askıda fon eşleştirme	`wallet:operation:intervene`
Yükleme iadesi	`wallet:operation:intervene`
Nakit çekim askısını çözme	`wallet:operation:intervene`
Toplu ödeme onayı	`wallet:bulk:approve`
Ücret şeması sürüm onayı	`wallet:fee:manage`
Komisyon şeması sürüm onayı	`wallet:fee:manage`
Kampanya sürüm onayı	`wallet:campaign:manage`
Sponsor politikası sürüm onayı	`wallet:sponsor-policy:approve`
QR üretici kodu onayı	`wallet:sponsor-policy:approve`
KYC seviyesi değişimi	talep `wallet:enduser:kyc-override`, onay `wallet:enduser:kyc-approve`
Hukuki askının kaldırılması	talep `wallet:legal-hold:manage`, onay `wallet:legal-hold:approve`

İlk dört satır, KYC değişikliği ve hukuki askının kaldırılması kalıcı müdahale talebi olarak çalışır: bir operatör talep açar, başka bir yetkili Dört-Göz Onayları ekranında onaylar; talep eden ve onaylayan panel oturumlarından alınır. Ayrıntı: Dört-göz talepleri.

Dikkat: dört-göz her zaman ayrı bir "approve" izniyle eşleşmez. Kampanya ve ücret şemasında hazırlayan ile onaylayan aynı izin koduna sahiptir; kuralı ayakta tutan izin değil, servis katmanındaki kimlik karşılaştırmasıdır. Yine de operasyonel olarak ayrı kişilere ayrı roller vermeniz beklenir.

Step-up doğrulama

Bazı işlemler panel oturumuna ek olarak step-up doğrulaması ister. Bu, oturumu ele geçirilmiş bir operatörün tek başına para hareketi yapmasını engeller.

Sürümleme ve onay zinciri

Ücret, komisyon ve kampanya gibi para davranışını değiştiren yapılandırmalar doğrudan düzenlenmez; sürümlenir:

Aynı zincir ücret şemalarında, limit şemalarında ve sponsor politikasında çalışır. Onaylayan, gönderenden farklı olmak zorundadır — dört-göz kuralı servis katmanında zorlanır, arayüzde değil.

Geçmiş işlemler kendi sürümleriyle izlenebilir kalır. Bir raporda beklenmedik bir ücret gördüğünüzde, operasyondaki scheduleVersionId ile o anda hangi sürümün geçerli olduğunu bulabilirsiniz.

Bölümler

Programlar→Son Kullanıcılar→Operasyonlar & Müdahale→Limit & Ücret Şemaları→Kampanya & Sadakat→Toplu Ödeme→QR & Terminaller→Kartlar→Entegrasyon Merkezi→Raporlar→

Yetki dağıtırken

Maker ve checker'ı ayrı kişilere verin. bulk:create ile bulk:approve ayrı kodlardır — ayrı rollere koyun. Kampanya ve ücret şemasında ayrı kod yoktur; orada ayrımı rol dağıtımıyla değil, aynı kodu iki ayrı kişiye vererek kurarsınız.
operation:intervene dar tutun. Bu izin, askıdaki paraya dokunma yetkisidir; dört-göz'ün ikinci gözü de aynı izindir.
sponsor-policy:manage ve sponsor-policy:approve'ı ayırın. Banka entegrasyonu ve sağlayıcı politikası değişiklikleri tüm para akışını etkiler; config:manage yalnız agent tanımlarını açar.
terminal:manage'i saha ekibinden ayırın. Kimlik bilgisi üretme/döndürme yetkisidir; sahaya terminal:read yeter.
enduser:kyc-override ile enduser:kyc-approve'u ayrı kişilere verin. Biri değişikliği talep eder, diğeri onaylar; enduser:manage ikisini de taşımaz. Aynısı legal-hold:manage ile legal-hold:approve için de geçerlidir.
Salt-okunur roller tanımlayın. Destek ekibinin çoğu işi *:read kodlarıyla görülür (program, enduser, operation, loyalty, qr, terminal, card, cashout, report).

Marka & Tema Programlar