Portal — Marka & Tema

Bu uçları kim çağırır?Dış API (s2s)

Taban yol: /api/v1/wallet/programs/me
Kimlik: Ed25519 istek imzası — X-Key-Id, X-Date, X-Nonce, Digest (body varsa), X-Signature. Zaman penceresi ±5 dk, nonce tek kullanımlık, anahtarda IP allow-list olabilir.
Yetki: Anahtarınız cüzdan ürününü ve çağrının gerektirdiği cüzdan iznini taşımalıdır; izni olmayan çağrı 403 WALLET_INSUFFICIENT_SCOPE alır. Uç başına izinler: Anahtar izinleri.
Çapraz yüzey: Marka alanları s2s'ten yalnız OKUNUR. Yazma panele özeldir: PATCH /api/panel/v1/wallet/programs/:id, izin wallet:program:manage. İmza anahtarıyla marka değiştiremezsiniz.

Cüzdan white-label çalışır: kullanıcı sizin markanızı görür. Marka bilgileri program üzerinde tanımlanır ve hem uygulamanız hem de platformun ürettiği belgeler (dekont, bildirim) tarafından kullanılır.

Marka alanları

Alan	Açıklama
`displayName`	Kullanıcıya gösterilen program adı
`logoUrl`	Logo adresi
`primaryColor`	Birincil renk
`secondaryColor`	İkincil renk
`supportEmail`	Destek e-postası
`supportPhone`	Destek telefonu
`receiptFooterNote`	Dekont altına basılacak not

Program ve marka bilgileri merchant panelden düzenlenir: Panel — Programlar.

Programı okuma

Uygulamanız, açılışta programın marka bilgisini okuyup arayüzünü buna göre kurabilir:

GET /api/v1/wallet/programs/me      # s2s

Marka değerlerini uygulamanıza sabit kodlamayın. Panelden değiştirildiğinde uygulamanızın da değişmesini istiyorsanız programı okuyup önbelleğe alın; aksi hâlde her marka değişikliği yeni bir uygulama sürümü gerektirir.

Tutarlılık kuralları

Marka üç yerde görünür ve üçünün de aynı olması gerekir:

Yer	Kaynağı
Uygulamanızın arayüzü	Sizin tasarımınız + program marka alanları
Dekontlar	Program marka alanları (`displayName`, `logoUrl`, `receiptFooterNote`)
Bildirimler (OTP, işlem)	Program marka alanları

⚠️

supportEmail ve supportPhone alanlarını doldurun. Bunlar dekont ve bildirimlerde kullanıcıya gösterilir; boş bırakılırsa kullanıcı sorun yaşadığında size ulaşacak bir kanal bulamaz ve ödeme sağlayıcısına ya da bankasına başvurur.

Dekont notu

receiptFooterNote, dekontun altına basılan serbest metindir. Tipik kullanım: yasal uyarı, iade politikası özeti veya destek kanalı.

Dekont notunu kısa tutun. Uzun metin dekontun okunabilirliğini bozar; ayrıntı için uygulamanızdaki bir sayfaya yönlendirin.

Çoklu program

Birden fazla programınız varsa (ör. "Çalışan Cüzdanı" ve "Müşteri Cüzdanı") her programın kendi markası olabilir. Uygulamanız oturumun hangi programa ait olduğunu bilir ve o programın markasını uygular.

⚠️

Kullanıcı iki programda birden yer alabilir. Arayüzünüzde hangi programda olduğunu net gösterin — aksi hâlde kullanıcı bakiyesini karıştırır ve "param kayboldu" şikâyeti gelir.

Yaygın hatalar

Durum	Sebep	Çözüm
Marka değişti, uygulama eski görünüyor	Değerler sabit kodlanmış	Programı okuyup önbelleğe alın
Dekontta destek bilgisi yok	Alanlar boş	`supportEmail` / `supportPhone` doldurun
Kullanıcı yanlış bakiyeye bakıyor	Çoklu program ayrımı gösterilmiyor	Aktif programı arayüzde belirtin

Hesap & İşlemler Genel Bakış & Yetkiler