Panel — Entegrasyon Merkezi

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:config:manage · wallet:sponsor-policy:manage
Ç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ın dış dünyaya bağlandığı yer. Hangi sağlayıcıların mevcut olduğunu görür, programınıza bağlar ve geçişleri yönetirsiniz.

Sağlayıcı kataloğu

GET integrations/catalog        # category, deploymentMode, licenceHolder filtresi
GET sponsor-policy/providers

Katalog, kategori bazında kullanılabilir sağlayıcıları listeler:

Kategori	Ne için
E-para	Programın çalıştığı lisans
Banka entegrasyonu	Havale ile yükleme, çekim, IBAN transferi, toplu ödeme
Fatura kurumu	Fatura sorgulama ve ödeme
ATM ağı	Kartsız nakit çekim
Kart ihraççısı	Kart ihracı
Cüzdan sağlayıcısı	Checkout'ta "cüzdanla öde"

Yetenek kapısı nasıl çalışır

⚠️

Bir kategori için bağlı sağlayıcı yoksa o yetenek kapalıdır — istek reddedilir. Sistem "yaklaşık doğru" bir sağlayıcıya ya da bir simülatöre düşmez. Bu bilinçli bir tasarımdır: para yolunda sessiz bir yedeğe düşmek, gerçekte olmayan bir işlemi olmuş gibi göstermekten daha kötüdür.

Yani bir ekranda seçenek görüyor olmanız, o yolun çalıştığı anlamına gelmez; bağlama yapılmış olmalıdır.

Yakında — bağlanacak sağlayıcı bekleyen kategoriler

Banka entegrasyonu, fatura kurumu, ATM ağı ve kart ihraççısı kategorilerinde bağlanacak bir sağlayıcı bulunmamaktadır. Bu kategoriler bağlandığında ilgili yetenekler otomatik olarak açılır — ek geliştirme gerekmez. Durum: Yol Haritası.

Merchant cüzdan sağlayıcıları

GET  merchant-wallet-providers            # onlyAvailable filtresi
POST merchant-wallet-providers            # bağla { providerCode, credentialRef?, displayName? }
PUT  merchant-wallet-providers/:providerCode

Checkout'ta müşterilerinize hangi cüzdanlarla ödeme sunacağınızı belirler. Birden fazla sağlayıcı aynı anda aktif olabilir; seçimi son kullanıcı yapar.

Kendi cüzdanınız da bu listede diğer sağlayıcılarla aynı kuralla yer alır — ayrıcalıklı bir kısa yolu yoktur. Katalog satırı pasifleşirse kendi cüzdanınız da listeden düşer.

Credential yönetimi

Bağlamalarda credential doğrudan girilmez, bir credential referansı ile bağlanır. Böylece secret değerleri panelde ve bağlama kaydında görünmez.

⚠️

Credential rotasyonunda önce yeni referansı bağlayın, trafiği doğrulayın, sonra eskisini kaldırın. Ters sıra kısa bir kesinti üretir.

Sağlayıcı geçişi

GET  programs/:id/provider-switches
POST programs/:id/provider-switches
GET  programs/:id/provider-switches/:switchId/readiness
POST programs/:id/provider-switches/:switchId/drained
POST programs/:id/provider-switches/:switchId/abort

⚠️

Bir sağlayıcıdan diğerine geçmek için sağlayıcı alanını düz düzenleme ile değiştiremezsiniz. Açık bir geçiş kaydı gerekir: geçiş açılır → eski sağlayıcıdaki açık işlemler boşaltılır → geçiş tamamlanır. Bu, "yarısı eski yarısı yeni sağlayıcıda kalan işlemler" durumunu engeller.

readiness ucu hangi aşamada olduğunuzu ve neyin beklendiğini gösterir; yanlış giderse abort ile geri alınır.

Kontrol listesi

Programın sponsor politikasında beyan edilen her sağlayıcı gerçekten bağlı
Politika validate ile doğrulandı
Credential referansları güncel
Geçişler açık geçiş kaydıyla yapılıyor
Kapalı yetenekler ürün arayüzünde kullanıcıya sunulmuyor

Kartlar Raporlar