Portal SDK

Müşterinin kendi aboneliğini, faturalarını ve kartlarını yönettiği yüzeydir. Dört modun hepsini destekleyen tek SDK budur.

<script src="https://cdn.lunixi.com/lunixi-loader.min.js"></script>

Mode 0 — Anonim katalog

Fiyatlandırma sayfası için. Oturum yok, müşteri kimliği yok; yalnız merchant'ın aktif kataloğunu okur.

const catalog = Lunixi.portal.catalog({
  publishableKey: 'mk_live_pk_...',
});
 
await catalog.plans();      // aktif planlar
await catalog.products();   // aktif ürünler
await catalog.branding();   // logo, renkler, sözleşme bağlantıları

Uçlar: GET /api/public/v1/subscription/{plans,products,branding}

Anahtar sayfa kaynağında görünür ve bu beklenen durumdur. Koruma Origin eşleşmesinden gelir — tarayıcının koyduğu Origin, o anahtar için kayıtlı izinli listede tam eşleşmezse 401 alırsınız. → Genel Bakış

locale verirseniz katalog o dilde döner.

Mode 2 — Oturumlu istemci

Müşteri kendini doğruladıktan sonra kendi verisine erişir. Oturum OTP ile açılır.

const client = Lunixi.portal.create({ /* … */ });
await client.init();
 
await client.requestOtp();
await client.verifyOtp(otpCode, otpChallengeId);
 
const me = await client.me();

Oturum X-Portal-Session başlığında taşınır.

Okuma	Yazma
`me()`	`startSubscription(payload)`
`plans(params)`	`changePlan(payload)`
`subscriptions()`	`cancelSubscription(payload)`
`invoices(params)`	`addCard(payload)`
`cards()`	`updateCard(payload)`

isAuthenticated() oturumun açık olup olmadığını, getSessionState() durumunu döner. logout() oturumu kapatır.

Mode 1 — Hazır portal

Tüm portalı tek çağrıyla çizer:

await Lunixi.portal.mount('#portal', { /* … */ });

Mode 3 — Parça parça monte etme

Ekranın tamamını değil, tek bir bileşeni istiyorsanız:

Lunixi.portal.plans.mount('#plan-picker', { /* … */ });
Lunixi.portal.cardForm.mount('#card-form', { /* … */ });

Kendi sayfa düzeninizi korursunuz, yalnız zor parçaları bize bırakırsınız.

Hangi modu seçmeli

İhtiyaç	Mod
Pazarlama sitesinde fiyat tablosu	Mode 0 — oturum gerekmez
Hızlıca çalışan bir müşteri portalı	Mode 1
Tamamen kendi tasarımınız	Mode 2
Kendi sayfanız + hazır plan seçici / kart formu	Mode 3

Modlar arasında geçiş yaparken uçlar ve oturum modeli değişmez. Mode 1 ile çıkıp sonra Mode 2'ye geçmek, arka uç entegrasyonunu yeniden yazmayı gerektirmez.

İlgili

Web SDK Genel Bakış — loader, modlar, kimlik doğrulama modelleri
Abonelik Fiyatlandırma SDK'sı — fiyatlandırma bileşeni ayrıntısı

KYC SDK Marketplace SDK